Как я могу устранить неполадки с аннотациями в JPA?

Question

Аннотации JPA-соединения необходимы для использования JPA, но мне сложно найти хорошую, всестороннюю документацию о них.

Мой типичный опыт - я думаю, что что-то работает, а затем через 3 дня я замечаю сценарий, вызывающий проблему, и трачу часы / дни, выясняя, что мне нужно удалить / добавить параметр / аннотацию к одному измои сущности.

Кто-нибудь знает большое, всеобъемлющее руководство по аннотациям JPA о присоединении?Мне надоело чувствовать, что JPA - это чёрная магия.

Answer 1

Существует два официальных ресурса:

1. JPA JavaDoc: http://download.oracle.com/javaee/5/api/index.html?javax/persistence/package-summary.html. Посмотрите в разделе «Сводка типов аннотаций». В нем перечислены все аннотации, которые являются частью JPA API, а также некоторые описания.

2. Документация JPA JSR. http://jcp.org/aboutJava/communityprocess/final/jsr220/. Это официальная спецификация для JPA. Чтение может быть скучным, но это лучший официальный ресурс для него. Я считаю, что каждый программист должен читать JSR, особенно JPA, когда это является частью их повседневной работы.

Но мне также нравится смотреть на набор тестов Hibernate. Хотя это и не «официальная документация JPA», она предоставляет большой набор вариантов использования, которые почти всегда соответствуют нашим обычным сценариям использования. Я бы сказал, что если вы знакомы с Javadoc, JSR и можете легко брать ссылки из набора тестов Hibernate, вы готовы работать с крайними случаями.

Answer 2

Я обычно заглядываю в официальные документы. Я считаю типы аннотаций sumary очень полезными.

Существует также довольно приличное руководство по JPA здесь . Я никогда не нуждался ни в каком другом.