服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > JAVA > 新手入门 > 基础入门 > 查看文档

ejb 3.0开发指南之实体bean的设计


  在ejb3.0中开发实体bean非常简单,你可以象开发一般的java bean一样编程,只需做少量的注释。一个实体bean不需要实现home接口或者remote、local接口。
  
  实体bean通过entitymanager产生、查找、和持久层结合、从持久层收回等操作。
  
  jboss的ejb3.0架构在hibernate之上。
  
  注释:
  
  @entity:如果你要建立一个实体bean的类,你必须在类上加上这个注释,用来告诉容器这个类是实体bean。这个bean的主键由@id指定。
  
  这个注释的声明如下:
  
  @target(type) @retention(runtime)
  
  public @interface entity {
  
  string name() default "";
  
  entitytype entitytype() default cmp;
  
  accesstype access() default property;
  
  int version() default 3;
  
  }
  
  name用来指定实体bean的名称,缺省和类名相同。
  
  entitytype用来指定此bean是容器管理的持久实体bean还是bean管理的持久实体bean。可以是cmp和bmp两种方式。
  
  accesstype用来指定容器访问此ejb的持久化数据的方式。property用来告诉容器使用get/set访问持久化的数据(就是无transient注释的数据),filed告诉容器直接访问字段,字段应该声明称protected类型。
  
  为了提供给其他会话bean等客户端使用,这个bean应实现serializable接口。
  
  实体bean必须由一个无参数的构造方法。
  
  可持久化的属性包括:java的基本类型(int,long等)、string、biginteger、bigdecimal、java.util.date、calendar、java.sql.date、java.sql.time、java.sql.timestamp、byte[]、char[]、其他实体bean类型、其他实体bean的集合(collection、set,不支持list)。
  
  @table
  
  用来指定此实体bean使用的主表,有时候可能需要其他的表,参看后面的章节的介绍。uniqueconstraint注释用来添加约束条件。
  
  @id
  
  用来指定此实体bean的主键。它可以有多种生成方式:
  
  table:容器指定用底层的数据表确保唯一。
  
  sequence:使用数据库的sequence列来保证唯一
  
  identity:使用数据库的indentit列来保证唯一
  
  auto:由容器挑选一个合适的方式来保证唯一
  
  none:容器不负责主键的生成,由调用程序来完成。
  
  @onetomany
  
  两个实体bean之间可能有一对多、多对一、一对一、多对多的关系,后面两个关系在后面的例子中介绍。
  
  比如学生和各课分数之间就是一对多的关系。
  
  在ejb3.0中,一对多的关联必须是双向的,也就是说,必定有各多对一的关联和它对应。
  
  onetomany注释声明如下:
  
  @target({method, field}) @retention(runtime)
  
  public @interface onetomany {
  
  string targetentity() default "";
  
  cascadetype[] cascade() default {};
  
  fetchtype fetch() default lazy;
  
  }
  
  当我们使用这个注释为get方法注释时,如果使用jdk5.0的通用编程,返回集合collection<目标实体类型>,那么就不需要指定targetentity的类型,否则返回类型声明为普通的collection的话,就必须声明targetentity的类型。
  
  cascadetype指定了当这个实体bean新建或者merge的时候,与之关联的实体需要怎样的处理:
  
  merge:当主实体bean被merge的时候、关联的实体bean也被merge
  
  create:当主实体bean被create的时候、关联的实体bean也被create
  
  remove:当主实体bean被evict的时候、关联的实体bean也被evict
  
  all:包括以上的情况
  
  fetchtype指定从数据中读取的方式:lazy还是eager。lazy只有当第一次访问的时候,才从数据库中得到相关的实体bean,eager则很积极,同主实体bean一同产生。
  
  @manytoone
  
  我们知道一对多的关联是双向的。在关联的实体bean中必定声明了由manytoone注释的方法。
  
  @joincolumn
  
  我们知道两个实体可以关联,但对应到table中需要指定一个列作为外键。假如不指定name,那么认为主表中的列和附表中的主键有相同名称的作为外键。如果不指定referencedcolumnname,则认为外键对应副表的主键。
  
  @joincolumns
  
  用来指示符合主键,在后面的章节中介绍。
  
  这个例子主要有以下几个文件,这个例子主要实现了管理学生分数的功能。student是一个实体bean,管理学生的基本信息(姓名和各课分数),其中学生的分数又是一个实体bean。tacherbean是一个无状态的会话bean,用来调用实体bean。和前面的例子一样,我们还是使用client测试。
  
  student.java:实体bean。
  
  score.java:实体bean。
  
  teacher.java:会话bean的业务接口
  
  teacherbean.java:会话bean的实现类
  
  client.java:测试ejb的客户端类。
  
  jndi.properties:jndi属性文件,提供访问jdni的基本配置属性。
  
  build.xml:ant 配置文件,用以编译、发布、测试、清除ejb。
  
  下面针对每个文件的内容做一个介绍。
  
  student.java
  
  package com.kuaff.ejb3.entity;
  
  import javax.ejb.cascadetype;
  import javax.ejb.entity;
  import javax.ejb.fetchtype;
  import javax.ejb.generatortype;
  import javax.ejb.id;
  import javax.ejb.joincolumn;
  import javax.ejb.onetomany;
  import javax.ejb.table;
  import java.util.arraylist;
  import java.util.collection;
  import java.io.serializable;
  
  @entity
  @table(name = "student")
  
  public class student implements serializable
  {
  //主键
  private int id;
  //学生名
  private string name;
  //学生的分数
  private collection<score> scores;
  //主键自动产生
  @id(generate = generatortype.auto)
  public int getid()
  {
  return id;
  }
  
  public void setid(int id)
  {
  this.id = id;
  }
  
  public string getname()
  {
  return name;
  }
  
  public void setname(string name)
  {
  this.name = name;
  }
  
  public void addscores(string name,int number)
  {
  if (scores == null)
  {
  scores = new arraylist<score>();
  }
  score score = new score();
  score.setname(name);
  score.setnumber(number);
  score.setstudent(this);
  scores.add(score);
  }
  
  @onetomany(cascade = cascadetype.all, fetch = fetchtype.eager)
  @joincolumn(name = "student_id")
  
  public collection<score> getscores()
  {
  return scores;
  }
  
  public void setscores(collection<score> scores)
  {
  this.scores = scores;
  }
  }
  
  student.java实现了student实体bean,它提供学生的基本情况以及学生的得分情况,得分是另外一个实体bean。student实体bean和score实体bean是一对多的关系,站在score的角度看是多对一的关系。
  
  实体bean需要使用@entity做注释,另外它指定这个实体bean与表student对应(通过注释@table(name = "student")),你可以在jboss的数据库中看到这个表。
  
  score.java
  
  package com.kuaff.ejb3.entity;
  
  import java.io.serializable;
  import javax.ejb.entity;
  import javax.ejb.generatortype;
  import javax.ejb.id;
  import javax.ejb.joincolumn;
  import javax.ejb.manytoone;
  import javax.ejb.table;
  
  @entity
  @table(name = "score")
  
  public class score implements serializable
  {
  private int id;
  private string name;
  private int number;
  private student student;
  
  //主键自动产生
  
  @id(generate = generatortype.auto)
  
  public int getid()
  {
  return id;
  }
  
  public void setid(int id)
  {
  this.id = id;
  }
  
  public string getname()
  {
  return name;
  }
  public void setname(string name)
  {
  this.name = name;
  }
  
  public int getnumber()
  {
  return number;
  }
  
  public void setnumber(int number)
  {
  this.number = number;
  }
  
  @manytoone
  @joincolumn(name = "student_id")
  
  public student getstudent()
  {
  return student;
  }
  
  public void setstudent(student student)
  {
  this.student = student;
  }