教程：Hibernate，JPA和Spring MVC

本教程将向您展示如何使用基本的Hibernate / JPA应用程序，如何将其转换为Spring MVC Web项目，以便能够在Web浏览器中查看数据库，以及最后使用Spring的@Transactional注释来减少样板代码。

本教程假定您熟悉Java和Maven，并且已经完成了本教程的第一部分。您还需要下载并安装Tomcat。

您可能希望从Github全新签出代码。

容器管理的数据源

我们需要修改或创建许多密钥文件，才能将第1部分中的代码转换为Web项目。我们需要做的第一件事（假设您已经安装了Tomcat并在计算机环境中设置了CATALINA_HOME）是将JDBC配置移至Tomcat的配置，以便数据源由Tomcat管理，而不是通过编程方式进行管理，并且可以使用JNDI访问。

为此，请在$ CATALINA_HOME / conf / server.xml的GlobalNamingResources元素内添加以下行：

<Resource auth='Container' driverClassName='org.apache.derby.jdbc.EmbeddedDriver' maxActive='8' maxIdle='4' name='jdbc/tutorialDS' type='javax.sql.DataSource' url='jdbc:derby:tutorialDB;create=true' username='' password='' />

包含org.apache.derby.jdbc.EmbeddedDriver的jar必须可用于Tomcat。获取jar的一种快速方法是从您的Maven本地存储库，例如〜/ .m2 / repository / org / apache / derby / derby / 10.4.1.3 / derby-10.4.1.3.jar。将该文件复制到$ CATALINA_HOME / lib中，然后重新启动Tomcat，以确保没有错误。

这些更改将创建已部署的应用程序可以访问的数据源。在Tomcat 7中，您可以在http：// localhost：8080 / manager / text / resources上查看托管资源；您应该看到类似以下内容：

OK - Listed global resources of all types
jdbc/tutorialDS:org.apache.tomcat.dbcp.dbcp.BasicDataSource
UserDatabase:org.apache.catalina.users.MemoryUserDatabase

转换为Web项目

使用第1部分中的some项目，我们需要进行以下更改：

我们需要更改项目以生成Web存档，因此在pom.xml中添加以下内容：

<packaging>war</packaging>

您将想要（为了方便）在build部分中添加一行，以创建一个没有项目版本的.war：

<finalName>${project.artifactId}</finalName>

我们还需要Servlet API库：
<依赖性>

<groupId>javax.servlet</groupId><artifactId>servlet-api</artifactId><version>2.5</version><scope>provided</scope></dependency>

注意：“范围”是“提供的”，因为Tomcat已经具有内置的servlet库。

为了使数据源可用于应用程序，请使用以下几行创建src / main / webapp / META-INF / context.xml：

<Context><ResourceLink global='jdbc/tutorialDS' name='jdbc/tutorialDS' type='javax.sql.DataSource'/>
</Context>

这使得由Tomcat管理的数据源可用于我们的应用程序。我们还需要src / main / webapp / WEB-INF / web.xml的存根：

<web-appxmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'xmlns='http://java.sun.com/xml/ns/javaee'xsi:schemaLocation='http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd'version='2.5'>
</web-app>

编译应用程序并将其部署到Tomcat。此时您将看不到任何内容，因为没有servlet或页面。

可以让Maven为您构建并部署到Maven，或者您可以在大多数IDE中运行Tomcat。在其他地方有很多关于此的文章，因此在此不做介绍。

添加Spring MVC

我们将为此使用Spring MVC，因此我们需要一些其他更改来支持这一点：

将以下依赖项添加到pom.xml中：

<dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>3.0.6.RELEASE</version></dependency>

我们要告诉Tomcat使用Spring来调度请求，因此我们需要在web.xml中添加以下几行：
<context-param>

<param-name>contextConfigLocation</param-name><param-value>/WEB-INF/mvc-dispatcher-servlet.xml</param-value></context-param><listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener><servlet><servlet-name>mvc-dispatcher</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>mvc-dispatcher</servlet-name><url-pattern>*.html</url-pattern></servlet-mapping>

这会将所有以'.html'结尾的页面的请求转发给Spring，Spring将选择适当的控制器来服务每个请求。我们还需要为Spring Servlet创建一个应用程序上下文，并且必须存在于src / main / webapp / WEB-INF / mvc-dispatcher-servlet.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'xsi:schemaLocation='http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsdhttp://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd'><context:component-scan base-package='tutorial'/><context:annotation-config/><bean class='org.springframework.web.servlet.view.InternalResourceViewResolver'><property name='prefix'><value>/WEB-INF/pages/</value></property><property name='suffix'><value>.jsp</value></property></bean></beans>

该XML有两件事：

它告诉Spring扫描软件包“ tutorial”中和其下的类，以查找标注为bean的类。
如何将视图名称转换为资源。本质上，它说“使用名称，在名称前加上'/ WEB-INF / pages”，然后在结果后加上“ .jsp”。

您可能需要重新部署此产品以进行烟雾测试。

要对此进行测试，我们需要显示一个页面。第一页将显示所有用户的列表。我们需要两个文件；第一个是服务请求的控制器：

package tutorial;import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;@Controller
public class UsersController {@RequestMapping('/users')public String users(Model model) {return 'users';}
}

第二项是要显示的页面。这基于UsersController.users（）返回的字符串，并使用资源解析器的规则，我们知道此文件必须为WEB-INF / pages / users.jsp。创建页面的存根，如下所示：

<html>
<body>
<h1>Users</h1>
</body>
</html>

最后，您可以通过重新部署到Tomcat并使用浏览器查看http：// localhost：8080 / tutorial-hibernate-jpa / users.html进行测试。

添加Spring ORM

Spring包含了将实体管理器注入bean的支持，这仅需要将几行代码添加到pom.xml和mvc-dispatcher-context.xml中：

<dependency><groupId>org.springframework</groupId><artifactId>spring-orm</artifactId><version>3.0.6.RELEASE</version></dependency>

<jee:jndi-lookup id='tutorialDS' jndi-name='java:/comp/env/jdbc/tutorialDS' expected-type='javax.sql.DataSource'/><bean id='entityManagerFactory' class='org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean'><property name='dataSource' ref='tutorialDS'/></bean>

“ jndi-lookup”元素从JNDI资源创建一个bean，并且由实体管理器工厂使用它来创建实体管理器。其他JNDI对象也可以以此方式进行查找。

注意：您需要将XML名称空间和XSD添加到根元素：xmlns：jee ='http：//www.springframework.org/schema/jee'。

最后，我们可以添加代码以将实体管理器注入到控制器中并从数据库中获取用户。

public class UsersController {@PersistenceContextprivate EntityManager entityManager;@RequestMapping('/users')public String users(Model model) {model.addAttribute('users', entityManager.createQuery('select u from User u').getResultList());return 'users';}
}

此代码使用实体管理器来获取所有用户，并将其绑定到一个名为“用户”的属性，该属性对于我们的JSP而言是可见的。

我们将要在页面上显示用户。为此，我将使用JSTL。您可以根据需要使用其他技术，如果没有，我会尽快为您提供所需的信息。同样，如果您不熟悉的话，还有很多关于JSTL的优秀教程。首先，向您添加另一个依赖项pom.xml：

<dependency><groupId>javax.servlet</groupId><artifactId>jstl</artifactId><version>1.2</version></dependency>

并更新users.html显示用户：

<%@ taglib prefix='c' uri='http://java.sun.com/jsp/jstl/core' %>
<html>
<body>
<h1>Users</h1>
<table><thead><tr><td>ID</td><td>Name</td></tr></thead><tbody><c:forEach var='user' items='${users}'><tr><td>${user.id}</td><td>${user.name}</td></tr></c:forEach></tbody>
</table>
</body>
</html>

最后，您可以在浏览器中进行抽烟测试。

@交易

难题的最后一步是创建用户。为此，我们需要一种基本形式，例如，我已经创建了pages / create-user.jsp：

<html>
<body>
<h1>Create User</h1>
<form method='post'>
Name: <input name='name'/>
<input type='submit'/>
</form>
</body>
</html>

我们需要一个控制器来访问它，因此将其添加到UsersController中：

@RequestMapping(value = '/create-user', method = RequestMethod.GET)publicString createUser(Model model) {return 'create-user';}

注意：此方法仅接受GET请求。发布表单时，我们需要其他方法。您可以通过重新部署到Tomcat并浏览到http：// localhost：8080 / tutorial-hibernate-jpa / create-user.html来进行抽烟测试。您会注意到，提交页面会导致HTTP 405错误。我们可以使用以下（重载）方法处理POST请求：

@RequestMapping(value = '/create-user', method = RequestMethod.POST)@Transactionalpublic String createUser(Model model, String name) {User user = new User();user.setName(name);entityManager.persist(user);return 'redirect:/users.html';}

我们在这里使用了@Transactional批注。当我们这样做时，Spring将为我们的bean创建一个代理对象并为我们管理事务，在发生错误时开始，提交和回滚。与我们自己打开和关闭交易相比，这要少得多的代码（一行而不是一打），更安全（出现印刷错误的机会更少）。您可以在这篇文章中看到详细版本代码的示例。我们需要通过在Spring上下文中添加以下几行来告诉Spring支持这一点：告诉它使用基于注释的事务，以及应该由哪个bean管理事务：

<tx:annotation-driven/><bean id='transactionManager' class='org.springframework.orm.jpa.JpaTransactionManager'><property name='entityManagerFactory' ref='entityManagerFactory' /></bean>

注意：您还需要在文档中添加正确的架构：

xmlns:tx='http://www.springframework.org/schema/tx'
...http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd

您可以通过转到页面并提交新用户来进行测试。之后，您将被重定向到用户页面，在那里您应该能够看到您的新用户。

结论

在此示例中，XML的行比Java多，但是大多数XML是一次性设置，您会发现，随着应用程序变大，比率会下降。您可以使用Spring支持JPA实体，从而使到JEE的迁移更加容易。

我在这里只介绍了CRUD的“ C”和“ R”部分，您应该在这里拥有足够的信息，以便能够自己尝试其余的部分。

此代码在Github上。 Hibernate Java Maven ORM Spring框架

参考： 教程：Hibernate，JPA和Spring MVC –来自我们的JCG合作伙伴 Alex Collins的第二部分，位于Alex Collins的博客博客中。