Spring & Spring MVC & Hibernate 整合備忘

時間 2019-11-09

標籤 spring mvc hibernate 整合備忘欄目 Spring 简体版

原文原文鏈接

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

1. pom.xml

儘可能使用 Maven 管理項目依賴以減小包引入時的麻煩，以及避免跨開發工具問題css

<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>
        <!-- 避免 IDEA 重置編譯配置爲 1.5 而提醒版本過期 -->
        <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>
    
        <!-- JUnit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
        </dependency>

        <!-- Spring 注：引入這一依賴後，spring-context, spring-core 等包會被 Maven 基於依賴管理引入，Spring 中各個包的依賴關係詳見本文參考「1. Spring 各 jar 包的做用及依賴關係」 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- Spring MVC -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- Mysql JDBC Driver -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${mysql.jdbc.version}</version>
        </dependency>

        <!-- Hibernate -->
        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-core</artifactId>
            <version>${hibernate.version}</version>
        </dependency>

        <!-- Jackson 注：引入 jackson-databind 以便 Spring mvc 對 json、html 等不一樣返回類型進行配置 -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>${jackson.version}</version>
        </dependency>

        <!-- Common fileupload 注：用於 Spring mvc 文件上傳 -->
        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>${commons-fileupload.version}</version>
        </dependency>

        <!-- Servlet API 注：須要使用到 Servlet api 時須要引入這一依賴 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>${servlet.version}</version>
        </dependency>

        <!-- AspectJ 注：Spring 中使用基於 AspectJ 的聲明式 xml 事務配置方式 -->
        <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>

    <!-- Spring 容器初始化配置 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <!-- 此配置指定 Spring 的配置文件爲 application-context.xml -->
        <param-value>classpath:application-context.xml</param-value>
    </context-param>

    <!-- 強制 UTF-8 編碼，避免中文亂碼問題。注：若是按照此配置開頭的 web-app_2_3.dtd 規範，filter 配置項必須位於 context-param 和 listener 之間。詳情見參考 14.「The content of element type "web-app" must match 問題之解決辦法」 -->
    <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>

    <!-- 使用此配置避免用 new ClassPathXmlApplicationContext("") 的方式獲得 Spring 上下文-->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- Spring MVC Servlet -->
    <servlet>
        <servlet-name>spring-mvc-servlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        
        <!-- 進行此配置指定 spring mvc 的配置文件爲 spring-mvc.xml，不然會默認尋找 xxx-servlet.xml -->
        <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 行匹配html

<?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/beans
     http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
     http://www.springframework.org/schema/aop
     http://www.springframework.org/schema/aop/spring-aop-4.0.xsd
     http://www.springframework.org/schema/context
     http://www.springframework.org/schema/context/spring-context-4.0.xsd
     http://www.springframework.org/schema/tx
     http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
     http://www.springframework.org/schema/cache http://www.springframework.org/schema/cache/spring-cache-4.0.xsd">

    <!-- 引用 jdbc.properties 文件中的配置，該配置會用於 dataSource bean 中 -->
    <context:property-placeholder location="classpath:properties/jdbc.properties" />

    <!-- 添加 aspectJ 支持 -->
    <aop:aspectj-autoproxy/>

    <!-- 配置 Spring 容器掃描的路徑，這裏排除須要載入 Spring MVC 上下文而使用的註解 @Controller。可見參考 15.「spring mvc 和 spring 各自掃描本身的註解不要相互混淆，以及參考 20.「context:exclude-filter 與 context:include-filter」-->
    <context:component-scan base-package="com.ecollaboration">
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller" />
    </context:component-scan>

    <!-- 配置 dataSource bean，這裏的 ${jdbc.url} 等對應第 17 行 jdbc.properties 文件中的鍵名 -->
    <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>
    
    <!-- 配置 sessionFactory bean，這裏用到 dataSource bean -->
    <bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <!-- 進行部分 hibernate 配置 -->
        <property name="hibernateProperties">
            <props>
                <!-- 是否打印執行的 SQL 語句 -->
                <prop key="hibernate.show_sql">true</prop>
                <!-- 是否格式化 SQL 語句 -->
                <prop key="hibernate.format_sql">true</prop>
                <!-- 數據庫方言 -->
                <prop key="hibernate.dialect">org.hibernate.dialect.MySQL5Dialect</prop>
                <!-- 自動建立 | 更新 | 驗證數據庫表結構，若這裏配置的值爲 create，則會在執行 hibernate 表操做時重建表結構（ 表會被清空 ） -->
                <prop key="hibernate.hbm2ddl.auto">update</prop>
                <!-- 添加此配置以使用 sessionFactory.getCurrentSession() 獲得一個 session -->
                <prop key="current_session_context_class">thread</prop>
                <!-- 添加此配置將事務管理交給 Spring，即無需再寫 session.beginTransaction() 等事務管理和鏈接資源關閉代碼。參見參考 17.「current_session_context_class」 -->
                <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>

        <!-- 使用註解的方式，肯定所需掃描的註解所在包的路徑，若僅使用配置的方式，能夠註釋這一配置 -->
        <!-- <property name="packagesToScan">
            <list>
                <value>com.ecollaboration.entities</value>
            </list>
        </property> -->
    </bean>
    
    <!-- 配置事務管理器 -->
    <bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager">
        <property name="sessionFactory" ref="sessionFactory"/>
    </bean>

    <!-- 配置 AOP Advice -->
    <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 切入點，這裏使用 AspectJ 的事務配置方式，參見參考 18.「aop:aspectj-autoproxy 做用」，此處的 poincut 屬性需按照實際狀況配置 -->
    <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 行匹配java

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 行匹配mysql

<?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.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">

    <!-- 指定 Spring MVC 掃描含有如 @Controller 等註解的包的路徑，通常爲項目控制器所在包的路徑。進行這一配置後無需再寫入 <context:component-config />。有關 component-scan 的內容能夠參見參考 13.「Spring 註解 @Component、@Repository、@Service、@Controller 區別」。這裏使用 include-filter 使得只有含有 @Controller 註解的控制器 bean 會使用 Spring mvc 的上下文，參見參考 19.「在使用 spring mvc 時... @Transactional 聲明的事務不起做用」。-->
    <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>

    <!-- 此配置使得 @ResponseBody 等註解能夠生效 -->
    <mvc:annotation-driven/>

    <!-- 此配置使得控制器能夠根據返回類型返回 json 數據或視圖文件 -->
    <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/json
                        xml=application/xml
                        html=text/html
                    </value>
                </property>
                <property name="defaultContentType" value="text/html"/>
            </bean>
        </property>

    </bean>

    <!-- 添加 Spring mvc 的文件上傳支持 -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="maxUploadSize" value="10240000"/>
        <property name="defaultEncoding" value="UTF-8"/>
    </bean>

    <!-- 添加此配置用於排除 Spring mvc 對靜態資源文件的處理。有關靜態資源路徑問題參見參考 31.「Spring mvc 訪問靜態資源的三種方式」 -->
    <mvc:resources mapping="/resources/**" location="/resources/"/>

    <!-- 添加攔截器 -->
    <mvc:interceptors>
        <!-- 全局攔截器，會對全部的請求攔截 -->
        <bean id="normalInterceptor" class="com.ecollaboration.interceptors.NormalInterceptor"/>

        <!-- 局部攔截器，只攔截與 mapping 匹配的請求 -->
        <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 中，若是配置信息爲：git

<!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，即將配置信息改成：github

<?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> 能夠解決這一問題。web

6.3 路徑問題

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

6.4 `classpath:` 和 `classpath*:` 區別

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

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>
        
        <!-- 這裏不能寫成 -->
        <!-- <value>hibernates/*.hbm.xml</value> -->
        <!-- 也不能寫成 -->
        <!-- <value>classpath: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 行）：

<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="*" propagation="REQUIRED" rollback-for="Exception"/>
    </tx:attributes>
</tx:advice>

<aop:config proxy-target-class="true">
    <!-- 與具體包結構有關 -->
    <aop:advisor pointcut="execution(public * com.*(..))" advice-ref="txAdvice"/>
</aop:config>

注：須要注意 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 支持

<!-- 添加 thymeleaf-spring 依賴，會自動引入 thymeleaf 包 -->
<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring4</artifactId>
    <version>3.0.3.RELEASE</version>
</dependency>

<!-- 引入 Thymeleaf layout dialect 以使用 layout:fragment 等組織視圖佈局。詳情見參考 33. 「Thymeleaf Layout Dialect」 -->
<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 class="org.springframework.web.servlet.view.InternalResourceViewResolver">-->
    <!--<property name="prefix" value="/WEB-INF/views/"/>-->
    <!--<property name="suffix" value=".jsp"/>-->
<!--</bean>-->

<!-- 添加 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，用於在使用 layout 組織視圖佈局時對 head 中的 css 和 javascript 標籤有序組織 -->
<bean id="groupingStrategy" class="nz.net.ultraq.thymeleaf.decorators.strategies.GroupingStrategy"/>

<bean id="templateEngine" class="org.thymeleaf.spring4.SpringTemplateEngine">
    <property name="templateResolver" ref="templateResolver"/>
    <!-- 引入 Layout Dialect 以使用 layout 佈局 -->
    <property name="additionalDialects">
        <set>
            <bean class="nz.net.ultraq.thymeleaf.LayoutDialect">
                <!-- 傳入上面聲明的 groupingStrategy bean -->
                <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 中新建一個文件模板，以下圖：