1. 程式人生 > >手把手教你整合最優雅SSM框架 SpringMVC + Spring + MyBatis

手把手教你整合最優雅SSM框架 SpringMVC + Spring + MyBatis

                       
 

我們看招聘資訊的時候,經常會看到這一點,需要具備SSH框架的技能;而且在大部分教學課堂中,也會把SSH作為最核心的教學內容。
  但是,我們在實際應用中發現,SpringMVC可以完全替代Struts,配合註解的方式,程式設計非常快捷,而且通過restful風格定義url,讓地址看起來非常優雅。
  另外,MyBatis也可以替換Hibernate,正因為MyBatis的半自動特點,我們程式猿可以完全掌控SQL,這會讓有資料庫經驗的程式猿能開發出高效率的SQL語句,而且XML配置管理起來也非常方便。
  好了,如果你也認同我的看法,那麼下面我們一起來做整合吧!

在寫程式碼之前我們先了解一下這三個框架分別是幹什麼的?
相信大以前也看過不少這些概念,我這就用大白話來講,如果之前有了解過可以跳過這一大段,直接看程式碼!

  1. SpringMVC:它用於web層,相當於controller(等價於傳統的servlet和struts的action),用來處理使用者請求。舉個例子,使用者在位址列輸入http://網站域名/login,那麼springmvc就會攔截到這個請求,並且呼叫controller層中相應的方法,(中間可能包含驗證使用者名稱和密碼的業務邏輯,以及查詢資料庫操作,但這些都不是springmvc的職責),最終把結果返回給使用者,並且返回相應的頁面(當然也可以只返回json/xml等格式資料)。springmvc就是做前面和後面過程的活,與使用者打交道!!

  2. Spring:太強大了,以至於我無法用一個詞或一句話來概括它。但與我們平時開發接觸最多的估計就是IOC容器,它可以裝載bean(也就是我們java中的類,當然也包括service dao裡面的),有了這個機制,我們就不用在每次使用這個類的時候為它初始化,很少看到關鍵字new。另外spring的aop,事務管理等等都是我們經常用到的。

  3. MyBatis:如果你問我它跟鼎鼎大名的Hibernate有什麼區別?我只想說,他更符合我的需求。第一,它能自由控制sql,這會讓有資料庫經驗的人(當然不是說我啦~捂臉~)編寫的程式碼能搞提升資料庫訪問的效率。第二,它可以使用xml的方式來組織管理我們的sql,因為一般程式出錯很多情況下是sql出錯,別人接手程式碼後能快速找到出錯地方,甚至可以優化原來寫的sql。


SSM框架整合配置

好了,前面bb那麼多,下面我們真正開始敲程式碼了~

首先我們開啟IED,我這裡用的是eclipse(你們應該也是用的這個,對嗎?),建立一個動態web專案,建立好相應的目錄結構(重點!)

專案結構圖

(打了馬賽克是因為這裡還用不到,你們不要那麼汙好不好?)

我說一下每個目錄都有什麼用吧(第一次畫表格,我發現markdown的表格語法很不友好呀~)
這個目錄結構同時也遵循maven的目錄規範~

                                                       
檔名 作用
src 根目錄,沒什麼好說的,下面有main和test。
    main
主要目錄,可以放java程式碼和一些資原始檔。
      java
存放我們的java程式碼,這個資料夾要使用Build Path -> Use as Source Folder,這樣看包結構會方便很多,新建的包就相當於在這裡新建資料夾咯。
      resources
存放資原始檔,譬如各種的spring,mybatis,log配置檔案。
        mapper
存放dao中每個方法對應的sql,在這裡配置,無需寫daoImpl。
        spring
這裡當然是存放spring相關的配置檔案,有dao service web三層。
        sql
其實這個可以沒有,但是為了專案完整性還是加上吧。
        webapp
這個貌似是最熟悉的目錄了,用來存放我們前端的靜態資源,如jsp js css。
          resources
這裡的資源是指專案的靜態資源,如js css images等。
          WEB-INF
很重要的一個目錄,外部瀏覽器無法訪問,只有羨慕內部才能訪問,可以把jsp放在這裡,另外就是web.xml了。你可能有疑問了,為什麼上面java中的resources裡面的配置檔案不妨在這裡,那麼是不是會被外部竊取到?你想太多了,部署時候基本上只有webapp裡的會直接輸出到根目錄,其他都會放入WEB-INF裡面,專案內部依然可以使用classpath:XXX來訪問,好像IDE裡可以設定部署輸出目錄,這裡扯遠了~
    test
這裡是測試分支。
      java
測試java程式碼,應遵循包名相同的原則,這個資料夾同樣要使用Build Path -> Use as Source Folder,這樣看包結構會方便很多。
      resources
沒什麼好說的,好像也很少用到,但這個是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。

  1. 讀入資料庫連線相關引數(可選)
  2. 配置資料連線池
    1. 配置連線屬性,可以不讀配置項檔案直接在這裡寫死
    2. 配置c3p0,只配了幾個常用的
  3. 配置SqlSessionFactory物件(mybatis)
  4. 掃描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檔案。

  1. 使用自增主鍵
  2. 使用列別名
  3. 開啟駝峰命名轉換 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檔案。

  1. 掃描service包所有註解 @Service
  2. 配置事務管理器,把事務管理交由spring來完成
  3. 配置基於註解的宣告式事務,可以直接在方法上@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檔案。

  1. 開啟SpringMVC註解模式,可以使用@RequestMapping,@PathVariable,@ResponseBody等
  2. 對靜態資源處理,如js,css,jpg等
  3. 配置jsp 顯示ViewResolver,例如在controller中某個方法返回一個string型別的”login”,實際上會返回”/WEB-INF/login.jsp”
  4. 掃描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檔案了,它在webappWEB-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='圖書