注解的力量 -----Spring 2.5 JPA hibernate 使用方法的点滴整理(六)

2023-11-06

一、 实体 Bean

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

声明实体Bean

@Entity
public class Flight implements 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 Sky implements Serializable {

...

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

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

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

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

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

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

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

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

public transient int counter; //transient property

private String firstname; //persistent property
@Transient
String getLengthInMeter() { ... } //transient property
String getName() {... } // persistent property
@Basic
int getLength() { ... } // persistent property
@Basic(fetch = FetchType.LAZY)
String getDetailedComment() { ... } // persistent property
@Temporal(TemporalType.TIME)
java.util.Date getDepartureTime() { ... } // 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 String getFullText() {
   return fullText;  // clob type
}


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

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

@Entity
public class Flight implements 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; // decimal precision (9)  decimal精度
   int scale() default 0; // decimal scale        (10)  decimal长度

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

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

@Entity
public class Person implements 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 Address implements Serializable {
   String city;
   Country nationality; //no overriding here
}

@Embeddable
public class Country implements 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-generator name="EMP_GEN"
     table="GENERATOR_TABLE"
     pk-column-name="key"
     value-column-name="hi"
     pk-column-value="EMP"
     allocation-size="20"/>
//and the annotation equivalent
@javax.persistence.TableGenerator(
     name="EMP_GEN",
     table="GENERATOR_TABLE",
     pkColumnName = "key",
     valueColumnName = "hi"
     pkColumnValue="EMP",
     allocationSize=20
)
<sequence-generator name="SEQ_GEN"
     sequence-name="my_sequence"
     allocation-size="20"/>
//and the annotation equivalent
@javax.persistence.SequenceGenerator(
     name="SEQ_GEN",
     sequenceName="my_sequence",
     allocationSize=20
)

 

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

@Entity
@javax.persistence.SequenceGenerator(
    name="SEQ_STORE",
    sequenceName="my_sequence"
)
public class Store implements 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 class Footballer {
  //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 class FootballerPk 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 TvMagazinPk implements Serializable {
   @ManyToOne
   public Channel channel;
   public String name;
   @ManyToOne
   public Presenter presenter;
}

映射继承关系

EJB支持3种类型的继承。

• Table per Class Strategy: the <union-class> element in Hibernate 每个类一张表
• 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 Flight implements 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 A320 extends Plane { ... }

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

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

连接的子类

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


@Entity
public class Ferry extends Boat { ... }

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

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

从父类继承的属性

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


@Entity class Order extends 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 Customer implements Serializable {
   @OneToOne(cascade = CascadeType.ALL)
   @JoinColumn(name="passport_fk")
   public Passport getPassport() {
   ...
}


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

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


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

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


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

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


多对一

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

@Entity()
public class Flight implements 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 Flight implements Serializable {
   @ManyToOne(cascade=   {CascadeType.PERSIST,CascadeType.MERGE},targetEntity= CompanyImpl.class)
   @JoinColumn(name="COMP_ID")
   public Company getCompany() {
     return company;
   }
   ...
}


public interface Company {
   ...


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

@Entity()
public class Flight implements 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 Customer implements Serializable {
   @OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)
   @JoinColumn(name="CUST_ID")
   public Set<Ticket> getTickets() {
      ...
   }

@Entity
public class Ticket implements 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个部分组成,主表(owner table)表名 + 下划线 + 从表(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 Employer implements 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 Employee implements Serializable {
  @ManyToMany(
    cascade = {CascadeType.PERSIST, CascadeType.MERGE},
    mappedBy = "employees",
    targetEntity = Employer.class
  )
  public Collection getEmployers() {
    return employers;
  }
}

默认值:

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

用 cascading 实现传播持久化(Transitive persistence)

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

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


• CascadeType.MERGE: cascades the merge operation to associated entities if merge() is called or if the 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() is called  当 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 Cat implements 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-query name="plane.getAll">
  <query>select p from Plane p</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 where night.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, lname as lastn, fname as firstn, length, width, length * width as resultSetMapping="compositekey")
})

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

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

Hibernate 独有的注解扩展

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

实体

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

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


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

 


• dynamicUpdate: allow dynamic SQL for updates   用动态SQL更新

 


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


• polymorphism: whether the entity polymorphism is of PolymorphismType.IMPLICIT (default) or PolymorphismType.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 long getObjectVolume()

索引

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

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

辨别符

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


本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/remote_roamer/archive/2008/10/22/3124731.aspx

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

注解的力量 -----Spring 2.5 JPA hibernate 使用方法的点滴整理(六) 的相关文章

随机推荐

  • 如何将小程序放到公众号菜单?

    第一步 公众号关联小程序 注 小程序要放到公众号菜单需要先把小程序与公众号关联 如果已经关联了可以直接下一步操作 1 到微信公众平台 登录小程序账号 进入设置 gt 开发设置 即可得到小程序AppID 将其复制下来 获取小程序AppID 2
  • chinaUnix中的linux源代码学习

    原文地址 http bbs chinaunix net thread 1930079 1 1 html 大家好 内核源码版对本版块的精华帖进行了分类汇总 所有的精华帖分为十大类 各个分类的精华帖相关信息分布在该贴2 11楼 每个分类各占1楼
  • AXI总线学习小结

    1 AXI总线结构 AXI总线由5个通道构成 通道名称 通道功能 数据流向 read address 读地址通道 主机 gt 从机 read data 读数据通道 包括数据通道和读响应通道 从机 gt 主机 write address 写地
  • SQL中的连接

    一 表连接 SQL提供了多种类型的连接方式 它们之间的区别在于 从相互交叠的不同数据集合中选择用于连接的行时所采用的方法不同 连接类型 定义 内连接 只连接匹配的行 左外连接 包含左边表的全部行 不管右边的表中是否存在与它们匹配 的行 以及
  • 个人网站搭建 01——Linux 安装宝塔面板

    宝塔面板概念 官网 https www bt cn new index html 安全高效的服务器运维面板 使用宝塔前 手工输入命令安装各类软件 操作起来费时费力并且容易出错 而且需要记住很多 Linux 的命令 非常复杂 使用宝塔后 2
  • python cv实现二值化区域检测

    功能 检测图像中最大的矩形区域 代码实现 import cv2 import numpy as np imgpath test1 jpeg img cv2 imread imgpath gray cv2 cvtColor img cv2 C
  • maven创建自定义web工程模板

    一 先搭建好一个项目模板 这里推荐两种方式 更推荐第一种 第一种 maven创建web工程 使用模板方式 二 第二种 maven创建web工程不用模板 手动创建 一 注意每个文件夹下都放一个文件占位 否则创建模板时会认为是空目录不进行创建
  • 5分钟了解AI算法 之 隐式马尔可夫模型(Hidden Markov Model)

    一 隐式马尔可夫模型 简介 Hidden Markov Model 在之前的文章中已经介绍了马尔可夫链 马尔可夫模型与马尔可夫链的区别在于 隐马尔科夫模型多了一条不可见的时序状态 通过对该模型各参数的推导即可解决当前AI领域比较常见的三大基
  • 进程间通信(二)/共享内存

    前言 在前面的博文中分析了什么的进程间通信和进程间通信的方式之一 管道 匿名管道和命名管道 接下来分析第二种方式 共享内存 要实现进程间通信 其前提是让不同进程之间看到同一份资源 所谓共享内存 那就是不同进程之间 可以看到内存中同一块资源
  • Tigase开发笔记5:如何自定义插件 Plugin

    其他博客比较好的介绍推荐 http my oschina net greki blog 209726 1 定义一个插件 四种处理器插件接口 第一步 预处理 XMPPPreprocessorIfc 这是预处理器插件需要实现的接口 第二步 处理
  • Centos7扩容根分区(LVM+非LVM)

    Centos7扩容根分区 LVM 非LVM 为什么要扩容根分区 自然是系统空间不足 还有就是部署的时候只顾头不顾腚的操作 以及服务器每天都要产生大量日志 日益壮大的数据 等各种后期需求 学会扩容根分区是很有必要的 昨天踩的坑 今天把它们都记
  • gets函数,C语言gets函数详解

    gets函数 C语言gets函数详解 在前面从键盘输入字符串是使用 scanf 和 s 其实还有更简单的方法 即使用 gets 函数 该函数的原型为 include
  • chatgpt错误:Sorry, you have been blocked

    ChatGPT报错 Sorry You Have Been Blocked 解决办法 换个节点 就可以
  • VMware虚拟设置机映射本地文件夹

    背景 宿主机其是Windows 虚拟机中是linux 操作 先确认虚拟机是关闭状态 susppend时无法修改属性 再修改虚拟机属性 操作如下 Edit virtual machine settings 编辑 options 属性 Shar
  • App专项测试测试有哪些?

    App专项测试的话 包含但不限于 弱网测试 干扰测试 兼容性测试 电量测试 流量测试 稳定性测试 安全测试和环境相关测试 第一 兼容性测试 针对App通常会考虑这些方面 1 操作系统版本 包括Andoird版本 iOS版本 2 屏幕分辨率
  • 手写轨迹识别数字

    使用自定义模板实现了手写识别 目前实现了纯数字的识别 后续正在开发英文数字的识别 中文识别暂未有计划 使用方法 获取笔迹 笔迹字段为数组 每个对象有3个值 x 笔迹的x值 y 笔迹的y值 action 动作 包含3个动作 down落笔 up
  • Centos 7 VNC配置及黑屏原因 (图文教程)

    Centos 7 VNC配置或安装的教程很多 鱼龙混杂 这里写一篇经过实践证明的真理配置方法 以正视听 Centos 7 安装VNC非常简单 要比Ubuntu简单多了 因为Ubuntu默认Unity桌面不支持VNC 1 关闭防火墙 syst
  • 前端开发——微信小程序

    1 安装 微信开发者工具 使用的开发平台为 微信开发者工具 点击此处链接 依次点击 工具 gt 下载 gt 稳定版更新日志 找到适合的版本 进行下载安装 2 注册微信小程序 注册微信小程序 点击注册链接 注意注册的是 小程序 根据注册提示完
  • [VB.NET]曲线的绘制!!!

    曲线的绘制 第一 在实验时需要把实时采集到的数据绘制成曲线图 再者 在数据处理时 需要把数据库中的数据 就是刚才实时采集到的数据点 以曲线图的形式在picturebox上显示出来 并且还要打印 请高手进来指点指点吧
  • 注解的力量 -----Spring 2.5 JPA hibernate 使用方法的点滴整理(六)

    一 实体 Bean 每个持久化POJO类都是一个实体Bean 通过在类的定义中使用 Entity 注解来进行声明 声明实体Bean Entitypublic class Flight implements Serializable Long