Java Persistence AP(JPA)可以说是java持久化技术的一个集大成者,它吸取了Hiberante,JDO,TopLink等优秀技术和框架,将这几年发展成熟起来的基于POJO模型的O/R Mapping技术标准化,成为在J2EE和J2SE环境中通用的java持久化API。值得注意的是Java Persistence API并不是J2EE环境专用,而是在java中的通用API。意味着我们可以在任何需要访问关系数据库的地方使用JPA,甚至包括swing开发的桌面应用。JPA也不要求一定在J2EE容器中才能运行,而是任何有JVM的环境都可以运用。这就使得我们可以很容易的把JPA作为一个持久化组件自由地和各种容器/框架(EJB3容器, Spring等等)组合。
下面是我做的一个JPA 在 Java SE 环境下的使用范例.
一、搭建环境
1) 搭建数据库环境
1、安装数据库(MySQL 5.0.24), 用户: root,密码: (空) 。
2、建库piscesdb。
3、建表address:
create table address (
addressID int not null,
city varchar(55) not null,
street varchar(55) NOT NULL,
zip varchar(8) NOT NULL,
PRIMARY KEY (addressID)
);
insert into address values (1, "深圳", "坂田市场", "518001");
insert into address values (2, "深圳", "坂田路口", "518002");
insert into address values (3, "深圳", "四季花城", "518003");
4、建表userinfo:
userID int not null, /** 用户id */
username varchar(20) not null, /** 姓名 */
birthday datetime null, /** 出生日期 */
sex varchar(8) not null, /** 性别 */
addressID int not null, /** 地址id */
PRIMARY KEY (userID)
); insert into userinfo values (1, "张先生", null, "male", 1);
insert into userinfo values (2, "李某某", null, "male", 2);
insert into userinfo values (3, "王某某", '2006-08-10', "female", 3);
insert into userinfo values (4, "陈某某", '2006-08-12', "male", 3);
2) 获取额外的jar包
下载JPA的实现类, 去https://glassfish.dev.java.net/downloads/persistence/JavaPersistence.html下载GlassFish v1 FCS branch版本,
进行安装后得到toplink-essentials.jar,toplink-essentials-agent.jar 两个包,将这两个包和mysql的驱动包加入到项目的classpath路径中去。
编译toplink源码需要 javax.transaction、org.apache.tools.ant 两个包
项目工程路径不要含中文, 因为 toplink 暂时不支持。
3) 开发环境
JDK: jdk 6.0 beta2 (JDK 5.0 也可以)
IDE: NetBeans 5.0 中文版
二、开发
1) 创建实体Entity类
1、地址类 Address :
* Address.java
*/ package org.pisces.persist; import java.io.Serializable;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id; /**
*
* @author kamhung
*/
@Entity
public class Address implements Serializable {
//地址id, 不能为空, 必须唯一
@Id
@Column(name = "addressid", unique=true, nullable=false)
private int addressid;
//城市, 不能为空
@Column(name = "city", nullable=false)
private String city;
//街道, 不能为空
@Column(name = "street", nullable=false)
private String street;
//邮政编码, 不能为空
@Column(name = "zip", nullable=false)
private String zip;
public Address() {
}
public Address(int addressid) {
this.setAddressid(addressid);
}
public int getAddressid() {
return this.addressid;
}
public void setAddressid(int addressid) {
this.addressid = addressid;
}
public String getCity() {
return this.city;
}
public void setCity(String city) {
this.city = city;
}
public String getStreet() {
return street;
}
public void setStreet(String street) {
this.street = street;
}
public String getZip() {
return this.zip;
}
public void setZip(String zip) {
this.zip = zip;
}
@Override
public int hashCode() {
return this.addressid;
}
@Override
public boolean equals(Object object) {
if (!(object instanceof Address)) return false;
final Address other = (Address)object;
return this.addressid == other.addressid;
}
@Override
public String toString() {
return "Address[addressid=" + getAddressid() + ", city='" + getCity() + "', street='" + getStreet() + "', zip='" + getZip() +"']";
}
}
2、用户类 UserInfo:
* UserInfo2.java
*/ package org.pisces.persist; import java.io.Serializable;
import java.sql.Timestamp;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.JoinColumn;
import javax.persistence.OneToOne;
import static javax.persistence.CascadeType.*; /**
*
* @author kamhung
*/
@Entity
public class UserInfo implements Serializable {
//用户id, 不能为空, 必须唯一
@Id
@Column(name = "userid", unique=true, nullable=false)
private int userid;
//用户名, 不能为空
@Column(name = "userName", nullable=false)
private String userName;
//性别, 不能为空
@Column(name = "sex", nullable=false)
private String sex;
//出生日期, 可以为空
@Column(name = "birthday")
private Timestamp birthday;
//地址, 不能为空
//PERSIST 表示更新、新增UserInfo数据时会同时更新、新增Address的数据
//REMOVE 表示从数据库删除UserInfo会同时删除Address表中对应的数据
@OneToOne(cascade={PERSIST, REMOVE})
@JoinColumn(name = "addressID", nullable=false)
private Address address;
public UserInfo() {
}
public UserInfo(int userid) {
this.setUserid(userid);
}
@Override
public int hashCode() {
return this.getUserid();
}
@Override
public boolean equals(Object object) {
if (!(object instanceof UserInfo)) return false;
final UserInfo other = (UserInfo)object;
return this.userid == other.userid;
}
@Override
public String toString() {
return "UserInfo[userid=" + this.userid + ", userName='" + userName + "', sex='" + sex
+ "', birthday=" + birthday + ", address=" + address + "]";
}
public int getUserid() {
return userid;
}
public void setUserid(int userid) {
this.userid = userid;
}
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
public Timestamp getBirthday() {
return birthday;
}
public void setBirthday(Timestamp birthday) {
this.birthday = birthday;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public Address getAddress() {
return address;
}
public void setAddress(Address address) {
this.address = address;
}
}
2) 创建配置文件persistence.xml
在项目src文件夹下创建一个META-INF文件夹(有就不用创建了), META-INF文件夹下建一个persistence.xml文件, 内容为:
<persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">
<!-- transaction-type 可选值有: JTA、RESOURCE_LOCAL ;
在Java EE 环境下默认值为JTA, 在Java SE 环境下默认值为RESOURCE_LOCAL;
如果值为JTA的话, 则必须要指定<jta-data-source>的值 -->
<persistence-unit name="piscesPU" transaction-type="RESOURCE_LOCAL">
<description>这是piscesPU持久化单元的一个简单描述</description>
<!-- 指明javax.persistence.spi.PersistenceProvider 的实现类, 一般来说该节点可以省略 -->
<provider>oracle.toplink.essentials.ejb.cmp3.EntityManagerFactoryProvider</provider>
<!-- 在Java SE环境下必须定义所有的实体Entity类, 也可以用 <mapping-file> 或<jar-file> 节点代替 -->
<class>org.pisces.persist.UserInfo</class>
<class>org.pisces.persist.Address</class>
<!--
//可以定义jndi资源代替properties节点中的数据库配置,
//但是在调用Persistence.createEntityManagerFactory方法前必须保证此资源已经注入程序中.
<jta-data-source>jdbc/persist</jta-data-source>
-->
<!-- properties节点是用来定义各种JPA实现包所定义的属性配置 -->
<!-- 下面列举的是toplink实现包中可以配置的部分属性 -->
<properties>
<!-- 数据库连接配置, JDBC驱动 -->
<property name="toplink.jdbc.driver" value="com.mysql.jdbc.Driver"/>
<!-- 数据库连接配置,URL -->
<property name="toplink.jdbc.url" value="jdbc:mysql://localhost:3306/piscesdb"/>
<!-- 数据库连接配置, 用户名 -->
<property name="toplink.jdbc.user" value="root"/>
<!-- 数据库连接配置, 密码 -->
<property name="toplink.jdbc.password" value=""/>
<!-- 数据库连接池配置, 可写的连接池的最大连接数, 默认为 10 -->
<property name="toplink.jdbc.write-connections.max" value="10"/>
<!-- 数据库连接池配置, 可写的连