Изучаем Java EE 7 - [106]

······throw new IllegalArgumentException("Неверное имя");
····if (lastName == null || "".equals(lastName))
······throw new IllegalArgumentException("Неверная фамилия");
··}

··@PostLoad
··@PostPersist
··@PostUpdate
··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());
····int adjust = 0; if (now.get(DAY_OF_YEAR) — birth.get(DAY_OF_YEAR) < 0) {
······adjust = -1;
····}
····customer.setAge(now.get(YEAR) — birth.get(YEAR) + adjust);
··}
}

Листинг 6.40. Слушатель, используемый для валидации атрибутов сущности Customer

public class DataValidationListener {
··@PrePersist
··@PreUpdate
··private void validate(Customer customer) {
····if (customer.getFirstName() == null || "".equals(customer.getFirstName()))
······throw new IllegalArgumentException("Неверное имя");
····if (customer.getLastName() == null || "".equals(customer.getLastName()))
······throw new IllegalArgumentException("Неверная фамилия");
··}
}

К классу-слушателю применяются только простые правила. Первое правило состоит в том, что класс должен располагать конструктором public без аргументов. Второе правило заключается в том, что подписи методов обратного вызова немного отличаются от тех, что приведены в листинге 6.38. Когда вы вызываете метод обратного вызова в слушателе, этому методу необходимо иметь доступ к состоянию сущности (например, к firstName и lastName сущности Customer, которые необходимо подвергнуть валидации). Методы должны располагать параметром, имеющим тип, который совместим с типом сущности, поскольку сущность, связанная с соответствующим событием, передается в обратный вызов. Метод обратного вызова, определенный в сущности, будет иметь такую подпись без параметров: