SSM框架——詳細整合教程（Spring+SpringMVC+MyBatis）

使用SSM（Spring、SpringMVC和Mybatis）已經有6個多月了，專案在技術上已經沒有什么難點了，基于現有的技術就可以實作想要的功能，當然肯定有很多可以改進的地方，之前沒有記錄SSM整合的程序，這次剛剛好基于自己的一個小專案重新搭建了一次，而且比專案搭建的要更好一些，以前解決問題的程序和方法并沒有及時記錄，以后在自己的小專案中遇到我再整理分享一下，這次，先說說三大框架整合程序，個人認為使用框架并不是很難，關鍵要理解其思想，這對于我們提高編程水平很有幫助，不過，如果用都不會，談思想就變成紙上談兵了！！！先技術，再思想，實踐出真知，

1、基本概念

1.1、Spring

    Spring是一個開源框架，Spring是于2003 年興起的一個輕量級的Java 開發框架，由Rod Johnson 在其著作Expert One-On-One J2EE Development and Design中闡述的部分理念和原型衍生而來，它是為了解決企業應用開發的復雜性而創建的，Spring使用基本的JavaBean來完成以前只可能由EJB完成的事情，然而，Spring的用途不僅限于服務器端的開發，從簡單性、可測驗性和松耦合的角度而言，任何Java應用都可以從Spring中受益， 簡單來說，Spring是一個輕量級的控制反轉（IoC）和面向切面（AOP）的容器框架，

1.2、SpringMVC

    Spring MVC屬于SpringFrameWork的后續產品，已經融合在Spring Web Flow里面，Spring MVC 分離了控制器、模型物件、分派器以及處理程式物件的角色，這種分離讓它們更容易進行定制，

1.3、MyBatis

   MyBatis 本是apache的一個開源專案iBatis, 2010年這個專案由apache software foundation 遷移到了google code，并且改名為MyBatis ，MyBatis是一個基于Java的持久層框架，iBATIS提供的持久層框架包括SQL Maps和Data Access Objects（DAO）MyBatis 消除了幾乎所有的JDBC代碼和引數的手工設定以及結果集的檢索，MyBatis 使用簡單的 XML或注解用于配置和原始映射，將介面和 Java 的POJOs（Plain Old Java Objects，普通的 Java物件）映射成資料庫中的記錄，

2、開發環境搭建

如果需要，參看之前的博文：http://blog.csdn.net/zhshulin/article/details/30779873

3、Maven Web專案創建

4、SSM整合

    下面主要介紹三大框架的整合，至于環境的搭建以及專案的創建，參看上面的博文，這次整合我分了2個組態檔，分別是spring-mybatis.xml，包含spring和mybatis的組態檔，還有個是spring-mvc的組態檔，此外有2個資源檔案：jdbc.propertis和log4j.properties，完整目錄結構如下（最后附上原始碼下載地址，不建議直接使用原始碼，因為此教程已經有了全部代碼）：

使用框架都是較新的版本：

   Spring 4.0.2 RELEASE

   Spring MVC 4.0.2 RELEASE

   MyBatis 3.2.6

4.1、Maven引入需要的JAR包
為了方便后面說的時候不需要引入JAR包，我這里直接給出所有需要的JAR包，這都是基本的JAR包，每個包的是干什么的都有注釋，就不再多說了，

pom.xml

4.2、Spring與MyBatis的整合
所有需要的JAR包都引入以后，首先進行Spring與MyBatis的整合，然后再進行JUnit測驗，先看一個專案結構圖：

4.2.1、建立JDBC屬性檔案
jdbc.properties（檔案編碼修改為utf-8）

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://10.221.10.111:8080/db_zsl
username=demao
password=demao
#定義初始連接數
initialSize=0
#定義最大連接數
maxActive=20
#定義最大空閑
maxIdle=20
#定義最小空閑
minIdle=1
#定義最長等待時間
maxWait=60000

4.2.2、建立spring-mybatis.xml組態檔
這個檔案就是用來完成spring和mybatis的整合的，這里面也沒多少行配置，主要的就是自動掃描，自動注入，配置資料庫，注釋也很詳細，大家看看就明白了，

spring-mybatis.xml

<context:component-scan base-package=“com.cn.hnust” />

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
	destroy-method="close">
	<property name="driverClassName" value="${driver}" />
	<property name="url" value="${url}" />
	<property name="username" value="${username}" />
	<property name="password" value="${password}" />
	<!-- 初始化連接大小 -->
	<property name="initialSize" value="${initialSize}"></property>
	<!-- 連接池最大數量 -->
	<property name="maxActive" value="${maxActive}"></property>
	<!-- 連接池最大空閑 -->
	<property name="maxIdle" value="${maxIdle}"></property>
	<!-- 連接池最小空閑 -->
	<property name="minIdle" value="${minIdle}"></property>
	<!-- 獲取連接最大等待時間 -->
	<property name="maxWait" value="${maxWait}"></property>
</bean>

<!-- spring和MyBatis完美整合，不需要mybatis的配置映射檔案 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
	<property name="dataSource" ref="dataSource" />
	<!-- 自動掃描mapping.xml檔案 -->
	<property name="mapperLocations" value="classpath:com/cn/hnust/mapping/*.xml"></property>
</bean>

<!-- DAO介面所在包名，Spring會自動查找其下的類 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
	<property name="basePackage" value="com.cn.hnust.dao" />
	<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
</bean>

<!-- (事務管理)transaction manager, use JtaTransactionManager for global tx -->
<bean id="transactionManager"
	class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
	<property name="dataSource" ref="dataSource" />
</bean>

4.2.3、Log4j的配置

  為了方便除錯，一般都會使用日志來輸出資訊，Log4j是Apache的一個開放源代碼專案，通過使用Log4j，我們可以控制日志資訊輸送的目的地是控制臺、檔案、GUI組件，甚至是套介面服務器、NT的事件記錄器、UNIX Syslog守護行程等；我們也可以控制每一條日志的輸出格式；通過定義每一條日志資訊的級別，我們能夠更加細致地控制日志的生成程序，

  Log4j的配置很簡單，而且也是通用的，下面給出一個基本的配置，換到其他專案中也無需做多大的調整，如果想做調整或者想了解Log4j的各種配置，參看我轉載的一篇博文，很詳細：

http://blog.csdn.net/zhshulin/article/details/37937365

下面給出組態檔目錄：

log4j.properties

#定義LOG輸出級別
log4j.rootLogger=INFO,Console,File
#定義日志輸出目的地為控制臺
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.Target=System.out
#可以靈活地指定日志輸出格式，下面一行是指定具體的格式
log4j.appender.Console.layout = org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=[%c] - %m%n

#檔案大小到達指定尺寸的時候產生一個新的檔案
log4j.appender.File = org.apache.log4j.RollingFileAppender
#指定輸出目錄
log4j.appender.File.File = logs/ssm.log
#定義檔案最大大小
log4j.appender.File.MaxFileSize = 10MB

log4j.appender.File.Threshold = ALL
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =[%p] [%d{yyyy-MM-dd HH:mm:ss}][%c]%m%n

4.2.4、JUnit測驗

  經過以上步驟（到4.2.2，log4j不配也沒影響），我們已經完成了Spring和mybatis的整合，這樣我們就可以撰寫一段測驗代碼來試試是否成功了，

4.2.4.1、創建測驗用表
既然我們需要測驗，那么我們就需要建立在資料庫中建立一個測驗表，這個表建的很簡單，SQL陳述句為：

DROP TABLE IF EXISTS user_t;

CREATE TABLE user_t (
id int(11) NOT NULL AUTO_INCREMENT,
user_name varchar(40) NOT NULL,
password varchar(255) NOT NULL,
age int(4) NOT NULL,
PRIMARY KEY (id)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;

/*Data for the table user_t */

insert into user_t(id,user_name,password,age) values (1,‘測驗’,‘sfasgfaf’,24);

4.2.4.2、利用MyBatis Generator自動創建代碼
參考博文：http://blog.csdn.net/zhshulin/article/details/23912615

   這個可根據表自動創建物體類、MyBatis映射檔案以及DAO介面，當然，我習慣將生成的介面名改為IUserDao，而不是直接用它生成的UserMapper，如果不想麻煩就可以不改，完成后將檔案復制到工程中，如圖：

4.2.4.3、建立Service介面和實作類
目錄結構：

下面給出具體的內容：

IUserService.jave

package com.cn.hnust.service;

import com.cn.hnust.pojo.User;

public interface IUserService {
public User getUserById(int userId);
}

UserServiceImpl.java
package com.cn.hnust.service.impl;

import javax.annotation.Resource;

import org.springframework.stereotype.Service;

import com.cn.hnust.dao.IUserDao;
import com.cn.hnust.pojo.User;
import com.cn.hnust.service.IUserService;

@Service(“userService”)
public class UserServiceImpl implements IUserService {
@Resource
private IUserDao userDao;
@Override
public User getUserById(int userId) {
// TODO Auto-generated method stub
return this.userDao.selectByPrimaryKey(userId);
}

}

4.2.4.4、建立測驗類
測驗類在src/test/java中建立，下面測驗類中注釋掉的部分是不使用Spring時，一般情況下的一種測驗方法；如果使用了Spring那么就可以使用注解的方式來引入組態檔和類，然后再將service介面物件注入，就可以進行測驗了，

   如果測驗成功，表示Spring和Mybatis已經整合成功了，輸出資訊使用的是Log4j列印到控制臺，

package org.zsl.testmybatis;

import javax.annotation.Resource;

import org.apache.log4j.Logger;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import com.alibaba.fastjson.JSON;
import com.cn.hnust.pojo.User;
import com.cn.hnust.service.IUserService;

@RunWith(SpringJUnit4ClassRunner.class) //表示繼承了SpringJUnit4ClassRunner類
@ContextConfiguration(locations = {“classpath:spring-mybatis.xml”})

public class TestMyBatis {
private static Logger logger = Logger.getLogger(TestMyBatis.class);
// private ApplicationContext ac = null;
@Resource
private IUserService userService = null;

// @Before
// public void before() {
// ac = new ClassPathXmlApplicationContext(“applicationContext.xml”);
// userService = (IUserService) ac.getBean(“userService”);
// }

@Test
public void test1() {
	User user = userService.getUserById(1);
	// System.out.println(user.getUserName());
	// logger.info("值："+user.getUserName());
	logger.info(JSON.toJSONString(user));
}

}

測驗結果：

至此，完成Spring和mybatis這兩大框架的整合，下面在繼續進行SpringMVC的整合，

4.3、整合SpringMVC
上面已經完成了2大框架的整合，SpringMVC的組態檔單獨放，然后在web.xml中配置整合，

4.3.1、配置spring-mvc.xml
配置里面的注釋也很詳細，在此就不說了，主要是自動掃描控制器，視圖模式，注解的啟動這三個，

<context:component-scan base-package=“com.cn.hnust.controller” />




text/html;charset=UTF-8

<!-- 組態檔上傳，如果沒有使用檔案上傳可以不用配置，當然如果不配，那么組態檔中也不必引入上傳組件包 -->
<bean id="multipartResolver"  
    class="org.springframework.web.multipart.commons.CommonsMultipartResolver">  
    <!-- 默認編碼 -->
    <property name="defaultEncoding" value="utf-8" />  
    <!-- 檔案大小最大值 -->
    <property name="maxUploadSize" value="10485760000" />  
    <!-- 記憶體中的最大值 -->
    <property name="maxInMemorySize" value="40960" />  
</bean> 

4.3.2、配置web.xml檔案
這里面對spring-mybatis.xml的引入以及配置的spring-mvc的Servlet就是為了完成SSM整合，之前2框架整合不需要在此處進行任何配置，配置一樣有詳細注釋，不多解釋了，

web.xml

Archetype Created Web Application


contextConfigLocation
classpath:spring-mybatis.xml



encodingFilter
org.springframework.web.filter.CharacterEncodingFilter
true

encoding
UTF-8



encodingFilter
/*



org.springframework.web.context.ContextLoaderListener



org.springframework.web.util.IntrospectorCleanupListener

<!-- Spring MVC servlet -->
<servlet>
	<servlet-name>SpringMVC</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>
	<async-supported>true</async-supported>
</servlet>
<servlet-mapping>
	<servlet-name>SpringMVC</servlet-name>
	<!-- 此處可以可以配置成*.do，對應struts的后綴習慣 -->
	<url-pattern>/</url-pattern>
</servlet-mapping>
<welcome-file-list>
	<welcome-file>/index.jsp</welcome-file>
</welcome-file-list>

4.3.3、測驗
至此已經完成了SSM三大框架的整合了，接下來測驗一下，如果成功了，那么恭喜你，如果失敗了，繼續除錯吧，作為程式員就是不停的與BUG做斗爭！

4.3.3.1、新建jsp頁面

showUser.jsp 此頁面僅輸出一下用戶名，完成一個完整的簡單流程，

<%@ page language=“java” import=“java.util.*” pageEncoding=“utf-8”%>

4.3.3.2、建立UserController類
UserController.java 控制器

package com.cn.hnust.controller;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

import com.cn.hnust.pojo.User;
import com.cn.hnust.service.IUserService;

@Controller
@RequestMapping("/user")
public class UserController {
@Resource
private IUserService userService;

@RequestMapping("/showUser")
public String toIndex(HttpServletRequest request,Model model){
	int userId = Integer.parseInt(request.getParameter("id"));
	User user = this.userService.getUserById(userId);
	model.addAttribute("user", user);
	return "showUser";
}

}

4.3.3.3、部署專案
輸入地址：localhost:8080/專案名稱/user/showUser?id=1

至此，SSM三大框架的整合就完成了，在此基礎上可再添加其他功能，