zoukankan      html  css  js  c++  java
  • Hibernate注解详解(超全面不解释)

    原博客地址:http://blog.csdn.net/sufei58/article/details/48223731

    我只是收藏来方便自己查阅的,希望博主不要介意

    一。实体Bean

    每个持久化POJO类都是一个实体Bean, 通过在类的定义中使用 @Entity 注解来进行声明。

    声明实体Bean

    @Entity
    public class Flightimplements Serializable {
      Long id;
      @Id
      public Long getId() { return id; }
      public void setId(Long id) { this.id = id; }
    }

    @Entity 注解将一个类声明为实体Bean, @Id 注解声明了该实体Bean的标识属性。

    hibernate 可以对类的属性或者方法进行注解。属性对应field类别,方法的getXxx()对应property类别。

    定义表

    通过 @Table 为实体Bean指定对应数据库表,目录和schema的名字。

    @Entity
    @Table(name="tbl_sky")
    public class Skyimplements Serializable {

    ...

    @Table 注解包含一个schema和一个catelog属性,使用@UniqueConstraints 可以定义表的唯一约束。

    @Table(name="tbl_sky",
      uniqueConstraints ={@UniqueConstraint(columnNames={"month", "day"})}
    )

    上述代码在  "month" 和 "day" 两个 field 上加上unique constrainst.

    @Version 注解用于支持乐观锁版本控制

    @Entity
    public class Flightimplements Serializable {
       ...
       @Version
       @Column(name="OPTLOCK")
       public Integer getVersion() { ... }
    }

    version属性映射到 "OPTLOCK" 列,entity manager 使用这个字段来检测冲突。一般可以用数字或者 timestamp 类型来支持 version.

    实体Bean中所有非static 非 transient 属性都可以被持久化,除非用@Transient注解。

    默认情况下,所有属性都用 @Basic 注解。

    public transient intcounter; //transient property

    private Stringfirstname; //persistent property
    @Transient
    StringgetLengthInMeter() { ... } //transient property
    String getName() {...} // persistent property
    @Basic
    int getLength() { ...} // persistent property
    @Basic(fetch =FetchType.LAZY)
    StringgetDetailedComment() { ... } // persistent property
    @Temporal(TemporalType.TIME)
    Java.util.DategetDepartureTime() { ... } // persistent property
    @Enumerated(EnumType.STRING)
    Starred getNote() {... } //enum persisted as String in database

    上述代码中counter, lengthInMeter 属性将忽略不被持久化,而firstname, name, length 被定义为可持久化和可获取的。

    @TemporalType.(DATE,TIME,TIMESTAMP)分别Map java.sql.(Date,Time, Timestamp).

    @Lob注解属性将被持久化为 Blog 或 Clob 类型。具体的java.sql.Clob, Character[], char[] 和 java.lang.String 将被持久化为 Clob 类型. java.sql.Blob,Byte[], byte[] 和 serializable type 将被持久化为 Blob 类型。

    @Lob
    public StringgetFullText() {
       return fullText;  // clob type
    }


    @Lob
    public byte[]getFullCode() {
      return fullCode;  // blog type
    }

    @Column 注解将属性映射到列。

    @Entity
    public class Flightimplements Serializable {
       ...
       @Column(updatable = false, name ="flight_name", nullable = false, length=50)
       public String getName() { ... }

    定义 name 属性映射到 flight_name column, not null, can't update, length equal 50

    @Column(
       name="columnName"; (1) 列名
       boolean unique() default false; (2)    是否在该列上设置唯一约束
       boolean nullable() default true; (3)   列可空?
       boolean insertable() default true; (4) 该列是否作为生成 insert语句的一个列
       boolean updatable() default true; (5)  该列是否作为生成 update语句的一个列
       String columnDefinition() default""; (6)  默认值
       String table() default "";(7)             定义对应的表(deault 是主表)
       int length() default 255; (8)              列长度
       int precision() default 0; // decimalprecision (9)  decimal精度
       int scale() default 0; // decimal scale        (10) decimal长度

    嵌入式对象(又称组件)也就是别的对象定义的属性

    组件类必须在类一级定义 @Embeddable 注解。在特定的实体关联属性上使用 @Embeddable 和@AttributeOverride 注解可以覆盖该属性对应的嵌入式对象的列映射。

    @Entity
    public class Personimplements Serializable {
       // Persistent component using defaults
       Address homeAddress;
       @Embedded
       @AttributeOverrides( {
          @AttributeOverride(name="iso2",column = @Column(name="bornIso2") ),
          @AttributeOverride(name="name",column = @Column(name="bornCountryName") )
       } )
       Country bornIn;
       ...
    }

    @Embeddable
    public class Addressimplements Serializable {
       String city;
       Country nationality; //no overriding here
    }

    @Embeddable
    public class Countryimplements Serializable {
       private String iso2;
       @Column(name="countryName")private String name;
       public String getIso2() { return iso2; }
       public void setIso2(String iso2) { this.iso2= iso2; }
       public String getName() { return name; }
       public void setName(String name) { this.name= name; }
       ...
    }

    Person 类定义了 Address 和  Country 对象,具体两个类实现见上。

    无注解属性默认值:

    •属性为简单类型,则映射为@Basic

    •属性对应的类型定义了@Embeddable 注解,则映射为@Embedded

    •属性对应的类型实现了Serializable,则属性被映射为@Basic并在一个列中保存该对象的serialized版本。

    •属性的类型为java.sql.Clob or java.sql.Blob, 则映射到 @Lob 对应的类型。

    映射主键属性

    @Id 注解可将实体Bean中某个属性定义为主键,使用@GenerateValue注解可以定义该标识符的生成策略。

    • AUTO -  可以是 identity column, sequence 或者 table 类型,取决于不同底层的数据库
    • TABLE - 使用table保存id值
    • IDENTITY - identity column
    • SEQUENCE - seque

    nce

    @Id@GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")
    public Integer getId(){ ... }

    @Id@GeneratedValue(strategy=GenerationType.IDENTITY)
    public Long getId() {... }

    AUTO 生成器,适用与可移值的应用,多个@Id可以共享同一个identifier生成器,只要把generator属性设成相同的值就可以。通过@SequenceGenerator和@TableGenerator 可以配置不同的identifier 生成器。

    <table-generatorname="EMP_GEN"
         table="GENERATOR_TABLE"
         pk-column-name="key"
         value-column-name="hi"
         pk-column-value="EMP"
         allocation-size="20"/>
    //and the annotationequivalent
    @javax.persistence.TableGenerator(
         name="EMP_GEN",
         table="GENERATOR_TABLE",
         pkColumnName = "key",
         valueColumnName = "hi"
         pkColumnValue="EMP",
         allocationSize=20
    )
    <sequence-generatorname="SEQ_GEN"
         sequence-name="my_sequence"
         allocation-size="20"/>
    //and the annotationequivalent
    @javax.persistence.SequenceGenerator(
         name="SEQ_GEN",
         sequenceName="my_sequence",
         allocationSize=20
    )

     

    The next example showsthe definition of a sequence generator in a class scope:

    @Entity
    @javax.persistence.SequenceGenerator(
        name="SEQ_STORE",
        sequenceName="my_sequence"
    )
    public class Storeimplements Serializable {
       private Long id;
       @Id@GeneratedValue(strategy=GenerationType.SEQUENCE,generator="SEQ_STORE")
       public Long getId() { return id; }
    }

    Store类使用名为my_sequence的sequence,并且SEQ_STORE生成器对于其他类是不可见的。

    通过下面语法,你可以定义组合键。

    •将组件类注解为@Embeddable,并将组件的属性注解为 @Id
    •将组件的属性注解为@EmbeddedId
    •将类注解为@IdClass,并将该实体中所有主键的属性都注解为 @Id

    @Entity
    @IdClass(FootballerPk.class)
    public classFootballer {
      //part of the id key
      @Id public String getFirstname() {
        return firstname;
      }
      public void setFirstname(String firstname) {
         this.firstname = firstname;
      }
      //part of the id key
      @Id public String getLastname() {
        return lastname;
      }
      public void setLastname(String lastname) {
        this.lastname = lastname;
      }
      public String getClub() {
        return club;
      }
      public void setClub(String club) {
       this.club = club;
      }
      //appropriate equals() and hashCode()implementation
    }

    @Embeddable
    public classFootballerPk implements Serializable {
      //same name and type as in Footballer
      public String getFirstname() {
        return firstname;
      }
      public void setFirstname(String firstname) {
        this.firstname = firstname;
      }
      //same name and type as in Footballer
      public String getLastname() {
        return lastname;
      }
      public void setLastname(String lastname) {
       this.lastname = lastname;
      }
      //appropriate equals() and hashCode()implementation
    }

     

    @Entity
    @AssociationOverride(name="id.channel", joinColumns =@JoinColumn(name="chan_id") )
    public class TvMagazin{
       @EmbeddedId public TvMagazinPk id;
       @Temporal(TemporalType.TIME) Date time;
    }


    @Embeddable
    public class TvMagazinPkimplements Serializable {
       @ManyToOne
       public Channel channel;
       public String name;
       @ManyToOne
       public Presenter presenter;
    }

    映射继承关系

    EJB支持3种类型的继承。

    • Table per Class Strategy: the <union-class> element inHibernate 每个类一张表
    • Single Table per Class Hierarchy Strategy: the<subclass> element in Hibernate 每个类层次结构一张表
    • Joined Subclass Strategy: the <joined-subclass>element in Hibernate 连接的子类策略

    @Inheritance 注解来定义所选的之类策略。

    每个类一张表

    @Entity
    @Inheritance(strategy= InheritanceType.TABLE_PER_CLASS)
    public class Flightimplements Serializable {

    有缺点,如多态查询或关联。Hibernate使用 SQL Union 查询来实现这种策略。这种策略支持双向的一对多关联,但不支持IDENTIFY 生成器策略,因为ID必须在多个表间共享。一旦使用就不能使用AUTO和IDENTIFY生成器。

    每个类层次结构一张表

    @Entity
    @Inheritance(strategy=InheritanceType.SINGLE_TABLE)
    @DiscriminatorColumn(
        name="planetype",
        discriminatorType=DiscriminatorType.STRING
    )
    @DiscriminatorValue("Plane")
    public class Plane {... }

    @Entity
    @DiscriminatorValue("A320")
    public class A320extends Plane { ... }

    整个层次结构中的所有父类和子类属性都映射到同一个表中,他们的实例通过一个辨别符列(discriminator)来区分。

    Plane 是父类。@DiscriminatorColumn注解定义了辨别符列。对于继承层次结构中的每个类,@DiscriminatorValue 注解指定了用来辨别该类的值。辨别符列名字默认为DTYPE,其默认值为实体名。其类型为DiscriminatorType.STRING。

    连接的子类

    @Entity
    @Inheritance(strategy=InheritanceType.JOINED)
    public class Boatimplements Serializable { ... }


    @Entity
    public class Ferryextends Boat { ... }

    @Entity
    @PrimaryKeyJoinColumn(name="BOAT_ID")
    public classAmericaCupClass extends Boat { ... }

    以上所有实体使用JOINED 策略 Ferry和Boat class使用同名的主键关联(eg:Boat.id = Ferry.id), AmericaCupClass 和Boat 关联的条件为Boat.id = AmericaCupClass.BOAT_ID.

    从父类继承的属性

    @MappedSuperclass
    public classBaseEntity {
      @Basic
      @Temporal(TemporalType.TIMESTAMP)
      public Date getLastUpdate() { ... }
      public String getLastUpdater() { ... }
      ...
    }


    @Entity class Orderextends BaseEntity {
      @Id public Integer getId() { ... }
      ...
    }

    继承父类的一些属性,但不用父类作为映射实体,这时候需要 @MappedSuperclass 注解。上述实体映射到数据库中的时候对应Order 实体Bean, 其具有 id, lastUpdate, lastUpdater 三个属性。如果没有@MappedSuperclass 注解,则父类中属性忽略,这是Order 实体 Bean 只有 id 一个属性。

    映射实体Bean的关联关系

    一对一

    使用 @OneToOne 注解可以建立实体Bean之间的一对一关系。一对一关系有3种情况。

    •关联的实体都共享同样的主键。

    @Entity
    public class Body {
      @Id
      public Long getId() { return id; }
      @OneToOne(cascade = CascadeType.ALL)
      @PrimaryKeyJoinColumn
      public Heart getHeart() {
         return heart;
      }
      ...
    }

    @Entity
    public class Heart {
      @Id
      public Long getId() { ...}
    }

    通过@PrimaryKeyJoinColumn 注解定义了一对一的关联关系。


    •其中一个实体通过外键关联到另一个实体的主键。注:一对一,则外键必须为唯一约束。

    @Entity
    public class Customerimplements Serializable {
       @OneToOne(cascade = CascadeType.ALL)
       @JoinColumn(name="passport_fk")
       public Passport getPassport() {
       ...
    }


    @Entity
    public class Passportimplements Serializable {
       @OneToOne(mappedBy = "passport")
       public Customer getOwner() {
       ...
    }

    通过@JoinColumn注解定义一对一的关联关系。如果没有@JoinColumn注解,则系统自动处理,在主表中将创建连接列,列名为:主题的关联属性名 + 下划线 + 被关联端的主键列名。上例为 passport_id, 因为Customer 中关联属性为passport, Passport 的主键为 id.


    •通过关联表来保存两个实体之间的关联关系。注:一对一,则关联表每个外键都必须是唯一约束。

    @Entity
    public class Customerimplements Serializable {
       @OneToOne(cascade = CascadeType.ALL)
       @JoinTable(name= "CustomerPassports",
            joinColumns= @JoinColumn(name="customer_fk"),
            inverseJoinColumns= @JoinColumn(name="passport_fk")
       )
       public Passport getPassport() {
       ...
    }


    @Entity public classPassport implements Serializable {
       @OneToOne(mappedBy = "passport")
       public Customer getOwner() {
       ...
    }

    Customer 通过 CustomerPassports 关联表和 Passport 关联。该关联表通过passport_fk 外键指向Passport 表,该信心定义为inverseJoinColumns 的属性值。通过 customer_fk 外键指向Customer 表,该信息定义为joinColumns 属性值。

    多对一

    使用 @ManyToOne 注解定义多对一关系。

    @Entity()
    public class Flightimplements Serializable {
      @ManyToOne( cascade = {CascadeType.PERSIST,CascadeType.MERGE} )
      @JoinColumn(name="COMP_ID")
      public Company getCompany() {
        return company;
      }
      ...
    }

    其中@JoinColumn 注解是可选的,关键字段默认值和一对一关联的情况相似。列名为:主题的关联属性名 + 下划线+ 被关联端的主键列名。本例中为company_id,因为关联的属性是company,Company的主键为 id.

    @ManyToOne 注解有个targetEntity属性,该参数定义了目标实体名。通常不需要定义,大部分情况为默认值。但下面这种情况则需要 targetEntity 定义(使用接口作为返回值,而不是常用的实体)。

    @Entity()
    public class Flightimplements Serializable {
       @ManyToOne(cascade=  {CascadeType.PERSIST,CascadeType.MERGE},targetEntity= CompanyImpl.class)
       @JoinColumn(name="COMP_ID")
       public Company getCompany() {
         return company;
       }
       ...
    }


    public interfaceCompany {
       ...

    多对一也可以通过关联表的方式来映射,通过 @JoinTable 注解可定义关联表。该关联表包含指回实体的外键(通过@JoinTable.joinColumns)以及指向目标实体表的外键(通过@JoinTable.inverseJoinColumns).

    @Entity()
    public class Flightimplements Serializable {

       @ManyToOne( cascade = {CascadeType.PERSIST,CascadeType.MERGE} )
       @JoinTable(name="Flight_Company",
           joinColumns =@JoinColumn(name="FLIGHT_ID"),
           inverseJoinColumns =@JoinColumn(name="COMP_ID")
       )
       public Company getCompany() {
           return company;
       }
       ...
    }

    集合类型

     

     一对多

    @OneToMany 注解可定义一对多关联。一对多关联可以是双向的。

    双向

    规范中多对一端几乎总是双向关联中的主体(owner)端,而一对多的关联注解为 @OneToMany(mappedBy=)

    @Entity
    public class Troop {
      @OneToMany(mappedBy="troop")
      public Set<Soldier> getSoldiers() {
      ...
    }


    @Entity
    public class Soldier {
      @ManyToOne
      @JoinColumn(name="troop_fk")
      public Troop getTroop() {
      ...
      }

    Troop 通过troop属性和Soldier建立了一对多的双向关联。在 mappedBy 端不必也不能定义任何物理映射。

    单向

    @Entity
    public class Customerimplements Serializable {
       @OneToMany(cascade=CascadeType.ALL,fetch=FetchType.EAGER)
       @JoinColumn(name="CUST_ID")
       public Set<Ticket> getTickets() {
          ...
       }

    @Entity
    public class Ticketimplements Serializable {
       ... //no bidir
    }

    一般通过连接表来实现这种关联,可以通过@JoinColumn注解来描述这种单向关联关系。上例 Customer 通过CUST_ID列和 Ticket 建立了单向关联关系。

    通过关联表来处理单向关联

    @Entity
    public class Trainer {
      @OneToMany
      @JoinTable(
         name="TrainedMonkeys",
         joinColumns = @JoinColumn(name="trainer_id"),
         inverseJoinColumns = @JoinColumn(name="monkey_id")
      )
      public Set<Monkey> getTrainedMonkeys(){
         ...
      }


    @Entity
    public class Monkey {
      ... //no bidir
    }

    通过关联表来处理单向一对多关系是首选,这种关联通过 @JoinTable 注解来进行描述。上例子中Trainer 通过TrainedMonkeys表和Monkey建立了单向关联关系。其中外键trainer_id关联到Trainer(joinColumns)而外键monkey_id关联到Monkey(inverseJoinColumns).

    默认处理机制

    通过连接表来建立单向一对多关联不需要描述任何物理映射,表名由一下3个部分组成,主表(ownertable)表名 + 下划线 + 从表(the other side table)表名。指向主表的外键名:主表表名+下划线+主表主键列名指向从表的外键定义为唯一约束,用来表示一对多的关联关系。

    @Entity
    public class Trainer {
      @OneToMany
      public Set<Tiger> getTrainedTigers(){
      ...
    }


    @Entity
    public class Tiger {
      ... //no bidir
    }

    上述例子中Trainer 和 Tiger 通过 Trainer_Tiger 连接表建立单向关联关系。其中外键 trainer_id 关联到Trainer表,而外键 trainedTigers_id 关联到Tiger 表。

    多对多

    通过 @ManyToMany 注解定义多对多关系,同时通过 @JoinTable 注解描述关联表和关联条件。其中一端定义为owner, 另一段定义为inverse(对关联表进行更新操作,这段被忽略)。

    @Entity
    public class Employerimplements Serializable {
      @ManyToMany(
       targetEntity=org.hibernate.test.metadata.manytomany.Employee.class,
        cascade={CascadeType.PERSIST,CascadeType.MERGE}
      )
      @JoinTable(
        name="EMPLOYER_EMPLOYEE",
       joinColumns=@JoinColumn(name="EMPER_ID"),
       inverseJoinColumns=@JoinColumn(name="EMPEE_ID")
      )
      public Collection getEmployees() {
        return employees;
      }
      ...
    }

    @Entity
    public class Employeeimplements Serializable {
      @ManyToMany(
        cascade = {CascadeType.PERSIST,CascadeType.MERGE},
        mappedBy = "employees",
        targetEntity = Employer.class
      )
      public Collection getEmployers() {
        return employers;
      }
    }

    默认值:

    关联表名:主表表名 + 下划线 + 从表表名;关联表到主表的外键:主表表名 + 下划线 + 主表中主键列名;关联表到从表的外键名:主表中用于关联的属性名 + 下划线 + 从表的主键列名。

    用cascading 实现传播持久化(Transitivepersistence)

    cascade 属性接受值为 CascadeType 数组,其类型如下:

    • CascadeType.PERSIST:cascades the persist (create) operation to associated entities persist() iscalled or if the entity is managed 如果一个实体是受管状态,或者当 persist() 函数被调用时,触发级联创建(create)操作。


    • CascadeType.MERGE:cascades the merge operation to associated entities if merge() is called or ifthe entity is managed 如果一个实体是受管状态,或者当merge() 函数被调用时,触发级联合并(merge)操作。


    • CascadeType.REMOVE:cascades the remove operation to associated entities if delete() is called 当 delete() 函数被调用时,触发级联删除(remove)操作。


    • CascadeType.REFRESH:cascades the refresh operation to associated entities if refresh() iscalled  当 refresh() 函数被调用时,出发级联更新(refresh)操作。


    • CascadeType.ALL:all of the above  以上全部

    映射二级列表

    使用类一级的 @SecondaryTable 和 @SecondaryTables 注解可以实现单个实体到多个表的映射。使用@Column或者@JoinColumn 注解中的table 参数可以指定某个列所属的特定表。

    @Entity
    @Table(name="MainCat")
    @SecondaryTables({
        @SecondaryTable(name="Cat1",pkJoinColumns={
              @PrimaryKeyJoinColumn(name="cat_id",referencedColumnName="id")}),
        @SecondaryTable(name="Cat2",uniqueConstraints={
              @UniqueConstraint(columnNames={"storyPart2"})})
     })
    public class Catimplements Serializable {
      private Integer id;
      private String name;

      private String storyPart1;
      private String storyPart2;
      @Id @GeneratedValue
      public Integer getId() {
        return id;
      }
      public String getName() {
        return name;
      }
      @Column(table="Cat1")
      public String getStoryPart1() {
        return storyPart1;
      }
      @Column(table="Cat2")
      public String getStoryPart2() {
        return storyPart2;
      }

    上述例子中,name 保存在MainCat 表中,storyPart1保存在 Cat1 表中,storyPart2保存在Cat2 表中。Cat1 表通过外键cat_id 和 MainCat 表关联, Cat2 表通过 id 列和 MainCat 表关联。对storyPart2列还定义了唯一约束。

    映射查询

    使用注解可以映射EJBQL/HQL 查询,@NamedQuery和 @NamedQueries 是可以使用在类级别或者JPA的XML文件中的注解。

    <entity-mappings>
     <named-queryname="plane.getAll">
      <query>select p from Planep</query>
     </named-query>
     ...
    </entity-mappings>
    ...
    @Entity
    @NamedQuery(name="night.moreRecentThan",query="select n from Night n where n.date >= :date")
    public class Night {
     ...
    }
    public class MyDao {
     doStuff() {
       Query q =s.getNamedQuery("night.moreRecentThan");
       q.setDate( "date", aMonthAgo );
       List results = q.list();
       ...
     }
     ...
    }

    可以通过定义QueryHint 数组的hints 属性为查询提供一些hint 信息。下图是一些Hibernate hints:

     

     

    映射本地化查询

    通过@SqlResultSetMapping 注解来描述 SQL 的 resultset 结构。如果定义多个结果集映射,则用@SqlResultSetMappings。

    @NamedNativeQuery(name="night&area",query="select night.id nid, night.night_duration, "
         + " night.night_date, area.id aid,night.area_id, area.name "
         + "from Night night, Area area wherenight.area_id = area.id", resultSetMapping="joinMapping")

    @SqlResultSetMapping(name="joinMapping", entities={
     @EntityResult(entityClass=org.hibernate.test.annotations.query.Night.class,fields = {
       @FieldResult(name="id",column="nid"),
       @FieldResult(name="duration",column="night_duration"),
       @FieldResult(name="date",column="night_date"),
       @FieldResult(name="area",column="area_id"),
       discriminatorColumn="disc"
      }),
      
     @EntityResult(entityClass=org.hibernate.test.annotations.query.Area.class,fields = {
       @FieldResult(name="id",column="aid"),
       @FieldResult(name="name",column="name")
      })
     }
    )

    上面的例子,名为“night&area”的查询和 "joinMapping"结果集映射对应,该映射返回两个实体,分别为 Night 和Area, 其中每个属性都和一个列关联,列名通过查询获取。

    @Entity
    @SqlResultSetMapping(name="implicit",
      entities=@EntityResult(
       entityClass=org.hibernate.test.annotations.@NamedNativeQuery(
          name="implicitSample",query="select * from SpaceShip", 
          resultSetMapping="implicit")
    public class SpaceShip{
     private String name;
     private String model;
     private double speed;
     @Id
     public String getName() {
      return name;
     }
     public void setName(String name) {
      this.name = name;
     }
     @Column(name="model_txt")
     public String getModel() {
      return model;
     }
     public void setModel(String model) {
      this.model = model;
     }
     public double getSpeed() {
      return speed;
     }
     public void setSpeed(double speed) {
      this.speed = speed;
     }
    }

    上例中model1 属性绑定到model_txt 列,如果和相关实体关联设计到组合主键,那么应该使用 @FieldResult 注解来定义每个外键列。@FieldResult的名字组成:定义这种关系的属性名字 +"." + 主键名或主键列或主键属性。

    @Entity
    @SqlResultSetMapping(name="compositekey",
     entities=@EntityResult(entityClass=org.hibernate.test.annotations.query.SpaceShip.class,
      fields = {
       @FieldResult(name="name", column ="name"),
       @FieldResult(name="model", column= "model"),
       @FieldResult(name="speed", column= "speed"),
       @FieldResult(name="captain.firstname",column = "firstn"),
      @FieldResult(name="captain.lastname", column ="lastn"),
      @FieldResult(name="dimensions.length", column ="length"),
      @FieldResult(name="dimensions.width", column ="width")
      }),
     columns = { @ColumnResult(name ="surface"),
     
    @ColumnResult(name ="volume") } )
     @NamedNativeQuery(name="compositekey",
     query="select name, model, speed, lnameas lastn, fname as firstn, length, width, length * width asresultSetMapping="compositekey")
    })

    如果查询返回的是单个实体,或者打算用系统默认的映射,这种情况下可以不使用 resultSetMapping,而使用resultClass属性,例如:

    @NamedNativeQuery(name="implicitSample", query="select * fromSpaceShip",
                                               resultClass=SpaceShip.class)
    public class SpaceShip{

    Hibernate 独有的注解扩展

    Hibernate 提供了与其自身特性想吻合的注解,org.hibernate.annotations package包含了这些注解。

    实体

    org.hibernate.annotations.Entity定义了  Hibernate 实体需要的信息。

    • mutable: whetherthis entity is mutable or not  此实体是否可变


    • dynamicInsert:allow dynamic SQL for inserts   用动态SQL新增



    • dynamicUpdate: allow dynamic SQL forupdates   用动态SQL更新



    • selectBeforeUpdate: Specifies thatHibernate should never perform an SQL UPDATE unless it is certain that anobject is actually modified.指明Hibernate从不运行SQL Update,除非能确定对象已经被修改


    • polymorphism:whether the entity polymorphism is of PolymorphismType.IMPLICIT (default) orPolymorphismType.EXPLICIT 指出实体多态是PolymorphismType.IMPLICIT(默认)还是PolymorphismType.EXPLICIT


    • optimisticLock:optimistic locking strategy (OptimisticLockType.VERSION, OptimisticLockType.NONE,OptimisticLockType.DIRTY or OptimisticLockType.ALL) 乐观锁策略

    标识符

    @org.hibernate.annotations.GenericGenerator和@org.hibernate.annotations.GenericGenerators允许你定义hibernate特有的标识符。

    @Id@GeneratedValue(generator="system-uuid")
    @GenericGenerator(name="system-uuid",strategy = "uuid")
    public String getId(){
    @Id@GeneratedValue(generator="hibseq")
    @GenericGenerator(name="hibseq",strategy = "seqhilo",
       parameters = {
         @Parameter(name="max_lo", value= "5"),
         @Parameter(name="sequence",value="heybabyhey")
       }
    )
    public Integer getId(){

    新例子

    @GenericGenerators(
     {
      @GenericGenerator(
       name="hibseq",
       strategy = "seqhilo",
       parameters = {
        @Parameter(name="max_lo", value ="5"),
        @Parameter(name="sequence", value="heybabyhey")
       }
      ),
      @GenericGenerator(...)
     }
    )

    自然ID

    用 @NaturalId 注解标识

    公式

    让数据库而不是JVM进行计算。

    @Formula("obj_length* obj_height * obj_width")
    public longgetObjectVolume()

    索引

    通过在列属性(property)上使用@Index注解,可以指定特定列的索引,columnNames属性(attribute)将随之被忽略。

    @Column(secondaryTable="Cat1")
    @Index(name="story1index")
    public StringgetStoryPart1() {
      return storyPart1;
    }

    辨别符

    @Entity
    @DiscriminatorFormula("casewhen forest_type is null then 0 else forest_type end")
    public class Forest {... }

  • 相关阅读:
    单元测试——破除依赖
    单元测试——基础概念
    2015年9月书单推荐
    菜鸟vimer成长记——第4.2章、编程插件
    克服弱点,愈发完美-自我篇——《人性的弱点》读后感
    菜鸟vimer成长记——第4.0章、Vim插件管理利器-Vundle
    菜鸟vimer成长记——第3章、文件
    阿里IPO法律咨询费达1580万美元 为Facebook六倍
    新移民漫画家 以幻想构筑奇妙世界
    请教Amazon FBA里面Label Service, Stickerless, Commingled Inventory是什么意思?
  • 原文地址:https://www.cnblogs.com/zzmb/p/7733677.html
Copyright © 2011-2022 走看看