Java EE 5.0 实战教程 第二部分：JPA Entity编程（域建模）

Java EE 5.0 实战教程 第二部分：JPA Entity编程（域建模）

 

2008-06-18 10:40:02

查看( 8 ) / 评论( 0 )

域建模是每个面向对象应用程序的核心，就像人的骨骼，如果骨骼都没有，什么界面呀，数据呀都无处可靠。在JPA之前，Java EE程序需要一套域建模，还需要一套类似的Entity Bean来处理Persistence，因为Entity Bean是和EJB容器相关的，不能运用在容器之外，这样就产生了重复，而重复是程序维护的恶梦，每一个改变都需要做多处的修改，一个不小心少改了一个地方就会产生莫名其妙的错误。JPA的出现使这个问题得到解决，JPA里的Entity可以和Persistence Context剥离从而可以象普通的Java类一样使用，详见讲稿Java Persistence API。

 

1. 根据以下的类图建立域建模，这的模型做了简化，目的是演示Java EE 5.0的开发，若需要更多的功能，读者可根据自己的需要进一步丰富数据模型。

1. Stock.java. 注意Stock.java是一个POJO，也就是最普通的Java类，通过加入@Entity注解使其变成了JPA的Entity。详见Java Persistence API教程。

package entities;   import javax.persistence.Entity; import javax.persistence.Id;   @Entity public class Stock implements java.io.Serializable {         @Id private String stockCode;     private String stockName;         /** Creates a new instance of Stock */     public Stock() {     }       public String getStockCode() {         return stockCode;     }       public void setStockCode(String stockCode) {         this.stockCode = stockCode;     }       public String getStockName() {         return stockName;     }       public void setStockName(String stockName) {         this.stockName = stockName;     }     }

 

1. Trade.java. 注意Trade类应用了@ManyToOne注解来确定和别的Entity的关系。详见详见Java Persistence API教程。

package entities;   import java.util.Date; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.ManyToOne; import javax.persistence.Temporal; import javax.persistence.TemporalType;   @Entity() public class Trade implements java.io.Serializable {       @Id     @GeneratedValue(strategy=GenerationType.AUTO)     private Long id;     @ManyToOne     private Stock stock;     private long shareNum;     private double price;     @ManyToOne     private TradeType type;         /** Creates a new instance of Trade */     public Trade() {     }       public Long getId() {         return id;     }       public void setId(Long id) {         this.id = id;     }       public Stock getStock() {         return stock;     }       public void setStock(Stock stock) {         this.stock = stock;     }       public long getShareNum() {         return shareNum;     }       public void setShareNum(long shareNum) {         this.shareNum = shareNum;     }       public double getPrice() {         return price;     }       public void setPrice(double price) {         this.price = price;     }         public TradeType getType() {         return type;     }       public void setType(TradeType type) {         this.type = type;     }     }

 

1. Holding.java.

package entities;   import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.OneToOne;   @Entity() public class Holding implements java.io.Serializable {       @Id     @GeneratedValue(strategy=GenerationType.AUTO)     private Long id;         @OneToOne     private  Stock stock;     private long shareNum;     private double averageCost;         /** Creates a new instance of Holding */     public Holding() {     }       public Long getId() {         return id;     }       public void setId(Long id) {         this.id = id;     }       public Stock getStock() {         return stock;     }       public void setStock(Stock stock) {         this.stock = stock;     }       public long getShareNum() {         return shareNum;     }       public void setShareNum(long shareNum) {         this.shareNum = shareNum;     }       public double getAverageCost() {         return averageCost;     }       public void setAverageCost(double averageCost) {         this.averageCost = averageCost;     }     }

 

1. TradeType.java.

package entities;   import javax.persistence.Entity; import javax.persistence.Id;   @Entity() public class TradeType implements java.io.Serializable {         @Id     private int typeCode;         private String description;         public TradeType() {     }     public TradeType(int code) {         this.typeCode = code;     }        public TradeType(int code, String description){         this.setTypeCode(code);         this.setDescription(description);     }         public static TradeType BUY = new TradeType(1, "Buy");     public static TradeType SELL = new TradeType(2, "Sell");         public int getTypeCode() {         return typeCode;     }         public void setTypeCode(int typeCode) {         this.typeCode = typeCode;     }         public String getDescription() {         return description;     }         public void setDescription(String description) {         this.description = description;     }       public boolean equals(Object obj) {         if(!(obj instanceof TradeType)){             return false;         }         TradeType theType = (TradeType) obj;         if(theType.getTypeCode() == getTypeCode()){             return true;         } else {             return false;         }     }   }

 

1. 读者可用拷贝的方式将这四个java类拷到NetBeans里。也可自己输入，NetBeans提供了丰富的编辑功能，象代码自动完成，实体模板及字段封装可帮助你快速地输入源代码。

 

1. 建立持久性单元。持久性单元是JPA运行环境和物理数据库的连接，一旦指定了持久性单元，JPA运行环境就会自动地在指定的数据库里存储和提取数据。详见Java Persistence API教程。在创建持久性单元时，NetBeans还提供了一个工具，可方便地根据Entities来生成数据库表格，见c

 

1.  

   1. 右键“StockApp-ejb”,选“新建”－“文件/文件夹…”

 

1.  

   1. 在对话框里选“持久性”， “持久性单元”，点击“下一步”。

 

1.  

   1. 在“数据源”一项填入 jdbc/stockDS（注意大小写，和前面必须一致）, 并选择“创建”，然后点击“完成”。NetBeans提供了三种表生成策略：

      1. 创建：在部署项目时生成和Entity对印的数据表格

      2. 删除并创建：部署项目时生成表格，并在取消项目部署时删除表格 ，这个选项在开发初期，数据结构改动较多时特别有用。

      3. 无：不进行表格生成的操作。

 

1. 建立一个会话Bean。这个会话Bean暂时不用，但必须存在，否则下一步部署项目时会出错。

 

1. 部署项目。右键“StockApp”，选择“部署项目”。

 

1. NetBeans自动部署项目完成后，切换到“运行环境”，展开“数据库”，连接上“…./stockDB”（用户名/密码: stock/stock, 还记得第一部分准备的数据库吗？），打开“表”目录，可看到四个表：Stock, Trade, Holding和TradeType，这是NetBeans根据之前定义的Entities自动生成的。

 

1. 接下来需要在TRADETYPE表里加入两个常量，可通过NetBeans的数据库工具来完成。

   1. 右键“TRADETYPE”，选择“执行命令…”.

 

1.  

   1. 在打开的“SQL 命令1”窗口里敲入以下命令，并按执行。

insert into tradetype values(1, 'Buy');   insert into tradetype values(2, 'Sell');

 

1.  

   1. 在输出框里，可看见以下输出

在 0.062 秒内成功执行，但 1 行受到影响。 第 1 行，第 1 列   在 0 秒内成功执行，但 1 行受到影响。 第 3 行，第 1 列   0.062 秒后执行完毕，出现 0 个错误。

 

1. 至此，Entity编程完毕，下面我们就可以用这些Entity来编写业务逻辑和页面了。

 

附录

有人会问了，你在这部分里介绍的是先编好JPA Entity然后再根据Entity生成数据库表格，如果我的项目不是新项目，只能使用已有的数据库表格，怎么办呢？别急，NetBeans提供了一个工具，可以根据数据库表格逆向生成JPA Entities。具体做法如下：

1. 新建一个项目，常规或企业项目均可。

2. 右键此项目，选择”新建”－“文件/文件夹…”

 

1. 在对话框里选择“持久性” ，“通过数据库生成实体类”，然后“下一步”

 

1. 选择你要操作的数据库连接，NetBeans会根据数据库连接提取出可用表，你可全选可用表或者是部分你感兴趣的表，然后“下一步”

 

1. NetBeans会根据表的名称自动给出实体类名，你可以根据需要做修改。然后指定类生成的位置和包。NetBeans还给一个机会让你创建持久性单元。最后点“完成”，NetBeans就会自动生成实体类。

 

1. 生成的Trade.java的例子。看起来比我们自己编的还好，连NamedQuery都给做好了，注解的运用也规范多了。

…….   @Entity @Table(name = "TRADE") @NamedQueries( {         @NamedQuery(name = "Trade.findById", query = "SELECT t FROM Trade t WHERE t.id = :id"),         @NamedQuery(name = "Trade.findByPrice", query = "SELECT t FROM Trade t WHERE t.price = :price"),         @NamedQuery(name = "Trade.findByTradingdate", query = "SELECT t FROM Trade t WHERE t.tradingdate = :tradingdate"),         @NamedQuery(name = "Trade.findBySharenum", query = "SELECT t FROM Trade t WHERE t.sharenum = :sharenum")     }) public class Trade implements Serializable {       @Id     @Column(name = "ID", nullable = false)     private BigInteger id;       @Column(name = "PRICE")     private Double price;       @Column(name = "TRADINGDATE")     @Temporal(TemporalType.DATE)     private Date tradingdate;       @Column(name = "SHARENUM")     private BigInteger sharenum;       @JoinColumn(name = "STOCK_STOCKCODE", referencedColumnName = "STOCKCODE")     @ManyToOne     private Stock stockStockcode;       @JoinColumn(name = "TYPE_TYPECODE", referencedColumnName = "TYPECODE")     @ManyToOne     private Tradetype typeTypecode;     …….