Изучаем Java EE 7

··public void calculateAge() {

····if (dateOfBirth == null) {

······age = null;

······return;

····}

····Calendar birth = new GregorianCalendar();

····birth.setTime(dateOfBirth);

····Calendar now = new GregorianCalendar();

····now.setTime(new Date());

····int adjust = 0;

····if (now.get(DAY_OF_YEAR) — birth.get(DAY_OF_YEAR) < 0) {

······adjust = -1;

····}

····age = now.get(YEAR) — birth.get(YEAR) + adjust;

··}

··// Конструкторы, геттеры, сеттеры

}

В листинге 6.38 сущность Customer включает метод для валидации ее данных (он проверяет атрибуты firstName и lastName). Этот метод аннотирован с использованием @PrePersist и @PreUpdate и будет вызываться до вставки данных или обновления информации в базе данных. Если данные не смогут успешно пройти валидацию, то будет сгенерировано исключение времени выполнения, а вставка или обновление будут подвергнуты откату для гарантии того, что данные, вставленные или обновленные в базе данных, окажутся валидными.

Метод calculateAge() вычисляет возраст клиента. Атрибут age временный и не отображается в базе данных. После загрузки сущности, обеспечения ее постоянства или обновления метод calculateAge() принимает значение даты рождения клиента, вычисляет его возраст и задает значение для соответствующего атрибута.

Приведенные далее правила применяются к методам обратного вызова жизненного цикла.

• Методы могут иметь доступ public, private, protected или доступ на уровне пакета, однако не должны быть static или final. Обратите внимание в листинге 6.38 на то, что метод validate() является private.

• Метод может быть снабжен множественными аннотациями событий жизненного цикла (метод validateData() аннотирован с использованием @PrePersist и @PreUpdate). Однако для класса-сущности может присутствовать только одна аннотация жизненного цикла определенного типа (например, для одной и той же сущности не может быть две аннотации @PrePersist).

• Метод может генерировать непроверяемые исключения (времени выполнения), но не может — проверяемые. Генерирование исключения времени выполнения приведет к откату транзакции при наличии таковой.

• Метод может вызывать JNDI, JDBC, JMS и EJB-компоненты, но не может осуществлять какие-либо операции EntityManager и Query.

• При наследовании, если метод указан в суперклассе, он будет вызываться раньше соответствующего метода в дочернем классе. Например, если бы в листинге 6.38 сущность Customer наследовала от сущности Person, то метод Person с аннотацией @PrePersist вызывался бы раньше метода Customer с аннотацией @PrePersist.

• Если при работе со связями используется каскадирование событий, то метод обратного вызова тоже будет вызываться каскадным образом. Допустим, сущность обладает коллекцией адресов, а в случае со связью задано каскадное удаление. При удалении Customer произошел бы вызов метода Address с аннотацией @PreRemove, а также метода Customer с аннотацией @PreRemove.

Слушатели

Методы обратного вызова, которыми располагает сущность, хорошо работают при наличии бизнес-логики, связанной только с этой сущностью. Слушатели сущностей применяются для извлечения бизнес-логики в отдельный класс и обеспечения ее совместного использования другими сущностями. Слушатель сущности — это простой Java-объект, в случае с которым вам требуется определить один или несколько методов обратного вызова жизненного цикла. Для регистрации слушателя сущности необходимо задействовать аннотацию @EntityListeners.

Используя пример Customer, извлечем методы calculateAge() и validate() в отдельные классы-слушатели: соответственно AgeCalculationListener (листинг 6.39) и DataValidationListener (листинг 6.40).

Листинг 6.39. Слушатель, используемый для вычисления значения age сущности Customer

public class AgeCalculationListener {

··@PostLoad

··@PostPersist

··@PostUpdate

··public void calculateAge(Customer customer) {

····if (customer.getDateOfBirth() == null) {

······customer.setAge(null);

······return;

····}

····Calendar birth = new GregorianCalendar();

····birth.setTime(customer.getDateOfBirth());

····Calendar now = new GregorianCalendar();

····now.setTime(new Date());