javax.persistence

注釈型 MapKey

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

マップキー自体が主キーである場合にjava.util.Map型の関連付けのためのマップキーを指定するか、 マップの値であるエンティティの永続化フィールドまたはプロパティを指定します。

主キー以外の永続化フィールドまたはプロパティがマップキーとして使用される場合でもそれに関連付けられた一意制約があることが予期されます。

MapKeyClassアノテーションとMapKeyアノテーションは同時に使われることはありません。

    Example 1:

    @Entity
    public class Department {
        ...
        @OneToMany(mappedBy="department")
        @MapKey  // マップキーは主キー
        public Map<Integer, Employee> getEmployees() {... }
        ...
    }

    @Entity
    public class Employee {
        ...
        @Id Integer getEmpId() { ... }
        @ManyToOne
        @JoinColumn(name="dept_id")
        public Department getDepartment() { ... }
        ...
    }

    Example 2:

    @Entity
        public class Department {
        ...
        @OneToMany(mappedBy="department")
        @MapKey(name="name")
        public Map<String, Employee> getEmployees() {... }
        ...
    }

    @Entity
        public class Employee {
        @Id public Integer getEmpId() { ... }
        ...
        @ManyToOne
        @JoinColumn(name="dept_id")
        public Department getDepartment() { ... }
        ...
    }
 

導入されたバージョン:

Java Persistence 1.0

任意要素のサマリー

任意要素

修飾子とタイプ	任意要素と説明
java.lang.String	name (オプション) マップキーとして使用される関連エンティティの永続化フィールドまたはプロパティの名前。

要素の詳細

name

public abstract java.lang.String name

(オプション) マップキーとして使用される関連エンティティの永続化フィールドまたはプロパティの名前。

デフォルト： name要素が指定されていない場合は関連エンティティの主キーがマップキーとして使用されます。 主キーが複合主キーであり、IdClassとしてマッピングされている場合は主キークラスのインスタンスがキーとして使用されます。

デフォルト:

""