EJB3 and Hibernate3 Annotations 学习笔记（二）

上一篇说到了如何对Hibernate进行设置和初始化，加下来就是如何使用Annotations映射了。

首先介绍EJB3的映射

Annotations位于javax.persistence.*包内。先看看如何声明一个Entity Bean。

@Entity
public class Flight implements Serializable {
    Long id;

    @Id
    public Long getId() { return id; }

    public setId(Long id) { this.id = id; }
}

一个完整的例子参考 Flight.java
@entity声明了这个类是一个Entity Bean（同时这个类是个普通的POJO）
@Id声明了这个类的标识符，其它映射声明都隐含了

@entity允许你定义一个Entity Bean是否可以通过getters/setters方法访问，或者说是否可以直接访问他的成员变量。

@Entity(access = AccessType.PROPERTY)
  or
@Entity(access = AccessType.FIELD)

下面看看如何定义与数据库表的映射

@Entity(access=AccessType.FIELD)
@Table(name="tbl_sky")
public class Sky implements Serializable {
...
完整的例子看 Sky.java

你可以定义乐观锁机制使用@Version

@Entity()
public class Flight implements Serializable {
...
    @Version
    @Column(name="OPTLOCK")
    public Integer getVersion() { ... }
}
映射简单属性
@Transient
String getLengthInMeter() { ... }

String getName() {... } // persistent property

@Basic
int getLength() { ... } // persistent property

@Basic(fetch = FetchType.LAZY)
String getDetailedComment() { ... }

@Transient标示的lengthInMeter属性将被entity manager忽略。
detailedComment将实行懒加载。

凡标识@Serialized的属性将被序列化。@Lob标识了存储对象可能是个CLOB或者BLOB。
	@Serialized
	public Country getCountry() {
		...
	}

	@Lob(type=LobType.CLOB)
	public String getFullText() {
		return fullText;
	}

	@Lob(type = LobType.BLOB)
	public byte[] getFullCode() {
		return fullCode;
	}

定义列属性

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

内嵌对象（组件）

@Entity(access = AccessType.FIELD)
public class Person implements Serializable {

    // Persistent component using defaults
    Address homeAddress;

    @Embedded({
            @AttributeOverride(name="iso2", column = @Column(name="bornIso2") ),
            @AttributeOverride(name="name", column = @Column(name="bornCountryName") )
            })
    Country bornIn;
    ...
}

@Embeddable(access = AccessType.FIELD)
public class Address implements Serializable {
    String city;
    Country nationality;
}

@Embeddable
public class Country implements Serializable {
    private String iso2;
    private String name;

    public String getIso2() { return iso2; }
    public void setIso2(String iso2) { this.iso2 = iso2; }

    @Column(name="countryName")
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    ...
}
映射标识符
@Id(generate=GeneratorType.SEQUENCE, generator="SEQ_STORE")
public Integer getId() { ... }

@Id(generate=GeneratorType.IDENTITY)
public Integer getId() { ... }

自定义的主键生成策略

@javax.persistence.GeneratedIdTable(
	name="GEN_TABLE",
	table = @Table(name="GENERATOR_TABLE"),
	pkColumnName = "key",
	valueColumnName = "hi"
)

@javax.persistence.TableGenerator(
    name="EMP_GEN",
    tableName="GEN_TABLE",
    pkColumnValue="EMP",
    allocationSize=20
)
@javax.persistence.SequenceGenerator(
    name="SEQ_GEN",
    sequenceName="my_sequence"
)
package org.hibernate.test.metadata;

（未完待续）