尽管如今开源的框架已经很是优秀,可是缺少统一的标准有违软件开源的初衷,所以Sun公司的JCP组织发布了Java EE的JPA标准,并统一ORM规则、JPQL查询语言、子查询、高级查询和批量处理等操做。推出JPA规范有两点缘由:一是,但愿简化现有的SE和EE工做,特别是EJB3.0的推出,使得企业级项目的开发推向更高的层次(EJB3.0已经很是优秀,可是因为时间的问题,而且Spring已经占领了市场);二是,但愿业界有一个统一的标准,就像当年JDBC推出同样,只实现接口,其他API的实现交给项目厂商或者组织去完成。 java
实际项目开发应该尽可能使用JPA的API编程,为何要这样作?JPA是一个规范,不是产品,最终实现交给Hibernate这些ORM框架去实现,即便之后咱们要改变ORM的底层,也只须要简单更改一下配置便可,JPA仍是属于javax.persistence.*的包里面,稍微有些不一样的是主键的生成策略不一样的ORM规范有所差别,但基本原理仍是同样。 mysql
下面将分hibernate实现和整合Spring实现两种案例说明JPA整合的好处。 spring
因为Spring、Hibernate和log4j的maven配置比较繁琐,这里只提供版本管理: sql
<properties> <!--Spring版本号--> <spring.version>4.0.5.RELEASE</spring.version> <!--hibernate--> <hibernate.version>4.3.0.Final</hibernate.version> <!--log4j日志文件管理包版本--> <slf4j.version>1.6.6</slf4j.version> <log4j.version>1.2.12</log4j.version> <!--项目编码级别--> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <!--spring jpa--> <spring-data-jpa.version>1.4.1.RELEASE</spring-data-jpa.version> <hibernate-jpa-api.version>1.0.1.Final</hibernate-jpa-api.version> </properties>
POJO实体 数据库
因为使用注解方式建立,所以本文将不建立orm.xml文件,而且JPA的注解也很是容易看懂,所以注解内容不作详述,下面建立一个用户实体对象,对应数据库中的表为t_user; 编程
import javax.persistence.*; import java.io.Serializable; /** * @author Barudisshu */ @Entity(name = "USER") @Table(name = "t_user",uniqueConstraints = {@UniqueConstraint(columnNames = {"username"})}) public class UserInfo implements Serializable{ @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; // 但愿用户名是惟一的 @Basic @Column(name = "username") private String username; @Basic @Column(name = "password") private String password; // 若是Id生成策略被指定,不该该有带参数的构造函数 // 省略getter和setter方法 }
由于@Id中的Id字段是惟一的,若是生成策略已经指定,使用persist(Object obj)方法时将抛出异常,所以,要么改成merge方法,要么去掉@GeneratedVale注解,由于persist会寻找游离态的实体是根据Id进行标识,若是没有则自行建立。 api
默认persistence.xml文件处于根目录的META-INF文件下,而且名称固定,若是使用想使用Maven指定,须要配置ant插件: 安全
<plugins> <!--若是想指定persistence.xml位置,则添加以下插件--> <plugin> <artifactId>maven-antrun-plugin</artifactId> <version>1.3</version> <executions> <execution> <id>copy-test-persistence</id> <phase>process-test-resources</phase> <configuration> <tasks> <!--backup the "proper" persistence.xml--> <copy file="${project.build.outputDirectory}/META-INF/persistence.xml" tofile="${project.build.outputDirectory}/META-INF/persistence.xml.proper"/> <!--replace the "proper" persistence.xml with the "test" version--> <copy file="${project.build.testOutputDirectory}/META-INF/persistence.xml" tofile="${project.build.outputDirectory}/META-INF/persistence.xml"/> </tasks> </configuration> <goals> <goal>run</goal> </goals> </execution> <execution> <id>restore-persistence</id> <phase>prepare-package</phase> <configuration> <tasks> <!--restore the "proper" persistence.xml--> <copy file="${project.build.outputDirectory}/META-INF/persistence.xml.proper" tofile="${project.build.outputDirectory}/META-INF/persistence.xml"/> </tasks> </configuration> <goals> <goal>run</goal> </goals> </execution> </executions> </plugin> </plugins>
OK,前面已经说过,只使用注解方式,不使用xml方式,因此persistence.xml使用类加载的方式。 服务器
<?xml version='1.0' encoding='utf-8'?> <persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd" version="2.1"> <!--持久化单元,使用JTA必须架构在JBOSS服务器上--> <persistence-unit name="person_pu" transaction-type="RESOURCE_LOCAL"> <!--hibernate jpa提供者为HibernatePersistenceProvider--> <provider>org.hibernate.jpa.HibernatePersistenceProvider</provider> <!--持久化对象--> <class>ls.jpa.entity.UserInfo</class> <properties> <!--基本属性--> <property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver"/> <property name="javax.persistence.jdbc.url" value="jdbc:mysql://localhost:3306/db_test"/> <property name="javax.persistence.jdbc.user" value="root"/> <property name="javax.persistence.jdbc.password" value="***"/> <!--hibernate配置--> <property name="hibernate.hbm2ddl.auto" value="update"/> <property name="hibernate.show_sql" value="true"/> <property name="hibernate.format_sql" value="true"/> </properties> </persistence-unit> </persistence>
注意:JPA2.0和JPA1.0有较大差异,JPA2.0是提供了类型安全的查询机制、丰富的表达式等功能,而且已经从EJB中独立开来。 架构
单元测试类不用显式加载persistence.xml文件,到底persistence.xml文件是如何加载的为何名称是固定的?笔者找了好久,原来是是在org.hibernate.jpa.boot.internal.PersistenceXmlParser类下定义的,若是单纯从Persistence类下是找不到的,由于hibernate.jpa.boot包下会加载全部配置文件并转换为properties属性存储在Map中,而后经过工具类或者经过ClassLoader进行属性访问。下面为单元测试代码:
import ***; /** * @author Barudisshu */ public class LogonTest { private static final Logger logger = Logger.getLogger(LogonTest.class); private static final String PERSISTENCE_UNIT_NAME = "person_pu"; @Test public void simpleTests(){ // Obtaining an entity manager EntityManagerFactory factory = Persistence.createEntityManagerFactory(PERSISTENCE_UNIT_NAME); EntityManager entityManager = factory.createEntityManager(); // Read the existing entries and write to console TypedQuery<UserInfo> query = entityManager.createQuery("select u from USER u", UserInfo.class); List<UserInfo> userList = query.getResultList(); // List user name for (UserInfo userInfo : userList) { logger.info(userInfo.getUsername()); } logger.info("Size: " + userList.size()); // Simple transaction entityManager.getTransaction().begin(); UserInfo userInfo = new UserInfo(); userInfo.setUsername("Barudisshu"); userInfo.setPassword("88888888"); entityManager.persist(userInfo); entityManager.getTransaction().commit(); // Close the EM and EMF when done entityManager.close(); factory.close(); } }
单纯使用JPA很难知足业务上的需求,所以能够经过Spring进行集成,进而架构成为逻辑清晰的业务层次。首先添加相应的Maven管理包,以下:
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-orm</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-aop</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework.data</groupId> <artifactId>spring-data-jpa</artifactId> <version>${spring-data-jpa.version}</version> </dependency>
为了达到分层的架构,一下分别添加Dao层和Service层,代码清单以下:
Dao层,自动装配持久化上下文:
import ***; /** * @author Barudisshu */ @Repository public class UserDao { @PersistenceContext private EntityManager em; @Transactional public UserInfo save(UserInfo userInfo){ em.persist(userInfo); return userInfo; } }Service层,建立服务:
import ***; /** * @author Barudisshu */ @Service public class UserService { @Autowired private UserDao userDao; @Transactional public UserInfo create(String name,String password){ UserInfo userInfo = new UserInfo(); userInfo.setUsername(name); userInfo.setPassword(password); return userDao.save(userInfo); } }
上述代码没有使用JpaTemplate模版,自spring3.1以后就没有了,多是JPA规范作得足够好的缘由,就像自spring3.2.x以后再也不支持HibernateTemplate同样。
Spring整合Hibernate时,Spring能够经过容器来管理Hibernate的SessionFactory;相似地,Spring整合JPA时,Spring能够经过容器管理JPA的EntityManagerFactory。Spring为JPA EntityManagerFactory管理提供了两种方式:
LocalEntityMangerFactoryBean功能比较有限,只能经过persistence.xml内容的属性构建,所以不能使用Spring容器中已有的DataSource,也不能切换全局事务。而LocalContainerEntityManagerFactoryBean则恰好弥补了这方面的不足,而且可使用Spring容器中已有的数据源,这样persistence.xml就不用编写任何数据源了。
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx" xmlns:aop="http://www.springframework.org/schema/aop" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd"> <context:component-scan base-package="ls.jpa"/> <bean id="emf" class="org.springframework.orm.jpa.LocalEntityManagerFactoryBean"> <!--注入JPA持久化单元--> <property name="persistenceUnitName" value="person_pu"/> </bean> <bean id="txManager" class="org.springframework.orm.jpa.JpaTransactionManager"> <property name="entityManagerFactory" ref="emf"/> </bean> <!--开启AOP监听--> <aop:aspectj-autoproxy expose-proxy="true"/> <!--使用声明式事务--> <tx:annotation-driven transaction-manager="txManager"/> </beans>OK,全部配置已经完成,下面进行简单的单元测试:
import ***; /** * @author Barudisshu */ @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(locations = {"classpath:spring-config.xml"}) @Transactional @TransactionConfiguration(transactionManager = "txManager",defaultRollback = true) public class SimpleTest { private static final Logger logger = Logger.getLogger(SimpleTest.class); @Autowired private UserService userService; @Test public void userTests(){ UserInfo userInfo = userService.create("Barudisshu","liter"); logger.info(JSON.toJSONString(userInfo)); } }
单元测试绿条经过后,打开数据库能够看到,已经自动为你建立t_user用户表:
Well done!