注解annotation

1.hibernate注解

声明实体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 注解定义了一对一的关联关系。

 

 

多对一

 

使用 @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 { ... }

 

过滤 查询 ...

 

 

 

 

 

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

 

@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 属性值。

 

转自：http://z466459262.iteye.com/blog/714554

 

2.SpringMVC注解

SpringMVC是一个基于DispatcherServlet的MVC框架，每一个请求最先访问的都是DispatcherServlet，DispatcherServlet负责转发每一个Request请求给相应的Handler，Handler处理以后再返回相应的视图(View)和模型(Model)，返回的视图和模型都可以不指定，即可以只返回Model或只返回View或都不返回。在使用注解的SpringMVC中，处理器Handler是基于@Controller和@RequestMapping这两个注解的，@Controller声明一个处理器类，@RequestMapping声明对应请求的映射关系，这样就可以提供一个非常灵活的匹配和处理方式。

 

DispatcherServlet是继承自HttpServlet的，既然SpringMVC是基于DispatcherServlet的，那么我们先来配置一下DispatcherServlet，好让它能够管理我们希望它管理的内容。HttpServlet是在web.xml文件中声明的。

 

<servlet>
    <servlet-name>blog</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>blog</servlet-name>
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

 

 上面声明了一个名为blog的DispatcherServlet，该Servlet将处理所有以“.do”结尾的请求。在初始化DispatcherServlet的时候，SpringMVC默认会到/WEB-INF目录下寻找一个叫[servlet-name]-servlet.xml的配置文件，来初始化里面的bean对象，该文件中对应的bean对象会覆盖spring配置文件中声明的同名的bean对象。如上面的就会在/WEB-INF目录下寻找一个叫blog-servlet.xml的文件；当然也可以在Servlet中声明配置文件的位置，那就是通过Servlet的初始化参数来设置contextConfigLocation参数的值。

 

<servlet>
    <servlet-name>blog</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/blog-servlet.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>blog</servlet-name>
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

 

 DispatcherServlet会利用一些特殊的bean来处理Request请求和生成相应的视图返回。

 

关于视图的返回，Controller只负责传回来一个值，然后到底返回的是什么视图，是由视图解析器控制的，在jsp中常用的视图解析器是InternalResourceViewResovler，它会要求一个前缀和一个后缀

 

<bean
    class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/" />
    <property name="suffix" value=".jsp" />
</bean>

 

在上述视图解析器中，如果Controller返回的是blog/index，那么通过视图解析器解析之后的视图就是/WEB-INF/blog/index.jsp。

 

要使用注解的SpringMVC需要在SpringMVC的配置文件中进行声明，具体方式为先引入mvc命名空间，然后利用<mvc:annotation-driven />进行声明。

 

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
    <span style="background-color: #00ff00;"><span style="color: #ff0000;">xmlns:mvc="http://www.springframework.org/schema/mvc"</span>
</span>

    xsi:schemaLocation="http://www.springframework.org/schema/beans
     http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
     http://www.springframework.org/schema/context
     http://www.springframework.org/schema/context/spring-context-3.0.xsd
    <span style="background-color: #00ff00; color: #ff0000;"> http://www.springframework.org/schema/mvc
     http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd"</span>

>
<mvc:annotation-driven />

</beans>

 

 

 

主要是说说Controller.

在SpringMVC中Controller不需要继承什么类，也不需要实现什么接口，一切使用了@Controller进行标记的类都是Controller

 

@Controller
public class BlogController {

}

 有了Controller之后，那么到底是怎样请求一个Controller具体的方法的呢，那是通过@RequestMapping来标记的，@RequestMapping可以标记在类上面，也可以标记在方法上，当方法上和类上都标记了@RequestMapping的时候，那么对应的方法对应的Url就是类上的加方法上的，如下面的index方法，其对应的URL应为类上的/blog加上index方法上的/index，所以应为/blog/index，所以当请求/blog/index.do的时候就会访问BlogController的index方法。加在类上的@RequestMapping不是必须的，当Controller类上加上了@RequestMapping的时候，那么Controller方法上的@RequestMapping就是相对于类上的@RequestMapping而言的，也就是前面说的请求映射的时候是类上的地址加方法上的地址，而当Controller类上没有加@RequestMapping的时候，方法上的@RequestMapping就是绝对路径了。

 

 

@Controller
@RequestMapping("/blog")
public class BlogController {

    @RequestMapping("/index")
    public String index(Map<String, Object> map) {
        return "blog/index";
    }
}

 

 在上面的代码中，如果index方法上没有RequestMapping注解，而只有BlogController类上有，且该类只有一个方法的时候，直接请求类上的URL就会调用里面的方法，即直接请求/blog.do的时候就会调用index方法。

在RequestMapping中还可以指定一个属性method，其主要对应的值有RequestMethod.GET和RequestMethod.POST，利用该属性可以严格的控制某一方法只能被标记的请求路径对应的请求方法才能访问，如指定method的值为GET，则表示只有通过GET方式才能访问该方法，默认是都可以访问。RequestMapping中的URL映射还支持通配符*，如：

@Controller
@RequestMapping("/blog")
public class BlogController {
    @RequestMapping("/*/index")
    public String index(Map<String, Object> map) {
        return "blog/index";
    }
}

 在@RequestMapping中还有一个属性params，可以通过该属性指定请求参数中必须包含某一参数，或必须不包含某一参数，或某参数的值必须是什么，以此来缩小指定的映射范围。

@Controller
@RequestMapping("/blog")
public class BlogController {

    @RequestMapping(value="/index", params="param1=value1")
    public String index(Map<String, Object> map) {
        return "blog/index";
    }
}

在上面示例中，只有当请求/blog/index.do并且请求参数param1的值为value1的时候才能访问到对应的index方法。如果params的值为"param1"，则表示请求参数只要包含param1就可以了，至于它的值是什么无所谓；如果params的值为"!param1"，则表示请求参数必须不包含param1才可以。@RequestMapping中还可以使用header来缩小映射范围，如：

@Controller
@RequestMapping("/blog")
public class BlogController {
    @RequestMapping(value="/index",headers="content-type=text/html")
    public String index(Map<String, Object> map) {
        return "blog/index";
    }
}

 

 

在SpringMVC中常用的注解还有@PathVariable，@RequestParam，@PathVariable标记在方法的参数上，利用它标记的参数可以利用请求路径传值，看下面一个例子

 

@RequestMapping(value="/comment/{blogId}", method=RequestMethod.POST)
public void comment(Comment comment,@PathVariable int blogId, HttpSession session, HttpServletResponse response) throws IOException {

}

 

在该例子中，blogId是被@PathVariable标记为请求路径变量的，如果请求的是/blog/comment/1.do的时候就表示blogId的值为1，@PathVariable在进行赋值的时候如果像上面那样没有指定后面接的变量是对应URL中的哪个变量时默认是从URL中取跟后面接的变量名相同的变量，如上面示例中的@PathVariable int blogId，没有指明要获取URL中的哪个变量，这个时候就默认取URL中的blogId变量对应的值赋给方法参数中的blogId，那如果方法参数的名称跟RequestMapping中定义的访问路径中的变量名不一样，或者我要利用PathVariable明确指定后面接的方法参数是对应于URL中的哪个变量时，可以像下面这样做，在PathVariable中给定一个value="blogId"(只有一个参数的时候value是可以省略的)值明确指定方法参数中的id变量是对应请求路径定义中的blogId变量的。

@RequestMapping(value="/comment/{blogId}", method=RequestMethod.POST)
public void comment(Comment comment,@PathVariable("blogId") int id, HttpSession session, HttpServletResponse response) throws IOException {

}

 

同样@RequestParam也是用来给参数传值的，但是它是从头request的参数里面取值，相当于request.getParameter("参数名")方法。它的取值规则跟@PathVariable是一样的，当没有指定的时候，默认是从request中取名称跟后面接的变量名同名的参数值，当要明确从request中取一个参数的时候使用@RequestParam("参数名")，如下所示：

@RequestMapping("/show")
public void showParam(@RequestParam int id, @RequestParam("name") String username) {
    //这样做进行URL请求访问这个方法的时候，就会先从request中获取参数id的值赋给参数变量id，从request中获取参数name的值赋给参数变量username
}

 

 

在Controller的方法中，如果需要WEB元素HttpServletRequest，HttpServletResponse和HttpSession，只需要在给方法一个对应的参数，那么在访问的时候SpringMVC就会自动给其传值，但是需要注意的是在传入Session的时候如果是第一次访问系统的时候就调用session会报错，因为这个时候session还没有生成。

 

接下来讨论一下方法的返回值，主要有以下情况：

 

• 返回一个ModelAndView，其中Model是一个Map，里面存放的是一对对的键值对，其可以直接在页面上使用，View是一个字符串，表示的是某一个View的名称
• 返回一个字符串，这个时候如果需要给页面传值，可以给方法一个Map参数，该Map就相当于一个Model，往该Model里面存入键值对就可以在页面上进行访问了
• 返回一个View对象
• 返回一个Model也就是一个Map，这个时候将解析默认生成的view name，默认情况view name就是方法名，这里之前搞错了，感谢网友的指正。默认的View Name是由RequestToViewNameTranslator来解析的，顾名思义就是把request翻译成viewName，在没有指定RequestToViewNameTranslator时，Spring将使用其自身的默认实现DefaultRequestToViewNameTranslator的默认配置，即取到当前请求的URI，去掉最前和最后的斜杠“/”，以及对应的后缀。所以当你请求“http://localhost/app/abc”的时候，对应的默认viewName就是请求URI——“/abc”去掉最前最后的斜杠和后缀之后的结果，即“abc”，请求“http://localhost/app/abc/efg”时对应的默认视图名称是“abc/efg”，“http://localhost/app/abc/efg/hi.html”——>“abc/efg/hi”。如果需要改变默认的视图名称的解析方式，可以在SpringMVC的配置文件中配置一个名称为viewNameTranslator，类型为RequestToViewNameTranslator的bean。如果该bean是DefaultRequestToViewNameTranslator，那么你可以通过prefix属性指定视图名称的前缀，通过suffix指定后缀，通过stripLeadingSlash指定是否需要去掉最前面的斜杠，更多可指定的属性请参考DefaultRequestToViewNameTranslator的实现。当然你也可以定义自己的RequestToViewNameTranslator实现类，实现RequestToViewNameTranslator接口的getViewName(HttpServletRequest request)方法，实现自己的获取默认视图名称的逻辑。
• 什么也不返回，这个时候可以在方法体中直接往HttpServletResponse写入返回内容，否则将会由RequestToViewNameTranslator来决定
• 任何其他类型的对象。这个时候就会把该方法返回类型对象当做返回Model模型的一个属性返回给视图使用，这个属性名称可以通过在方法上给定@ModelAttribute注解来指定，否则将默认使用该返回类名称作为属性名称。

下面是一个简单的实例

       @RequestMapping("/{owner}/index")
public String userIndex(Map<String, Object> map,@PathVariable String owner, HttpServletRequest request) throws ParserException {
    List<DefCategory> categories = categoryService.find(owner);
    int offset = Util.getOffset(request);
    Pager<Blog> pager = blogService.find(owner, 0, offset, maxResults);
    int totalRecords = pager.getTotalRecords();
    List<Blog> blogs = pager.getData();
    Util.shortBlog(blogs);

    List<Message> messages = messageService.find(owner, 0, 5).getData();
    Util.shortMessage(messages, 20);
    map.put("messages", messages);
    map.put("totalRecords", totalRecords);
    List<BlogStore> stores = storeService.find(owner, 0, 5).getData();
    map.put("maxResults", maxResults);
    map.put("blogs", blogs);
    map.put("totalRecords", totalRecords);
    map.put("owner", userService.find(owner));
    map.put("defCategories", categories);
    map.put("stores", stores);
    return "blog/userIndex";
}

  

给页面传值

    在Controller中把请求转发给业务逻辑层进行处理之后需要把业务逻辑层的处理结果进行展现，在展现的过程中就需要我们把处理结果传给展示层进行展示。那么处理结果是怎么进行传递的呢？前面已经说了Controller的返回结果可以是一个包含模型和视图的ModelAndView，也可以仅仅是一个视图View，当然也可以什么都不返回，还可以是仅仅返回一个Model。我们知道模型Model是用来封装数据给视图View进行展示的，那么，在SpringMVC中，如果要把我们后台的信息传递给前台进行展示的话应该怎么做呢？这主要有两种方式：
    1.返回包含模型Model的ModelAndView，或者是直接返回一个Model(这个时候就需要考虑默认的视图)，这种类型的返回结果是包含Model的，这个Model对象里面的对应属性列都可以直接在视图里面使用。
    2.如果是直接返回一个视图View，这个时候SpringMVC提供了一种类似于在Controller方法中获取HttpRequest对象的机制，这个时候我们只需要给定Controller方法一个Map参数，然后在方法体里面给这个Map加上需要传递到视图的键值对，这样在视图中就可以直接访问对应的键值对