整合SSM框架筆記
Spring5 + Spring MVC + MyBatis + Druid + MySQL + Thymeleaf
感謝尚硅谷課程:B站課程
前言
單Spring框架時,是Java工程。
Spring與Spring MVC可以共用一個配置文件,也可以不共用一個,推薦不共用一個。
Spring與Spring MVC何時加載Bean至IOC容器?
Spring:獲取Spring IOC容器時加載Bean至IOC容器。
Spring MVC:DispatcherServlet
初始化時創建IOC容器,并加載Bean至IOC容器。一般設置DispatcherServlet
在Tomcat啟動時便初始化:<load-on-startup>1</load-on-startup>
。
Spring與Spring MVC Bean的依賴順序
Spring MVC負責Controller層。Spring負責Service與DAO層。
由于Controller層需要依賴Service層,因此Spring的IOC容器應該在Spring MVC 的DispatcherServlet
初始化之前創建。
注意:當Spring與Spring MVC 整合后,Spring的IOC容器便被設置為Spring MVC 的父容器,子容器可以訪問父容器的所有Bean,但是父容器不可以訪問子容器的Bean。
Java Web 三大組件
Java Web 三大組件:Servlet、Filter、Listener。
執行順序:Listener>Filter>Servlet>攔截器
因此,應該把Spring 創建IOC的操作放在Listener或Filter中。這里放在Listener中,因為Listener的初始化方法只會執行一次。
監聽器
參考博文:https://blog.csdn.net/GavinGroves/article/details/135875612
Java Web 中 Listener 按監聽的域對象的類型分為三種:
- 監聽Application域
ServletContextListener
ServletContextAttributeListener
- 監聽Session域
HttpSessionListener
HttpSessionAttributeListener
HttpSessionBindingListener
HttpSessionActivationListener
- 監聽Request域
ServletRequestListener
ServletRequestAttributeListener
ContextLoaderListener
Spring提供了監聽器ContextLoaderListener
,實現ServletContextListener
接口,可監聽ServletContext
的狀態,在web服務器的啟動時,讀取Spring的配置文件,創建Spring的IOC容器。
web.xml 簡單示例
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"version="4.0">·········<!-- Spring 配置文件位置,如果不指定,則默認在WEB-INF下,名稱固定為:applicationContext.xml --><context-param><param-name>contextConfigLocation</param-name><param-value>classpath:SpringConfig.xml</param-value></context-param><!--Spring提供了監聽器ContextLoaderListener,實現ServletContextListener接口,可監聽ServletContext的狀態,在web服務器的啟動時,讀取Spring的配置文件,創建Spring的IOC容器。--><!-- 用于在 Spring MVC IOC 容器 創建之前,創建 Spring IOC 容器 --><listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener>·········
</web-app>
整合步驟
Spring 相關部分
Druid
導入MySQL 驅動包依賴
<!-- MYSQL Java 驅動 --><!-- https://mvnrepository.com/artifact/com.mysql/mysql-connector-j --><dependency><groupId>com.mysql</groupId><artifactId>mysql-connector-j</artifactId><version>8.3.0</version></dependency>
導入Druid 包依賴
<!-- 數據庫連接池 --><!-- https://mvnrepository.com/artifact/com.alibaba/druid --><dependency><groupId>com.alibaba</groupId><artifactId>druid</artifactId><version>1.2.22</version></dependency>
Mybatis
導入Mybatis-Spring 橋接包 依賴
<!--mybatis和spring的橋接包:僅起到橋接作用,還需要導入Mybatis核心包--><!-- https://mvnrepository.com/artifact/org.mybatis/mybatis-spring --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis-spring</artifactId><version>2.1.2</version></dependency>
導入Mybatis 核心包 依賴
<!-- Mybatis 核心 依賴 --><!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.16</version></dependency>
Spring
導入Spring 核心包依賴
<dependencies><!-- 導入Spring核心包 Beans、Core、Context、Expression--><!-- https://mvnrepository.com/artifact/org.springframework/spring-core --><dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-beans</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-expression</artifactId><version>${spring.version}</version></dependency>
導入Spring JDBC相關包依賴(內部依賴Spring-tx事務包):為了操作數據庫事務
<!--Spring-JDBC:內含簡單實現的JDBC操作(JDBCTemplate),及Spring事務管理器Spring-TX:Spring 事務Spring-JDBC 依賴了Spring-TX,因此無需再另外導入依賴--><!-- https://mvnrepository.com/artifact/org.springframework/spring-jdbc --><dependency><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>${spring.version}</version></dependency>
創建并配置Spring配置文件
<?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"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd"><context:component-scan base-package="icu.lking.demo2"><context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/></context:component-scan><!-- 引入外部properties配置文件 --><context:property-placeholder location="classpath:jdbc.properties"/><!-- 注入Druid連接池 --><bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/><property name="driverClassName" value="${jdbc.driver}"/><property name="minIdle" value="3"/><property name="initialSize" value="3"/><property name="maxActive" value="10"/><property name="filters" value="stat"/></bean><!--Spring中有兩種類型的Bean:普通Bean(開發者自己創建)、工廠Bean(FactoryBean)。主要區別普通Bean:在配置文件中定義的Bean類型(class中指定)就是獲取bean得到的類型。工廠Bean:在配置文件中定義的Bean類型(class中指定)可以和獲取bean類型不一致。--><!-- 工廠Bean:獲取sqlSessionFactory ,Mybatis-Spring 橋街包 提供--><bean id="sqlSessionFactoryBean" class="org.mybatis.spring.SqlSessionFactoryBean"><!--==========【指定配置文件方式】==========--><!-- 通過指定xml配置文件的方式創建SqlSessionFactory --><!--<property name="configLocation" value="classpath:mybatis-config.xml"/>--><!--====================================--><!-- 將Druid數據源注入 --><property name="dataSource" ref="dataSource"/><!-- 別名:降低冗余的全限定類名書寫 --><property name="typeAliasesPackage" value="icu.lking.demo2.entity"/><!-- Settings --><property name="configurationProperties"><props><!-- 設置自動轉換 下劃線風格的字段名 為 駝峰命名格式 --><prop key="mapUnderscoreToCamelCase">true</prop></props></property><!--設置映射文件的路徑若映射文件所在路徑和mapper接口所在路徑一致,則不需要設置--><property name="mapperLocations" value="classpath:mapper/*.xml"/></bean><!--配置mapper接口的掃描配置由mybatis-spring提供,可以將指定包下所有的mapper接口創建動態代理并將這些動態代理作為IOC容器的bean管理--><bean id="mapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer"><property name="basePackage" value="icu.lking.demo2.mapper"/></bean><!-- 注入Spring事務管理器 --><bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"><!-- 將 Druid連接池的數據源對象 交由 Spring事務管理器管理 --><property name="dataSource" ref="dataSource"/></bean><!-- 配置事務注解,指定其事務管理器, 如果是默認名字,可以忽略,但是建議寫出id --><tx:annotation-driven transaction-manager="transactionManager"/>
</beans>
Spring MVC 相關部分
Thymeleaf
導入 Thymeleaf + Spring 整合包 依賴
<!-- thymeleaf與Spring5的整合包 --><!-- https://mvnrepository.com/artifact/org.thymeleaf/thymeleaf-spring5 --><dependency><groupId>org.thymeleaf</groupId><artifactId>thymeleaf-spring5</artifactId><version>3.1.0.RELEASE</version></dependency>
Spring MVC
導入 Spring MVC 依賴
<!-- Spring Web 模塊依賴, 包含 在服務器啟動時初始化Spring IOC容器的 監聽器:ContextLoaderListener --><!-- <dependency>--><!-- <groupId>org.springframework</groupId>--><!-- <artifactId>spring-web</artifactId>--><!-- <version>${spring.version}</version>--><!-- </dependency>--><!--Spring Web: 提供了基于Spring的Web服務的基礎架構,包括核心的HTTP集成、Servlet過濾器、Spring HTTP Invoker等。它還支持與其他Web框架和HTTP技術(如Hessian、Burlap)的集成。Spring Web MVC: 是Spring MVC的一個實現,它依賴于Spring Web,并在此基礎上增加了對Spring MVC的支持,包括RESTful協議、國際化等模塊。因此,導入Spring-webmvc依賴 便無需導入Spring-web依賴,因為其已經依賴了Spring-web--><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>${spring.version}</version></dependency>
spring-webmvc和spring-web有什么區別
- Spring Web: 提供了基于Spring的Web服務的基礎架構,包括核心的HTTP集成、Servlet過濾器、Spring HTTP Invoker等。它還支持與其他Web框架和HTTP技術(如Hessian、Burlap)的集成。
注:Spring Web模塊中包含了在服務器啟動時初始化Spring IOC容器的監聽器:
ContextLoaderListener
- Spring Web MVC: 是Spring MVC的一個實現,它依賴于Spring Web,并在此基礎上增加了對Spring MVC的支持,包括RESTful協議、國際化等模塊。
創建并配置Spring MVC配置文件
<?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:mvc="http://www.springframework.org/schema/mvc"xmlns:context="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd"><context:component-scan base-package="icu.lking.demo2.controller"/><!-- 注入Thymeleaf視圖解析器,并配置 --><bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver"><!-- 設置該視圖解析器優先級 --><property name="order" value="1"/><!-- 視圖解析編碼 --><property name="characterEncoding" value="UTF-8"/><!-- 模板引擎 --><property name="templateEngine"><bean class="org.thymeleaf.spring5.SpringTemplateEngine"><property name="templateResolver"><bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver"><!-- 視圖前綴:請求響應的資源的路徑的配置 --><property name="prefix" value="/WEB-INF/templates/"/><!-- 視圖后綴 --><!-- 視圖邏輯位置:視圖前綴+視圖名稱+視圖后綴,所以開發者使用時只需提供視圖名 --><property name="suffix" value=".html"/><!-- 模板類型 --><!--Thymeleaf + Spring 官方文檔:https://www.thymeleaf.org/doc/tutorials/3.1/thymeleafspring.html--><property name="templateMode" value="HTML"/><!-- 編碼 --><property name="characterEncoding" value="UTF-8" /></bean></property></bean></property></bean><!-- 設置默認頁視圖解析器 --><!--注意:當SpringMVC中設置任何一個view-controller時,其他控制器中的請求映射將全部失效(404),此時需要在SpringMVC的核心配置文件中設置開啟mvc注解驅動的標簽:<mvc:annotation-driven />--><mvc:view-controller path="/" view-name="index"/><!--Tomcat 的默認web.xml中默認配置了 DefaultServlet與JSPServlet(匹配:*.jsp與*.jspx的請求),其中DefaultServlet為默認Servlet,一般用來處理對靜態文件的請求,匹配路徑為:/,由于在本項目中配置SpringMVC的DispatcherServlet前端控制器的匹配路徑也為:/(Spring MVC將捕獲Web容器所有的請求,包括靜態資源的請求),所以DefaultServlet會失效,所以SpringMVC需要:如果發現是靜態資源的請求,就將該請求轉由Web應用服務器默認的Servlet處理,如果不是靜態資源的請求,才由DispatcherServlet繼續處理。--><mvc:default-servlet-handler/><!--注意:1. 開啟視圖控制器<mvc:view-controller>后,如果不開啟注解驅動,則SpringMVC的控制器匹配路徑都會失效。2. 開啟默認Servlet處理器<mvc:default-servlet-handler>后,如果不開啟注解驅動,則SpringMVC的控制器匹配路徑都會失效。3. 開啟annotation-driven后,其也會自動裝配消息轉換器--><mvc:annotation-driven/>
</beans>
Tomcat
配置web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"version="4.0"><!--================================【Spring MVC】=====================================--><!-- 編碼過濾器 --><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><!-- POST請求下 根據_method隱藏值 來轉換對應請求方法的過濾器 --><filter><filter-name>HiddenMethodFilter</filter-name><filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class></filter><filter-mapping><filter-name>HiddenMethodFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping><servlet><servlet-name>DispatcherServlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!-- SpringMVC的配置文件位置,如果不指定,則默認位于WEB-INF下,默認名稱為<servlet-name>-servlet.xml --><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:SpringMVC.xml</param-value></init-param><!-- 當值為0或者大于0時,表示 容器在 應用啟動時 就加載這個servlet;當是一個負數時或者沒有指定時,則指示容器在該servlet被選擇時才加載。 --><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>DispatcherServlet</servlet-name><!--servlet的url-pattern設置為/時, 它僅替換servlet容器的默認內置servlet,用于處理所有與其他注冊的servlet不匹配的請求。直白點說就是,所有靜態資源(js,css,image,html等)的訪問都將交給該servlet處理,而jsp頁面則交給servlet容器內置的JSP servlet處理。servlet的url-pattern設置為/*時,它會覆蓋其他所有的servlet,包括servlet容器提供的所有servlet,如缺省servlet和JSP servlet。 無論你發出什么請求,都會在該servlet攔截處理。通常我們不會這么做。如果你只是想使用/*,那么你可以在Filter中使用,它處理完后會將url交給servlet處理。--><url-pattern>/</url-pattern></servlet-mapping><!--Spring提供了監聽器ContextLoaderListener,實現ServletContextListener接口,可監聽ServletContext的狀態,在web服務器的啟動時,讀取Spring的配置文件,創建Spring的IOC容器。--><!--==================================【Spring】=============================================--><!-- 用于在 Spring MVC IOC 容器 創建之前,創建 Spring IOC 容器 --><listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener><!-- Spring 配置文件位置,如果不指定,則默認在WEB-INF下,名稱固定為:applicationContext.xml --><context-param><param-name>contextConfigLocation</param-name><param-value>classpath:Spring.xml</param-value></context-param>
</web-app>