當前位置：首頁 > 前端技术 > javascript >内容正文

javascript

Spring Spring MVC Hibernate 整合备忘

發布時間：2025/3/17 javascript 52 豆豆

生活随笔收集整理的這篇文章主要介紹了 Spring Spring MVC Hibernate 整合备忘小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

以下為此三種框架整合配置的詳細備注，以及部分問題備忘
項目結構和配置文件可訪問 Github 查看

1. pom.xml

盡量使用 Maven 管理項目依賴以減少包引入時的麻煩，以及避免跨開發工具問題

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.ecollaboration</groupId><artifactId>ecollaboration_v1</artifactId><packaging>war</packaging><version>1.0-SNAPSHOT</version><name>ecollaboration_v1 Maven Webapp</name><url>http://maven.apache.org</url><properties><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target><junit.version>4.12</junit.version><spring.version>4.3.3.RELEASE</spring.version><hibernate.version>4.3.11.Final</hibernate.version><jackson.version>2.8.6</jackson.version><commons-fileupload.version>1.3.2</commons-fileupload.version><servlet.version>3.1.0</servlet.version><mysql.jdbc.version>5.1.21</mysql.jdbc.version><aspectj.version>1.8.9</aspectj.version></properties><dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>${junit.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-orm</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>${spring.version}</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>${mysql.jdbc.version}</version></dependency><dependency><groupId>org.hibernate</groupId><artifactId>hibernate-core</artifactId><version>${hibernate.version}</version></dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>${jackson.version}</version></dependency><dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>${commons-fileupload.version}</version></dependency><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>${servlet.version}</version></dependency><dependency><groupId>org.aspectj</groupId><artifactId>aspectjweaver</artifactId><version>${aspectj.version}</version></dependency></dependencies><build><finalName>ecollaboration_v1</finalName></build> </project>

2. web.xml

<!DOCTYPE web-app PUBLIC"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd" ><web-app><display-name>Archetype Created Web Application</display-name><context-param><param-name>contextConfigLocation</param-name><param-value>classpath:application-context.xml</param-value></context-param><filter><filter-name>characterEncodingFilter</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class><init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param><init-param><param-name>forceEncoding</param-name><param-value>true</param-value></init-param></filter><filter-mapping><filter-name>characterEncodingFilter</filter-name><url-pattern>/</url-pattern></filter-mapping><listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener><servlet><servlet-name>spring-mvc-servlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring-mvc.xml</param-value></init-param><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>spring-mvc-servlet</servlet-name><url-pattern>/</url-pattern></servlet-mapping></web-app>

3. application-context.xml

文件名與 web.xml 第 12 行匹配

<?xml version="1.0" encoding="UTF-8"?> <beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns="http://www.springframework.org/schema/beans" xmlns:aop="http://www.springframework.org/schema/aop"xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"xmlns:cache="http://www.springframework.org/schema/cache" xmlns:p="http://www.springframework.org/schema/p"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans-4.0.xsdhttp://www.springframework.org/schema/aophttp://www.springframework.org/schema/aop/spring-aop-4.0.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context-4.0.xsdhttp://www.springframework.org/schema/txhttp://www.springframework.org/schema/tx/spring-tx-4.0.xsdhttp://www.springframework.org/schema/cache http://www.springframework.org/schema/cache/spring-cache-4.0.xsd"><context:property-placeholder location="classpath:properties/jdbc.properties" /><aop:aspectj-autoproxy/><context:component-scan base-package="com.ecollaboration"><context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller" /></context:component-scan><bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"><property name="driverClassName" value="${jdbc.driverClassName}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></bean><bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean"><property name="dataSource" ref="dataSource"/><property name="hibernateProperties"><props><prop key="hibernate.show_sql">true</prop><prop key="hibernate.format_sql">true</prop><prop key="hibernate.dialect">org.hibernate.dialect.MySQL5Dialect</prop><prop key="hibernate.hbm2ddl.auto">update</prop><prop key="current_session_context_class">thread</prop><prop key="hibernate.current_session_context_class">org.springframework.orm.hibernate4.SpringSessionContext</prop></props></property><property name="mappingResources"><list><value>hibernates/UserEntity.hbm.xml</value></list></property></bean><bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager"><property name="sessionFactory" ref="sessionFactory"/></bean><tx:advice id="txAdvice" transaction-manager="transactionManager"><tx:attributes><tx:method name="get*" read-only="true" propagation="REQUIRED"/><tx:method name="list*" read-only="true" propagation="REQUIRED"/><tx:method name="find*" read-only="true" propagation="REQUIRED"/><tx:method name="*" propagation="REQUIRED" rollback-for="Exception"/></tx:attributes></tx:advice><aop:config proxy-target-class="true"><aop:advisor pointcut="execution(public * com.ecollaboration.services.*Service.*(..))" advice-ref="txAdvice"/></aop:config> </beans>

4. jdbc.properties

文件名與 application-context.xml 第 17 行匹配

jdbc.driverClassName=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost/ecollaboration?characterEncoding=UTF-8 jdbc.username=dbusername jdbc.password=dbpassword

5. spring-mvc.xml

文件名與 web.xml 第 46 行匹配

<?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:mvc="http://www.springframework.org/schema/mvc"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsdhttp://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd"><context:component-scan base-package="com.ecollaboration.controllers"><context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/></context:component-scan><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/views/"/><property name="suffix" value=".jsp"/></bean><mvc:annotation-driven/><bean class="org.springframework.web.servlet.view.ContentNegotiatingViewResolver"><property name="order" value="1"/><property name="defaultViews"><list><bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView"/></list></property><property name="contentNegotiationManager"><bean class="org.springframework.web.accept.ContentNegotiationManagerFactoryBean"><property name="favorParameter" value="true"/><property name="parameterName" value="format"/><property name="ignoreAcceptHeader" value="false"/><property name="mediaTypes"><value>json=application/jsonxml=application/xmlhtml=text/html</value></property><property name="defaultContentType" value="text/html"/></bean></property></bean><bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="maxUploadSize" value="10240000"/><property name="defaultEncoding" value="UTF-8"/></bean><mvc:resources mapping="/resources/**" location="/resources/"/><mvc:interceptors><bean id="normalInterceptor" class="com.ecollaboration.interceptors.NormalInterceptor"/><mvc:interceptor><mvc:mapping path="/hello/register"/><mvc:mapping path="/hello/index/*"/><bean id="testInterceptor" class="com.ecollaboration.interceptors.TestInterceptor"/></mvc:interceptor></mvc:interceptors> </beans>

6. 問題備忘

6.1 JSP 中無法使用 EL 表達式

在 web.xml 中，如果配置信息為：

<!DOCTYPE web-app PUBLIC"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd" > <web-app> </web-app>

則表示其采用 JSP 1.2，EL 表達式默認關閉，此時需要在 .jsp 中添加 <% @page isELIgnored="false" %>；
或采用 JSP 2.0，即將配置信息改為：

<?xml version="1.0" encoding="UTF-8"?> <web-app id="MyApp" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> </web-app>

6.2 /* 與 /** 的區別

/* 中的通配符 * 會止于分隔符 /，而 /** 則不會。如 <url-pattern>/resources/*</url-pattern> 無法匹配 /resources/images/xxx.jpg，而只能匹配 /resources/xxx.jpg。
換做 <url-pattern>/resources/**</url-pattern> 可以解決這一問題。

6.3 路徑問題

在 Java 項目中，/path/to/xxx 表示以 webapp 為起點的路徑；path/to/xxx 表示以項目根目錄為起點的路徑；classpath:path/to/xxx 標識以 classpath 為起點的路徑；
注：也可以使用 this.getClass().getClassLoader().getResource（""）得到類對于系統的絕對路徑進而得到所需資源的路徑。

6.4 classpath: 和 classpath*: 區別

classpath*: 可以從多個 jar 文件中加載相同的文件，而 classpath: 只會加載找到的第一個文件。如引入的兩個 jar 包都存在 com.a 下的 xx.xml 文件，使用 classpath: 只會加載找到的第一個文件，而 classpath*: 則會加載全部。

6.5 class path resource [beans.xml] cannot be opened because it does not exist 報錯解決方法

在 application-context.xml 配置中，關于 sessionFactory 的配置中，其屬性 mappingResource 不能加入 classpath:（默認即為 classpath 下的文件），也不能使用通配符。

<property name="mappingResources"><list><value>hibernates/UserEntity.hbm.xml</value></list> </property>

6.6 Could not obtain transaction-synchronized Session for current thread 報錯解決方法

如果不使用 Spring 的事務管理機制，且使用 session.getCurrentSession() 時，會出現如上圖所示錯誤，此時需要對 application-context （Spring 配置文件）進行更改（參見 application-context 第 50 行）：

<bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean"> <property name="hibernateProperties"><props><prop key="current_session_context_class">thread</prop><prop key="hibernate.current_session_context_class">org.springframework.orm.hibernate4.SpringSessionContext</prop></props></property> </bean>

并添加配置將事務管理交給 Spring（參見 application-context 第 90 行）：

注：需要注意 aop:advisor 中 pointcut 屬性所覆蓋的類與方法，如果操作 session 的方法不在此包含內，則仍會報錯。
注：當然也可以使用 session.openSession() 并通過 Hibernate 的事務管理方式組織代碼。

6.7 Spring MVC 路由失效問題

有時可能出現：在配置了 @Controller 后，訪問該控制器對應的 URL 時，返回 404 錯誤。此時需要檢查 web.xml 中是否添加了 welcome-file-list，如下：

<welcome-file-list> <welcome-file>index.html</welcome-file><welcome-file>index.jsp</welcome-file> </welcome-file-list>

此時，對某一 url 的訪問會等同于訪問該路徑所對應文件夾下的 index.html 或 index.jsp 文件，如訪問 localhost/foo 等同于訪問 localhost/foo/index.html 或 localhost/foo/index.jsp（依次檢測這兩個文件是否存在）。因而需要在 spring-mvc.xml （ Spring mvc 配置文件）中添加如下配置：

<mvc:default-servlet-handler />

6.8 context:property-placeholder 導入多個 .properties 配置文件

由于 Spring 容器允許最多定義一個 placeholder，加入多個文件會忽略。而由于 IDE 不會進行這一判斷，因而會出現 IDE 中沒有警告提示，但運行時卻報錯的情況。

這時我們可以使用通配符解決引入多個配置文件的需求：

<context:property-placeholder location="classpath*:*.properties"/>

6.9 運行出現警告 WARNING: Exception encountered during context initialization - cancelling refresh attempt

發生這一問題可能是由于在進行代碼遷移時，tomcat 和編譯器的 jdk 指定版本不同，導致前者無法識別后者編譯的的字節碼文件。只需將二者保持一致即可，詳情可參考 Stackoverflow。

7. 擴展 - 添加 Thymeleaf 模板引擎支持

若要在項目中使用 Thymeleaf 模板引擎，需要對之前進行的配置進行以下修改

7.1 修改 pom.xml 以增加 Thymeleaf 支持

<dependency><groupId>org.thymeleaf</groupId><artifactId>thymeleaf-spring4</artifactId><version>3.0.3.RELEASE</version> </dependency> <dependency><groupId>nz.net.ultraq.thymeleaf</groupId><artifactId>thymeleaf-layout-dialect</artifactId><version>2.1.2</version> </dependency>

7.2 修改 spring-mvc.xml 以改變 View Resolver

這里需要將 spring-mvc.xml 第 16 - 19 行注釋，并添加 ThymeleafViewResolver 的相應配置：

<bean id="templateResolver" class="org.thymeleaf.spring4.templateresolver.SpringResourceTemplateResolver"><property name="prefix" value="/WEB-INF/views/"/><property name="suffix" value=".html"/><property name="templateMode" value="HTML"/><property name="characterEncoding" value="UTF-8"/><property name="cacheable" value="false"/> </bean> <bean id="groupingStrategy" class="nz.net.ultraq.thymeleaf.decorators.strategies.GroupingStrategy"/><bean id="templateEngine" class="org.thymeleaf.spring4.SpringTemplateEngine"><property name="templateResolver" ref="templateResolver"/><property name="additionalDialects"><set><bean class="nz.net.ultraq.thymeleaf.LayoutDialect"><constructor-arg ref="groupingStrategy"/></bean></set></property> </bean><bean id="thymeleafViewResolver" class="org.thymeleaf.spring4.view.ThymeleafViewResolver"><property name="templateEngine" ref="templateEngine"/><property name="characterEncoding" value="UTF-8"/> </bean>

7.3 添加 Thymeleaf namespace 支持

由于 Thymeleaf 使用如 <p th:text=""></p> 的方式解析視圖，若要開發工具能夠支持 th:xxx 的代碼提示，需要在 html 標簽中加入聲明：<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">，（如需使用 layout 布局，還需加入 xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout" ），此時 html 文件框架為：

<!doctype html> <html lang="zh-CN" xmlns:th="http://www.thymeleaf.org"xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"> <head><meta charset="UTF-8"><title></title> </head> <body></body> </html>

7.4 在 IDEA 中添加含有 th 命名空間聲明的 .html 文件框架

由于開發工具與 emmet 插件等自動生成的 .html 文件框架中不含上述聲明，每次都要寫入聲明也比較麻煩，可以在開發工具中添加一個文件模板以避免重復工作，這里以 IDEA 為例：
在 File > Other Settings > Default Settings > Editor > File and Code Templates 中新建一個文件模板，如下圖：

7.5 Thymeleaf 資料參考

thymeleaf使用詳解 - 知乎專欄

Thymeleaf 模板的使用 - 博客園

${}, *{}, #{}, @{}, ~{} 的區別 - stackoverflow

新一代Java模板引擎Thymeleaf - 天馬營

Thymeleaf Layout Dialect

參考

Spring 各 jar 包的作用及依賴關系 - 博客園

hibernate.hbm2ddl.auto配置詳解 - 博客園

Spring-mvc 解決EL表達式不能使用問題 - CSDN

Spring: Difference of /* and / with regards to paths - stackoverflow

Spring 中 property-placeholder 的使用與解析 - 博客園

IDEA 新建 Spring 配置文件的方法 - CSDN

SPRING4配置文件模板 - 博客園

JAVA獲取CLASSPATH路徑

Spring 加載 resource 時 classpath*: 與 classpath: 的區別 - CSDN

SSM_config 配置 springmvc.xml 模板 - CSDN

<context:component-scan>使用說明 - CSDN

java.io.FileNotFoundException: class path resource beans.xml cannot be opened because it does not exist 解決方法 - CSDN

Spring 注解 @Component、@Repository、@Service、@Controller 區別 - CSND

The content of element type "web-app" must match 問題之解決辦法 - CSDN

spring mvc 和 spring 各自掃描自己的注解不要相互混淆 - 博客園

context:component-scan 掃描使用上的容易忽略的 use-default-filters - iteye

current_session_context_class - CSDN

aop:aspectj-autoproxy 作用 - 360DOC

在使用 spring mvc 時，我使用了 @Service 這樣的注解，發現使用注解 @Transactional 聲明的事務不起作用 - CSDN

context:exclude-filter 與 context:include-filter - CSDN

SpringMVC + Spring + Hibernate 整合 - 慕課網

Spring 事務管理 - 慕課網

@resource和@autowired的區別是什么 - CSDN

SpringMVC4+thymeleaf3的一個簡單實例（篇二：springMVC與thymeleaf的整合） - 博客園

IntelliJ IDEA 2016.3 Help

thymeleaf code completion not working intellij 14 - stackoverflow

Intellij Idea: Thymeleaf namespace unknown