Spec-Zone .ru спецификации, руководства, описания, API

javax.persistence
Тип аннотации JoinColumn

@Target(value={METHOD,FIELD})
@Retention(value=RUNTIME)
public @interface JoinColumn

Определяет столбец для того, чтобы присоединиться к ассоциации объекта или набору элемента. Если JoinColumn сама аннотация принимается значение по умолчанию, единственный объединяющий столбец принимается, и значения по умолчанию применяются.

   Example:

   @ManyToOne
   @JoinColumn(name="ADDR_ID")
   public Address getAddress() { return address; }


   Example: unidirectional one-to-many association using a foreign key mapping
 
   // In Customer class
   @OneToMany
   @JoinColumn(name="CUST_ID") // join column is in table for Order
   public Set<Order> getOrders() {return orders;}
 

С тех пор:

Персистентность Java 1.0

См. Также:

ManyToOne, OneToMany, OneToOne, JoinTable, CollectionTable

Дополнительная Сводка Элемента

java.lang.String	columnDefinition (Дополнительный) фрагмент SQL, который используется, генерируя DDL для столбца.
boolean	insertable (Дополнительный), включается Ли столбец в операторы INSERT SQL, сгенерированные провайдером персистентности.
java.lang.String	имя (Дополнительный) имя столбца внешнего ключа.
boolean	nullable (Дополнительный), является Ли столбец внешнего ключа nullable.
java.lang.String	referencedColumnName (Дополнительный) На имя столбца ссылается этот столбец внешнего ключа.
java.lang.String	таблица (Дополнительный) имя таблицы, которая содержит столбец.
boolean	уникальный (Дополнительный), является Ли свойство уникальным ключом.
boolean	обновляемый (Дополнительный), включается Ли столбец в операторы UPDATE SQL, сгенерированные провайдером персистентности.

имя

public abstract java.lang.String name

(Дополнительный) имя столбца внешнего ключа. Таблица, в которой это находится, зависит от контекста.

• Если соединение для отображения OneToOne или ManyToOne, используя стратегию отображения внешнего ключа, столбец внешнего ключа находится в таблице исходного объекта или встраиваем.
• Если соединение для однонаправленного отображения OneToMany, используя стратегию отображения внешнего ключа, внешний ключ находится в таблице целевого объекта.
• Если соединение для отображения ManyToMany или для OneToOne или двунаправленного ManyToOne/OneToMany, отображающего использование объединяющей таблицы, внешний ключ находится в объединяющей таблице.
• Если соединение для набора элемента, внешний ключ находится в таблице набора.

Значение по умолчанию (только применяется, если единственный объединяющий столбец используется): связь следующего: имя свойства отношения ссылки или поле объекта ссылки или встраиваемого class; "_"; имя столбца первичного ключа, на который ссылаются. Если нет такого свойства отношения ссылки или поля в объекте, или если соединение для набора элемента, имя объединяющего столбца формируется как связь следующего: имя объекта; "_"; имя столбца первичного ключа, на который ссылаются.

Значение по умолчанию:

""

referencedColumnName

public abstract java.lang.String referencedColumnName

(Дополнительный) На имя столбца ссылается этот столбец внешнего ключа.

• Когда использующийся с отображениями связи сущностей кроме случаев, описанных здесь, столбец, на который ссылаются, находится в таблице целевого объекта.
• Когда использующийся с однонаправленным отображением внешнего ключа OneToMany, столбец, на который ссылаются, находится в таблице исходного объекта.
• Когда использующийся внутри a JoinTable аннотация, ключевой столбец, на который ссылаются, находится в таблице объекта объекта обладания, или обратного объекта, если соединение является частью обратного определения соединения.
• Когда использующийся в a CollectionTable отображаясь, столбец, на который ссылаются, находится в таблице объекта, содержащего набор.

Значение по умолчанию (только применяется, если единственный объединяющий столбец используется): то же самое имя как столбец первичного ключа таблицы, на которую ссылаются.

Значение по умолчанию:

""

уникальный

public abstract boolean unique

(Дополнительный), является Ли свойство уникальным ключом. Это - ярлык для UniqueConstraint аннотация на табличном уровне и полезна для того, когда ограничение уникального ключа является только единственным полем. Не необходимо явно определить это для объединяющего столбца, который соответствует первичному ключу, который является частью внешнего ключа.

Значение по умолчанию:

ложь

nullable

public abstract boolean nullable

(Дополнительный), является Ли столбец внешнего ключа nullable.

Значение по умолчанию:

истина

insertable

public abstract boolean insertable

(Дополнительный), включается Ли столбец в операторы INSERT SQL, сгенерированные провайдером персистентности.

Значение по умолчанию:

истина

обновляемый

public abstract boolean updatable

(Дополнительный), включается Ли столбец в операторы UPDATE SQL, сгенерированные провайдером персистентности.

Значение по умолчанию:

истина

columnDefinition

public abstract java.lang.String columnDefinition

(Дополнительный) фрагмент SQL, который используется, генерируя DDL для столбца.

Значения по умолчанию к сгенерированному SQL для столбца.

Значение по умолчанию:

""

таблица

public abstract java.lang.String table

(Дополнительный) имя таблицы, которая содержит столбец. Если таблица не определяется, столбец, как предполагается, находится в первичной таблице применимого объекта.

Значение по умолчанию:

• Если соединение для отображения OneToOne или ManyToOne, используя стратегию отображения внешнего ключа, имя таблицы исходного объекта или встраиваемо.
• Если соединение для однонаправленного отображения OneToMany, используя стратегию отображения внешнего ключа, имя таблицы целевого объекта.
• Если соединение для отображения ManyToMany или для OneToOne или двунаправленного ManyToOne/OneToMany, отображающего использование объединяющей таблицы, имени объединяющей таблицы.
• Если соединение для набора элемента, имени таблицы набора.

Значение по умолчанию:

""