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

@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface OneToOne {
··Class targetEntity() default void.class;
··CascadeType[] cascade() default {};
··FetchType fetch() default EAGER;
··boolean optional() default true;
··String mappedBy() default "";
··boolean orphanRemoval() default false;
}

Второй аннотацией является @JoinColumn (ее API-интерфейс очень схож с API-интерфейсом аннотации @Column из листинга 5.12). Она используется для настройки столбца соединения, то есть внешнего ключа владеющей стороны. В листинге 5.40 показано, как вы применили бы две эти аннотации.

Листинг 5.40. Сущность Customer с настроенным отображением связей

@Entity
public class Customer {
··@Id @GeneratedValue
··private Long id;
··private String firstName;
··private String lastName;
··private String email;
··private String phoneNumber;
··@OneToOne (fetch = FetchType.LAZY)
··@JoinColumn(name = "add_fk", nullable = false)
··private Address address;
··// Конструкторы, геттеры, сеттеры
}

В JPA внешний ключ называется столбцом соединения. Аннотация @JoinColumn позволяет вам настраивать отображение внешнего ключа. В листинге 5.40 она используется для переименования столбца внешнего ключа в ADD_FK, а также для того, чтобы сделать связь обязательной, отклонив значение null (nullable=false). Аннотация @OneToOne подсказывает поставщику постоянства о том, что выборка связи должна быть отложенной (подробнее об этом мы поговорим позднее).

Однонаправленная связь с использованием @OneToMany

Связь «один ко многим» наблюдается, когда один объект-источник ссылается на множество объектов-целей. Например, заказ на покупку включает несколько строк заказа (рис. 5.15). Строка заказа могла бы ссылаться на заказ на покупку с использованием аннотации @ManyToOne, однако это не тот случай, поскольку связь является однонаправленной. Order — это сторона «одного» и источник связи, а OrderLine — сторона «многих» и цель.

Рис. 5.15. Один заказ включает несколько строк

Отношения являются множественными, а навигация осуществляется только от Order по направлению к OrderLine. В Java эта множественность характеризуется интерфейсами Collection, List и Set из пакета java.util. В листинге 5.41 приведен код сущности Order с однонаправленной связью «один ко многим» относительно OrderLine (листинг 5.42).

Листинг 5.41. Order содержит orderLines

@Entity
public class Order {
··@Id @GeneratedValue
··private Long id;
··@Temporal(TemporalType.TIMESTAMP)
··private Date creationDate;
··private List orderLines;
··// Конструкторы, геттеры, сеттеры
}

Листинг 5.42. OrderLine

@Entity
@Table(name = "order_line")
public class OrderLine {
··@Id @GeneratedValue
··private Long id;
··private String item;
··private Double unitPrice;
··private Integer quantity;
··// Конструкторы, геттеры, сеттеры
}

Order из листинга 5.41 не имеет каких-либо специальных аннотаций и опирается на парадигму «конфигурация в порядке исключения». Тот факт, что коллекция типа сущности используется как атрибут для этой сущности, по умолчанию инициирует отображение связи «один ко многим». Изначально однонаправленные связи «один ко многим» задействуют таблицу соединения с двумя столбцами внешнего ключа для сохранения информации о связях. Один столбец внешнего ключа будет ссылаться на таблицу ORDER и иметь тот же тип, что и ее первичный ключ, а другой будет ссылаться на таблицу ORDER_LINE. Имя этой таблицы соединения будет состоять из имен обеих сущностей, разделенных символом «_». Таблица соединения получит имя ORDER_ORDER_LINE, а в результате у нас будет схематическая структура, показанная на рис. 5.16.

Рис. 5.16. Таблица соединения между ORDER и ORDER_LINE

Если вам не нравятся имена таблицы соединения и внешнего ключа либо если вы выполняете отображение в уже существующую таблицу, то можете воспользоваться аннотациями JPA для переопределения этих применяемых по умолчанию имен. Именем по умолчанию для столбца соединения является конкатенация имени сущности, символа «_» и имени первичного ключа, на который происходит ссылка. В то время как аннотация @JoinColumn может быть использована для изменения столбцов внешнего ключа, аннотация @JoinTable (листинг 5.43) позволяет сделать то же самое, если речь идет об отображении таблицы соединения. Вы также можете воспользоваться аннотацией @OneToMany (листинг 5.44), которая, как и @OneToOne, дает возможность настраивать саму связь (применение режима fetch и т. д.).

Листинг 5.43. API-интерфейс аннотации @JoinTable

@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface JoinTable {
··String name() default "";
··String catalog() default "";
··String schema() default "";
··JoinColumn[] joinColumns() default {};
··JoinColumn[] inverseJoinColumns() default {};
··UniqueConstraint[] uniqueConstraints() default {};
··Index[] indexes() default {};
}

Листинг 5.44. Сущность Order с аннотированной связью «один ко многим»

@Entity
public class Order {
··@Id @GeneratedValue
··private Long id;
··@Temporal(TemporalType.TIMESTAMP)
··private Date creationDate;
··@OneToMany
··@JoinTable(name = "jnd_ord_line",
····joinColumns = @JoinColumn(name = "order_fk"),