1. EJB3 Annotation Types

AssociationOverride	Hibernate现在支持在嵌入式对象中使用关联注解(如@*ToOne和@*ToMany). 而EJB3规范尚不支持这样的用法。你可以使用 @AssociationOverride注解来覆写关联列.
AssociationOverrides
AttributeOverride	参照Embeddable
AttributeOverrides
Basic	l   所有没有定义注解的属性等价于在其上面添加了@Basic注解. l   通过 @Basic注解可以声明属性的获取策略(fetch strategy)。但需要借助类增强器对二进制Class文件进行强化处理	@Basic(fetch=FetchType.LAZY) private String info;
Column	使用 @Column 注解可将属性映射到列. 使用该注解来覆盖默认值	@Column(name="reqdate")
ColumnResult
DiscriminatorColumn	定义了辨别符列(还可以定义辨别符的类型).	@DiscriminatorColumn(name="type",discriminatorType=DiscriminatorType.STRING)
DiscriminatorValue	对于继承层次结构中的每个类,@DiscriminatorValue注解指定了用来辨别该类的值	@DiscriminatorValue("emp")
Embeddable	l   在实体中可以定义一个嵌入式组件(embedded component), 甚至覆盖该实体中原有的列映射. l   组件类必须在类一级定义@Embeddable注解. l   在特定的实体的关联属性上使用@Embedded和 @AttributeOverride注解可以覆盖该属性对应的嵌入式对象的列映射：
Embedded	参照Embeddable
EmbeddedId	定义组合主键	@Id @EmbeddedId UserPK pk;
Entity	将一个类声明为一个实体bean(即一个持久化POJO类)
EntityListeners
EntityResult
Enumerated	默认是保存枚举的序列值, 但是你可以通过@Enumerated注解来进行调整	@Enumerated(EnumType.STRING) private Gender gender;
ExcludeDefaultListeners
ExcludeSuperclassListeners
FieldResult
GeneratedValue	使用 @GeneratedValue注解可以定义该标识符的生成策略: AUTO - 可以是identity column类型,或者sequence类型或者table类型,取决于不同的底层数据库. TABLE - 使用表保存id值 IDENTITY - identity column SEQUENCE - sequence	@Id @GeneratedValue(strategy = GenerationType.AUTO) private int id; ======================================== @javax.persistence.TableGenerator(           name="MY_GEN",           table="GENERATOR_TABLE",           pkColumnName = "tablename",           valueColumnName = "hi",           pkColumnValue="dept",           allocationSize=10 ) @Id @GeneratedValue(strategy=GenerationType.TABLE,generator="MY_GEN") int id;
Id	声明了该实体bean的标识属性
IdClass	定义组合主键，将类注解为@IdClass,并将该实体中所有属于主键的属性都注解为@Id	@IdClass(UserPK.class) public class User {
Inheritance	继承映射。@Inheritance 和 @DiscriminatorColumn 注解只能用于实体层次结构的顶端.	l   第一种（每个类一张表） @Entity @Inheritance(strategy = InheritanceType.TABLE_PER_CLASS) public class Flight implements Serializable { l   第二种（每个类层次结构一张表） @Entity @Inheritance(strategy=InheritanceType.SINGLE_TABLE) @DiscriminatorColumn(     name="planetype",     discriminatorType=DiscriminatorType.STRING ) @DiscriminatorValue("Plane") public class Plane { ... } l   第三种（连接的子类） @Entity @Inheritance(strategy=InheritanceType.JOINED) public class Boat implements Serializable { ... }
JoinColumn	使用外键列进行实体的关联. 该注解和@Column注解有点类似, 但是多了一个名为referencedColumnName的参数。该参数定义了所关联目标实体中的联接列。注意,当referencedColumnName关联到非主键列的时候, 关联的目标类必须实现Serializable, 还要注意的是所映射的属性对应单个列(否则映射无效).	@ManyToOne(cascade = { CascadeType.ALL }, fetch = FetchType.LAZY) @JoinColumn(name = "dp_id") public Dept dept;
JoinColumns
JoinTable	通过关联表 对于多对一也可以通过关联表的方式来映射。	@ManyToOne(cascade={CascadeType.PERSIST})       @JoinTable(name="deptuser",             joinColumns=@JoinColumn(name="userid"),             inverseJoinColumns=@JoinColumn(name="deptid")       ) ===============================================
Lob	@Lob注解表示属性将被持久化为Blob或者Clob类型, 具体取决于属性的类型, java.sql.Clob, Character[], char[] 和 java.lang.String这些类型的属性都被持久化为Clob类型, 而java.sql.Blob, Byte[], byte[] 和 serializable类型则被持久化为Blob类型.
ManyToMany	你可以通过@ManyToMany注解可定义的多对多关联
ManyToOne	在实体属性一级使用@ManyToOne注解来定义多对一关联:	@ManyToOne(cascade={CascadeType.ALL},fetch=FetchType.LAZY) public Dept dept;
MapKey	EJB3 允许你利用目标实体的一个属性作为Map的key, 这个属性可以用@MapKey(name="myProperty")来声明.	@OneToMany(mappedBy = "dept", cascade = { CascadeType.ALL }, fetch =         FetchType.LAZY) @MapKey(name = "pk") private Map<Integer, User> users = new HashMap<Integer, User>();
MappedSuperclass	可以在嵌入式对象上添加 @MappedSuperclass注解, 这样可以将其父类的属性持久。 有时候通过一个(技术上或业务上)父类共享一些公共属性是很有用的, 同时还不用将该父类作为映射的实体(也就是该实体没有对应的表). 这个时候你需要使用@MappedSuperclass注解来进行映射.
NamedNativeQueries	映射本地化查询	@NamedNativeQueries(value = {             @NamedNativeQuery(name="getlistall", query="select * from user", resultSetMapping="myMapping")             ,@NamedNativeQuery(name="getlistone", query="select * from user where id=1", resultClass=com.bjsxt.hibernate.domain.User.class) })
NamedNativeQuery	映射本地化查询
NamedQueries	使用注解还可以映射EJBQL/HQL查询. @NamedQuery 和@NamedQueries是可使用在类和包上的注解.	@NamedQuery(name="getlistall",query="from User") @NamedQueries(value = { @NamedQuery(name="getlistall",query="from User") }) @NamedQueries(value = {             @NamedQuery(name="getlistall",query="from User")             ,@NamedQuery(name="getlistone",query="from User where id = :id") })
NamedQuery	参考NamedQueries
OneToMany	在属性级使用 @OneToMany注解可定义一对多关联
OneToOne	使用@OneToOne注解可以建立实体bean之间的一对一的关联.	一对一关联有三种情况： 一是关联的实体都共享同样的主键,       @OneToOne       @PrimaryKeyJoinColumn       private Heart heart; 二是其中一个实体通过外键关联到另一个实体的主键 (注意要模拟一对一关联必须在外键列上添加唯一约束).       @OneToOne(cascade = CascadeType.ALL)     @JoinColumn(name="passport_fk")       private Trousers trousers; 三是通过关联表来保存两个实体之间的连接关系 (注意要模拟一对一关联必须在每一个外键上添加唯一约束). 一对一关联可能是双向的.在双向关联中, 有且仅有一端是作为主体(owner)端存在的：主体端负责维护联接列(即更新). 对于不需要维护这种关系的从表则通过mappedBy属性进行声明. 如果在主体没有声明@JoinColumn,系统自动进行处理： 在主表(owner table)中将创建联接列, 列名为：主体的关联属性名＋下划线＋被关联端的主键列名.
OrderBy	对有序列表进行映射。该注解接受的参数格式：用逗号隔开的(目标实体)属性名及排序指令, 如firstname asc, age desc,如果该参数为空,则默认以id对该集合进行排序.
PersistenceContext
PersistenceContexts
PersistenceProperty
PersistenceUnit
PersistenceUnits
PostLoad
PostPersist
PostRemove
PostUpdate
PrePersist
PreRemove
PreUpdate
PrimaryKeyJoinColumn	l   当每个子类映射到一个表时, @PrimaryKeyJoinColumn 和@PrimaryKeyJoinColumns 注解定义了每个子类表关联到父类表的主键: l   通过共享主键来进行一对一关联映射	@OneToOne       @PrimaryKeyJoinColumn       private Heart heart; =============================== @Entity @PrimaryKeyJoinColumn(name="emp_id") public class HourlyEmp extends Emp{       int rate;
PrimaryKeyJoinColumns	参见PrimaryKeyJoinColumn
QueryHint		@javax.persistence.NamedQuery(name="findEmployeesInDept", query="select emp from Employee emp where emp.department = ?1", hints={@QueryHint(name="org.hibernate.cacheable",value="true")})
SecondaryTable	使用类一级的 @SecondaryTable 或 @SecondaryTables 注解可以实现单个实体到多个表的映射.
SecondaryTables	参见SecondaryTable
SequenceGenerator	定义了一个sequence 生成器，注意目前Hibernate Annotations还不支持sequence 生成器中的 initialValue和 allocationSize参数.
SqlResultSetMapping	你还可以映射本地化查询(也就是普通SQL查询). 不过这需要你使用@SqlResultSetMapping注解来描述SQL的resultset的结构	@SqlResultSetMapping(name="myMapping",entities={             @EntityResult(entityClass=com.bjsxt.hibernate.domain.User.class,fields={                   @FieldResult(name="id",column="id"),                   @FieldResult(name="name",column="name"),                   @FieldResult(name="info",column="info"),                   @FieldResult(name="password",column="password"),                   @FieldResult(name="username",column="username"),                   @FieldResult(name="dept",column="dept_id"),             }) })
SqlResultSetMappings	如果你打算定义多个结果集映射，可是使用@SqlResultSetMappings
Table	l   @Table是类一级的注解 l   通过@Table注解可以为实体bean映射指定表(table),目录(catalog)和schema的名字. l   如果没有定义@Table,那么系统自动使用默认值：实体的短类名(不附带包名).	@Entity @Table(name="tbl_user")
TableGenerator	标识符的生成策略的一种	@Entity @Inheritance(strategy=InheritanceType.TABLE_PER_CLASS) @javax.persistence.TableGenerator(     name="EMP_GEN",     table="GENERATOR_TABLE",     pkColumnName = "tablename",     valueColumnName = "hi",     pkColumnValue="EMP",     allocationSize=20 )
Temporal	在核心的Java API中并没有定义时间精度(temporal precision). 因此处理时间类型数据时,你还需要定义将其存储在数据库中所预期的精度. 在数据库中,表示时间类型的数据有DATE, TIME, 和 TIMESTAMP三种精度(即单纯的日期,时间,或者两者兼备). 可使用@Temporal注解来调整精度.	@Temporal(TemporalType.DATE) @Column(name="reqdate") private Date date;
Transient	实体bean中所有的非static非transient的属性都可以被持久化, 除非你将其注解为@Transient.	@Transient private String info;
UniqueConstraint	@Table结合使用@UniqueConstraint注解可以定义表的唯一约束(unique constraint) (对于绑定到单列的唯一约束,请参考@Column注解)
Version	你可以在实体bean中使用@Version注解,通过这种方式可添加对乐观锁定的支持: 根据EJB3规范,version列可以是numeric类型(推荐方式)也可以是timestamp类型. Hibernate支持任何自定义类型,只要该类型实现了UserVersionType.