表1：EJB 3.0常用元数据注释
| 注释 |
说明 |
注释元素 |
| @Entity |
注明一个实体bean类。 |
|
| @Table |
注明实体bean表。如果未指定@Table，表名与EJB名相同。 |
name, schema |
| @Id |
注明一个主要关键属性或字段。 |
|
| @Transient |
注明一个非持久性属性或字段。 |
|
| @Column |
为一个持久性实体bean属性注明一个映射栏。 |
Name、primaryKey、nullable、length。默认栏名为属性或字段名。 |
| @NamedQueries |
注明一组命名查询。 |
|
| @NamedQuery |
注明一个命名查询或与查找方法相关的查询。 |
name, queryString |
| @OneToMany |
注明一个一对多联系。 |
Cascade |
| @OneToOne |
注明一个一对一联系。 |
Cascade |
| @ManyToMany |
注明一个多对多联系。 |
Cascade |
| @ManyToOne |
注明一个多对一联系。 |
Cascade |
EJB 2.1 bean类中的查找方法findByTitle()，在EJB 3.0中则使用相应的@namedQuery注释；EJB 2.1实体bean中的CMR关系，在EJB 3.0实体bean中则使用@OnetoMany注释。注释@Id注明了标识符属性标题，注释@Column指定了与标识符属性标题对应的数据库栏。如果一个持久性实体bean属性未用@Column注明，那EJB服务器会假定栏名与实体bean属性名相同。而瞬态实体bean属性通常用@Transient来注明。
迁移EJB实体Bean客户端
你可在实体bean主接口或本地主接口中使用create()方法，来创建一个EJB 2.1实体bean主对象或本地主对象。通常，一个EJB 2.1实体bean的客户端可通过JNDI查找来获取一个实体bean的本地或远程对象。下面有一段示例代码，其创建了一个EJB 2.1实体bean的本地主对象。
InitialContext ctx=new InitialContext();
Object objref=ctx.lookup("BookCatalogLocalHome");
BookCatalogLocalHome catalogLocalHome = (BookCatalogLocalHome)objref;
在上面的代码段中，BookCatalogLocalHome是BookCatalogBean实体bean的JNDI名。
在得到一个引用之后，EJB 2.1的客户端通过create()方法创建了一个本地对象。
BookCatalogLocal catalogLocal = (BookCatalogLocal)
catalogLocalHome.create(title);
在EJB 2.1中，可通过查找方法，从一个本地主对象中取得一个本地或远程对象。例如，你可像如下所示通过findByPrimaryKey方法取得一个本地对象。
BookCatalogLocal catalogLocal = (BookCatalogLocal)
catalogLocalHome.findByPrimaryKey(title);
另外在EJB 2.1中，可使用remove()方法移除一个实体bean的实例：
catalogLocal.remove();
EJB 3.0通过
javax.persistence.EntityManager类实现了持久性、查找和移除。表2列出了EntityManager类中用于取代EJB 2.1方法的一些常用方法。
表2：EntityManager类方法
| EntityManager方法 |
描述 |
| persist(Object entity) |
使一个实体bean实例持久化。 |
| createNamedQuery(String name) |
创建一个Query对象的实例，以执行命名查询。 |
| find(Class entityClass, Object primaryKey) |
查找一个实体bean实例。 |
| createQuery(String ejbQl) |
创建一个Query对象，以运行EJBQL查询。 |
| remove(Object entity) |
移除实体bean的一个实例。 |
在EJB 3.0实体bean的客户类中，可使用@Resource注释来注入EntityManager对象。
@Resource
private EntityManager em;
可调用EntityManager.persist()方法来使一个实体bean的实例持久化，例如：
BookCatalogBean catalogBean = new BookCatalogBean (title);
em.persist(catalogBean);
类似地，可调用EntityManager.find()方法来取得一个实体bean的实例。
BookCatalogBean catalogBean = (BookCatalogBean)
em.find("BookCatalogBean", title);
在此还可以定义一个相当于命名查询findByTitle的EJB 3.0客户类查找方法（与EJB 2.1中的查找方法可不一样），用createNamedQuery(String)方法取得一个Query对象。
Query query=em.createNamedQuery("findByTitle");
通过setParameter(int paramPosition, String paramValue)或setParameter(String parameterName, String value)方法设置Query对象的参数，注意此处的参数位置是从0开始的。
query.setParameter(0, title);
使用Query.getResultList()方法取得BookCatalogBean对象的一个集合，如果确定查询只返回一个单一的结果，还可以使用getSingleResult()方法代替。
java.util.Collection catalogBeanCollection = (BookCatalogBean)query.getResultList();
最后，用EntityManager.remove(Object entity)方法移除实体bean的实例。
BookCatalogBean catalogBean;
em.remove(catalogBean);
例4演示了一个完整的EJB 3.0实体bean的无状态会话bean客户类。
例4：BookCatalogClient类
import
javax.ejb.Stateless;
import
javax.ejb.Resource;
import
javax.persistence.EntityManager;
import
javax.persistence.Query;
@Stateless
@Local
public class BookCatalogClient implements BookCatalogLocal
{
@Resource
private EntityManager em;
public void create(String title)
{
BookCatalogBean catalogBean=new BookCatalogBean(title);
em.persist(catalogBean);
}
public BookCatalogBean findByPrimaryKey(String title)
{
return (BookCatalogBean)em.find("BookCatalogBean", title);
}
public
java.util.Collection findByTitle(String title)
{
Query query=em.createNamedQuery("findByTitle");
query.setParameter(0, title);
return (BookCatalogBean)query.getResultList();
}
public void remove(BookCatalogBean catalogBean)
{
em.remove(catalogBean);
}
}
以上的示例演示了如何把一个会话bean和实体bean从EJB 2.1迁移到EJB 3.0，从EJB 2.0迁移的情况也与此类似。
在本文完稿时，已有一些应用服务器支持EJB 3.0规范，如JBoss应用服务器、Oracle应用服务器及Caucho应用服务器。不幸的是，这些应用服务器对EJB 3.0的实现会有所不同----它们可能没有实现全部的EJB 3.0特性，所以，在开始编写程序之前，一定要仔细阅读相关应用服务器提供的文档说明。
