手把手教你整合最優雅SSM框架 SpringMVC + Spring + MyBatis
我們看招聘資訊的時候,經常會看到這一點,需要具備SSH框架的技能;而且在大部分教學課堂中,也會把SSH作為最核心的教學內容。
但是,我們在實際應用中發現,SpringMVC可以完全替代Struts,配合註解的方式,程式設計非常快捷,而且通過restful風格定義url,讓地址看起來非常優雅。
另外,MyBatis也可以替換Hibernate,正因為MyBatis的半自動特點,我們程式猿可以完全掌控SQL,這會讓有資料庫經驗的程式猿能開發出高效率的SQL語句,而且XML配置管理起來也非常方便。
好了,如果你也認同我的看法,那麼下面我們一起來做整合吧!
在寫程式碼之前我們先了解一下這三個框架分別是幹什麼的?
相信大以前也看過不少這些概念,我這就用大白話來講,如果之前有了解過可以跳過這一大段,直接看程式碼!
SpringMVC:它用於web層,相當於controller(等價於傳統的servlet和struts的action),用來處理使用者請求。舉個例子,使用者在位址列輸入http://網站域名/login,那麼springmvc就會攔截到這個請求,並且呼叫controller層中相應的方法,(中間可能包含驗證使用者名稱和密碼的業務邏輯,以及查詢資料庫操作,但這些都不是springmvc的職責),最終把結果返回給使用者,並且返回相應的頁面(當然也可以只返回json/xml等格式資料)。springmvc就是做前面和後面過程的活,與使用者打交道!!
Spring:太強大了,以至於我無法用一個詞或一句話來概括它。但與我們平時開發接觸最多的估計就是IOC容器,它可以裝載bean(也就是我們java中的類,當然也包括service dao裡面的),有了這個機制,我們就不用在每次使用這個類的時候為它初始化,很少看到關鍵字new。另外spring的aop,事務管理等等都是我們經常用到的。
MyBatis:如果你問我它跟鼎鼎大名的Hibernate有什麼區別?我只想說,他更符合我的需求。第一,它能自由控制sql,這會讓有資料庫經驗的人(當然不是說我啦~捂臉~)編寫的程式碼能搞提升資料庫訪問的效率。第二,它可以使用xml的方式來組織管理我們的sql,因為一般程式出錯很多情況下是sql出錯,別人接手程式碼後能快速找到出錯地方,甚至可以優化原來寫的sql。
SSM框架整合配置
好了,前面bb那麼多,下面我們真正開始敲程式碼了~
首先我們開啟IED,我這裡用的是eclipse(你們應該也是用的這個,對嗎?),建立一個動態web專案,建立好相應的目錄結構(重點!)
(打了馬賽克是因為這裡還用不到,你們不要那麼汙好不好?)
我說一下每個目錄都有什麼用吧(第一次畫表格,我發現markdown的表格語法很不友好呀~)
這個目錄結構同時也遵循maven的目錄規範~
檔名 | 作用 |
---|---|
src | 根目錄,沒什麼好說的,下面有main和test。 |
|
主要目錄,可以放java程式碼和一些資原始檔。 |
|
存放我們的java程式碼,這個資料夾要使用Build Path -> Use as Source Folder,這樣看包結構會方便很多,新建的包就相當於在這裡新建資料夾咯。 |
|
存放資原始檔,譬如各種的spring,mybatis,log配置檔案。 |
|
存放dao中每個方法對應的sql,在這裡配置,無需寫daoImpl。 |
|
這裡當然是存放spring相關的配置檔案,有dao service web三層。 |
|
其實這個可以沒有,但是為了專案完整性還是加上吧。 |
|
這個貌似是最熟悉的目錄了,用來存放我們前端的靜態資源,如jsp js css。 |
|
這裡的資源是指專案的靜態資源,如js css images等。 |
|
很重要的一個目錄,外部瀏覽器無法訪問,只有羨慕內部才能訪問,可以把jsp放在這裡,另外就是web.xml了。你可能有疑問了,為什麼上面java中的resources裡面的配置檔案不妨在這裡,那麼是不是會被外部竊取到?你想太多了,部署時候基本上只有webapp裡的會直接輸出到根目錄,其他都會放入WEB-INF裡面,專案內部依然可以使用classpath:XXX來訪問,好像IDE裡可以設定部署輸出目錄,這裡扯遠了~ |
|
這裡是測試分支。 |
|
測試java程式碼,應遵循包名相同的原則,這個資料夾同樣要使用Build Path -> Use as Source Folder,這樣看包結構會方便很多。 |
|
沒什麼好說的,好像也很少用到,但這個是maven的規範。 |
我先新建好幾個必要的包,併為大家講解一下每個包的作用,順便理清一下後臺的思路~
包名 | 名稱 | 作用 |
---|---|---|
dao | 資料訪問層(介面) | 與資料打交道,可以是資料庫操作,也可以是檔案讀寫操作,甚至是redis快取操作,總之與資料操作有關的都放在這裡,也有人叫做dal或者資料持久層都差不多意思。為什麼沒有daoImpl,因為我們用的是mybatis,所以可以直接在配置檔案中實現介面的每個方法。 |
entity | 實體類 | 一般與資料庫的表相對應,封裝dao層取出來的資料為一個物件,也就是我們常說的pojo,一般只在dao層與service層之間傳輸。 |
dto | 資料傳輸層 | 剛學框架的人可能不明白這個有什麼用,其實就是用於service層與web層之間傳輸,為什麼不直接用entity(pojo)?其實在實際開發中發現,很多時間一個entity並不能滿足我們的業務需求,可能呈現給使用者的資訊十分之多,這時候就有了dto,也相當於vo,記住一定不要把這個混雜在entity裡面,答應我好嗎? |
service | 業務邏輯(介面) | 寫我們的業務邏輯,也有人叫bll,在設計業務介面時候應該站在“使用者”的角度。額,不要問我為什麼這裡沒顯示!IDE調皮我也拿它沒辦法~ |
serviceImpl | 業務邏輯(實現) | 實現我們業務介面,一般事務控制是寫在這裡,沒什麼好說的。 |
web | 控制器 | springmvc就是在這裡發揮作用的,一般人叫做controller控制器,相當於struts中的action。 |
還有最後一步基礎工作,匯入我們相應的jar包,我使用的是maven來管理我們的jar,所以只需要在pom.xml
中加入相應的依賴就好了,如果不使用maven的可以自己去官網下載相應的jar,放到專案WEB-INF/lib目錄下。關於maven的學習大家可以看慕課網的視訊教程,這裡就不展開了。我把專案用到的jar都寫在下面,版本都不是最新的,大家有經驗的話可以自己調整版本號。另外,所有jar都會與專案一起打包放到我的github上,喜歡的給個star吧~
pom.xml
<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.soecode.ssm</groupId> <artifactId>ssm</artifactId> <packaging>war</packaging> <version>0.0.1-SNAPSHOT</version> <name>ssm Maven Webapp</name> <url>http://github.com/liyifeng1994/ssm</url> <dependencies> <!-- 單元測試 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> </dependency> <!-- 1.日誌 --> <!-- 實現slf4j介面並整合 --> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>1.1.1</version> </dependency> <!-- 2.資料庫 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.37</version> <scope>runtime</scope> </dependency> <dependency> <groupId>c3p0</groupId> <artifactId>c3p0</artifactId> <version>0.9.1.2</version> </dependency> <!-- DAO: MyBatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.3.0</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.2.3</version> </dependency> <!-- 3.Servlet web --> <dependency> <groupId>taglibs</groupId> <artifactId>standard</artifactId> <version>1.1.2</version> </dependency> <dependency> <groupId>jstl</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.5.4</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> </dependency> <!-- 4.Spring --> <!-- 1)Spring核心 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>4.1.7.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>4.1.7.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>4.1.7.RELEASE</version> </dependency> <!-- 2)Spring DAO層 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>4.1.7.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-tx</artifactId> <version>4.1.7.RELEASE</version> </dependency> <!-- 3)Spring web --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>4.1.7.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.1.7.RELEASE</version> </dependency> <!-- 4)Spring test --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <version>4.1.7.RELEASE</version> </dependency> <!-- redis客戶端:Jedis --> <dependency> <groupId>redis.clients</groupId> <artifactId>jedis</artifactId> <version>2.7.3</version> </dependency> <dependency> <groupId>com.dyuproject.protostuff</groupId> <artifactId>protostuff-core</artifactId> <version>1.0.8</version> </dependency> <dependency> <groupId>com.dyuproject.protostuff</groupId> <artifactId>protostuff-runtime</artifactId> <version>1.0.8</version> </dependency> <!-- Map工具類 --> <dependency> <groupId>commons-collections</groupId> <artifactId>commons-collections</artifactId> <version>3.2</version> </dependency> </dependencies> <build> <finalName>ssm</finalName> </build></project>
下面真的要開始進行編碼工作了,堅持到這裡辛苦大家了~
第一步:我們先在spring
資料夾裡新建spring-dao.xml
檔案,因為spring的配置太多,我們這裡分三層,分別是dao service web。
- 讀入資料庫連線相關引數(可選)
- 配置資料連線池
- 配置連線屬性,可以不讀配置項檔案直接在這裡寫死
- 配置c3p0,只配了幾個常用的
- 配置SqlSessionFactory物件(mybatis)
- 掃描dao層介面,動態實現dao介面,也就是說不需要daoImpl,sql和引數都寫在xml檔案上
spring-dao.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.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <!-- 配置整合mybatis過程 --> <!-- 1.配置資料庫相關引數properties的屬性:${url} --> <context:property-placeholder location="classpath:jdbc.properties" /> <!-- 2.資料庫連線池 --> <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"> <!-- 配置連線池屬性 --> <property name="driverClass" value="${jdbc.driver}" /> <property name="jdbcUrl" value="${jdbc.url}" /> <property name="user" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> <!-- c3p0連線池的私有屬性 --> <property name="maxPoolSize" value="30" /> <property name="minPoolSize" value="10" /> <!-- 關閉連線後不自動commit --> <property name="autoCommitOnClose" value="false" /> <!-- 獲取連線超時時間 --> <property name="checkoutTimeout" value="10000" /> <!-- 當獲取連線失敗重試次數 --> <property name="acquireRetryAttempts" value="2" /> </bean> <!-- 3.配置SqlSessionFactory物件 --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <!-- 注入資料庫連線池 --> <property name="dataSource" ref="dataSource" /> <!-- 配置MyBaties全域性配置檔案:mybatis-config.xml --> <property name="configLocation" value="classpath:mybatis-config.xml" /> <!-- 掃描entity包 使用別名 --> <property name="typeAliasesPackage" value="com.soecode.lyf.entity" /> <!-- 掃描sql配置檔案:mapper需要的xml檔案 --> <property name="mapperLocations" value="classpath:mapper/*.xml" /> </bean> <!-- 4.配置掃描Dao介面包,動態實現Dao介面,注入到spring容器中 --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <!-- 注入sqlSessionFactory --> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" /> <!-- 給出需要掃描Dao介面包 --> <property name="basePackage" value="com.soecode.lyf.dao" /> </bean></beans>
因為資料庫配置相關引數是讀取配置檔案,所以在resources
資料夾裡新建一個jdbc.properties
檔案,存放我們4個最常見的資料庫連線屬性,這是我本地的,大家記得修改呀~還有喜歡傳到github上“大頭蝦們”記得刪掉密碼,不然別人就很容易得到你伺服器的資料庫配置資訊,然後幹一些羞羞的事情,你懂的!!
jdbc.properties
jdbc.driver=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3307/ssm?useUnicode=true&characterEncoding=utf8jdbc.username=rootjdbc.password=
友情提示:配置檔案中的jdbc.username,如果寫成username,可能會與系統環境中的username變數衝突,所以到時候真正連線資料庫的時候,使用者名稱就被替換成系統中的使用者名稱(有得可能是administrator),那肯定是連線不成功的,這裡有個小坑,我被坑了一晚上!!
因為這裡用到了mybatis,所以需要配置mybatis核心檔案,在recources
資料夾裡新建mybatis-config.xml
檔案。
- 使用自增主鍵
- 使用列別名
- 開啟駝峰命名轉換 create_time -> createTime
mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration> <!-- 配置全域性屬性 --> <settings> <!-- 使用jdbc的getGeneratedKeys獲取資料庫自增主鍵值 --> <setting name="useGeneratedKeys" value="true" /> <!-- 使用列別名替換列名 預設:true --> <setting name="useColumnLabel" value="true" /> <!-- 開啟駝峰命名轉換:Table{create_time} -> Entity{createTime} --> <setting name="mapUnderscoreToCamelCase" value="true" /> </settings></configuration>
第二步:剛弄好dao層,接下來到service層了。在spring
資料夾裡新建spring-service.xml
檔案。
- 掃描service包所有註解 @Service
- 配置事務管理器,把事務管理交由spring來完成
- 配置基於註解的宣告式事務,可以直接在方法上@Transaction
spring-service.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" 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"> <!-- 掃描service包下所有使用註解的型別 --> <context:component-scan base-package="com.soecode.lyf.service" /> <!-- 配置事務管理器 --> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <!-- 注入資料庫連線池 --> <property name="dataSource" ref="dataSource" /> </bean> <!-- 配置基於註解的宣告式事務 --> <tx:annotation-driven transaction-manager="transactionManager" /></beans>
第三步:配置web層,在spring
資料夾裡新建spring-web.xml
檔案。
- 開啟SpringMVC註解模式,可以使用@RequestMapping,@PathVariable,@ResponseBody等
- 對靜態資源處理,如js,css,jpg等
- 配置jsp 顯示ViewResolver,例如在controller中某個方法返回一個string型別的”login”,實際上會返回”/WEB-INF/login.jsp”
- 掃描web層 @Controller
spring-web.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: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.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd"> <!-- 配置SpringMVC --> <!-- 1.開啟SpringMVC註解模式 --> <!-- 簡化配置: (1)自動註冊DefaultAnootationHandlerMapping,AnotationMethodHandlerAdapter (2)提供一些列:資料繫結,數字和日期的format @NumberFormat, @DateTimeFormat, xml,json預設讀寫支援 --> <mvc:annotation-driven /> <!-- 2.靜態資源預設servlet配置 (1)加入對靜態資源的處理:js,gif,png (2)允許使用"/"做整體對映 --> <mvc:default-servlet-handler/> <!-- 3.配置jsp 顯示ViewResolver --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="viewClass" value="org.springframework.web.servlet.view.JstlView" /> <property name="prefix" value="/WEB-INF/jsp/" /> <property name="suffix" value=".jsp" /> </bean> <!-- 4.掃描web相關的bean --> <context:component-scan base-package="com.soecode.lyf.web" /></beans>
第四步:最後就是修改web.xml
檔案了,它在webapp
的WEB-INF
下。
web.xml
<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_3_1.xsd" version="3.1" metadata-complete="true"> <!-- 如果是用mvn命令生成的xml,需要修改servlet版本為3.1 --> <!-- 配置DispatcherServlet --> <servlet> <servlet-name>seckill-dispatcher</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <!-- 配置springMVC需要載入的配置檔案 spring-dao.xml,spring-service.xml,spring-web.xml Mybatis - > spring -> springmvc --> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring/spring-*.xml</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>seckill-dispatcher</servlet-name> <!-- 預設匹配所有的請求 --> <url-pattern>/</url-pattern> </servlet-mapping></web-app>
我們在專案中經常會使用到日誌,所以這裡還有配置日誌xml,在resources
資料夾裡新建logback.xml
檔案,所給出的日誌輸出格式也是最基本的控制檯s撥出,大家有興趣檢視logback官方文件。
logback.xml
<?xml version="1.0" encoding="UTF-8"?><configuration debug="true"> <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <!-- encoders are by default assigned the type ch.qos.logback.classic.encoder.PatternLayoutEncoder --> <encoder> <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern> </encoder> </appender> <root level="debug"> <appender-ref ref="STDOUT" /> </root></configuration>
到目前為止,我們一共寫了7個配置檔案,我們一起來看下最終的配置檔案結構圖。
SSM框架應用例項(圖書管理系統)
一開始想就這樣結束教程,但是發現其實很多人都還不會把這個SSM框架用起來,特別是mybatis部分。那我現在就以最常見的“圖書管理系統”中【查詢圖書】和【預約圖書】業務來做一個demo吧!
首先新建資料庫名為ssm
,再建立兩張表:圖書表book
和預約圖書表appointment
,並且為book
表初始化一些資料,sql如下。
schema.sql
-- 建立圖書表CREATE TABLE `book` ( `book_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '圖書ID', `name` varchar(100) NOT NULL COMMENT '圖書名稱', `number` int(11) NOT NULL COMMENT '館藏數量', PRIMARY KEY (`book_id`)) ENGINE=InnoDB AUTO_INCREMENT=1000 DEFAULT CHARSET=utf8 COMMENT='圖書