SSM框架——详细整合教程(Spring+SpringMVC+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、开发环境搭建

如果需要，参看之前的博文：https://www.sodocs.net/doc/e718493449.html,/zhshulin/article/details/30779873

3、Maven Web项目创建

如果需要，参看之前的博文：https://www.sodocs.net/doc/e718493449.html,/zhshulin/article/details/37921705

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

[html]view plaincopyprint?

1.

2.

3.

4.0.2.RELEASE

4.

5.3.2.6

6.

7.1.7.7

8.1.2.17

9.

10.

11.

12.

13.junit

14.junit

15.4.11

16.

17.test

18.

19.

20.

21.org.springframework

22.spring-core

23.${spring.version}

24.

25.

26.

27.org.springframework

28.spring-web

29.${spring.version}

30.

31.

32.org.springframework

33.spring-oxm

34.${spring.version}

35.

36.

37.org.springframework

38.spring-tx

39.${spring.version}

40.

41.

42.

43.org.springframework

44.spring-jdbc

45.${spring.version}

46.

47.

48.

49.org.springframework

50.spring-webmvc

51.${spring.version}

52.

53.

54.org.springframework

55.spring-aop

56.${spring.version}

57.

58.

59.

60.org.springframework

61.spring-context-support

62.${spring.version}

63.

64.

65.

66.org.springframework

67.spring-test

68.${spring.version}

69.

70.

71.

72.org.mybatis

73.mybatis

74.${mybatis.version}

75.

76.

77.

78.org.mybatis

79.mybatis-spring

80.1.2.2

81.

82.

83.

84.javax

85.javaee-api

86.7.0

87.

88.

89.

90.mysql

91.mysql-connector-java

92.5.1.30

93.

94.

95.

96.commons-dbcp

97.commons-dbcp

98.1.2.2

99.

100.

101.

102.jstl

103.jstl

104.1.2

105.

106.

107.

108.

109.log4j

110.log4j

111.${log4j.version}

112.

113.

114.

115.

116.

117.com.alibaba

118.fastjson

119.1.1.41

120.

121.

122.

123.

124.org.slf4j

125.slf4j-api

126.${slf4j.version}

127.

128.

129.

130.org.slf4j

131.slf4j-log4j12 132.${slf4j.version}

133.

134.

135.

136.

137.org.codehaus.jackson 138.jackson-mapper-asl 139.1.9.13

140.

141.

142.

143.commons-fileupload 144.commons-fileupload 145.1.3.1

146.

147.

148.commons-io

149.commons-io

150.2.4

151.

152.

153.commons-codec

154.commons-codec

155.1.9

156.

157.

158.

159.

4.2、Spring与MyBatis的整合

所有需要的JAR包都引入以后，首先进行Spring与MyBatis的整合，然后再进行JUnit测试，先看一个项目结构图：

4.2.1、建立JDBC属性文件

jdbc.properties（文件编码修改为utf-8）

[html]view plaincopyprint?

1.driver=com.mysql.jdbc.Driver

2.url=jdbc:mysql://10.221.10.111:8080/db_zsl

https://www.sodocs.net/doc/e718493449.html,ername=demao

4.password=demao

5.#定义初始连接数

6.initialSize=0

7.#定义最大连接数

8.maxActive=20

9.#定义最大空闲

10.maxIdle=20

11.#定义最小空闲

12.minIdle=1

13.#定义最长等待时间

14.maxWait=60000

4.2.2、建立spring-mybatis.xml配置文件

这个文件就是用来完成spring和mybatis的整合的。这里面也没多少行配置，主要的就是自动扫描，自动注入，配置数据库。注释也很详细，大家看看就明白了。

spring-mybatis.xml

[html]view plaincopyprint?

1.

2.

3.xmlns:xsi="https://www.sodocs.net/doc/e718493449.html,/2001/XMLSchema-instance" xmlns:p="http://ww

https://www.sodocs.net/doc/e718493449.html,/schema/p"

4.xmlns:context="https://www.sodocs.net/doc/e718493449.html,/schema/context"

5.xmlns:mvc="https://www.sodocs.net/doc/e718493449.html,/schema/mvc"

6.xsi:schemaLocation="https://www.sodocs.net/doc/e718493449.html,/schema/beans

7. https://www.sodocs.net/doc/e718493449.html,/schema/beans/spring-b

eans-3.1.xsd

8. https://www.sodocs.net/doc/e718493449.html,/schema/context

9. https://www.sodocs.net/doc/e718493449.html,/schema/context/spring

-context-3.1.xsd

10. https://www.sodocs.net/doc/e718493449.html,/schema/mvc

11. https://www.sodocs.net/doc/e718493449.html,/schema/mvc/spring-mvc

-4.0.xsd">

12.

13.

14.

15.

16.class="org.springframework.beans.factory.config.PropertyPlaceholderC

onfigurer">

17.

18.

19.

20.

21.destroy-method="close">

22.

23.

24.

25.

26.

27.

28.

29.

30.

31.

32.

33.

34.

35.

36.

37.

38.

39.

40.

41.

42.

43.

44.

45.

46.

47.

48.

>

49.

50.

51.

52.

53.class="org.springframework.jdbc.datasource.DataSourceTransactionMana

ger">

54.

55.

56.

57.

4.2.3、Log4j的配置

为了方便调试，一般都会使用日志来输出信息，Log4j是Apache的一个开放源代码项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件，甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等；我们也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。

Log4j的配置很简单，而且也是通用的，下面给出一个基本的配置，换到其他项目中也无需做多大的调整，如果想做调整或者想了解Log4j的各种配置，参看我转载的一篇博文，很详细：

https://www.sodocs.net/doc/e718493449.html,/zhshulin/article/details/37937365

下面给出配置文件目录：

log4j.properties

[html]view plaincopyprint?

1.#定义LOG输出级别

2.log4j.rootLogger=INFO,Console,File

3.#定义日志输出目的地为控制台

4.log4j.appender.Console=org.apache.log4j.ConsoleAppender

5.log4j.appender.Console.Target=System.out

6.#可以灵活地指定日志输出格式，下面一行是指定具体的格式

https://www.sodocs.net/doc/e718493449.html,yout = org.apache.log4j.PatternLayout

https://www.sodocs.net/doc/e718493449.html,yout.ConversionPattern=[%c] - %m%n

9.

10.#文件大小到达指定尺寸的时候产生一个新的文件

11.log4j.appender.File = org.apache.log4j.RollingFileAppender

12.#指定输出目录

13.log4j.appender.File.File = logs/ssm.log

14.#定义文件最大大小

15.log4j.appender.File.MaxFileSize = 10MB

16.# 输出所以日志，如果换成DEBUG表示输出DEBUG以上级别日志

17.log4j.appender.File.Threshold = ALL

https://www.sodocs.net/doc/e718493449.html,yout = org.apache.log4j.PatternLayout

https://www.sodocs.net/doc/e718493449.html,yout.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语句为：[sql]view plaincopyprint?

1.DROP TABLE IF EXISTS `user_t`;

2.

3.CREATE TABLE `user_t` (

4. `id` int(11) NOT NULL AUTO_INCREMENT,

5. `user_name` varchar(40) NOT NULL,

6. `password` varchar(255) NOT NULL,

7. `age` int(4) NOT NULL,

8.PRIMARY KEY (`id`)

9.) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;

10.

11./*Data for the table `user_t` */

12.

13.insert into `user_t`(`id`,`user_name`,`password`,`age`) values (1,'测试

','sfasgfaf',24);

4.2.4.2、利用MyBatis Generator自动创建代码

参考博文：https://www.sodocs.net/doc/e718493449.html,/zhshulin/article/details/23912615

这个可根据表自动创建实体类、MyBatis映射文件以及DAO接口，当然，我习惯将生成的接口名改为IUserDao，而不是直接用它生成的UserMapper。如果不想麻烦就可以不改。完成后将文件复制到工程中。如图：

4.2.4.3、建立Service接口和实现类

目录结构：

下面给出具体的内容：

IUserService.jave

[java]view plaincopyprint?

1.package https://www.sodocs.net/doc/e718493449.html,.hnust.service;

2.

3.import https://www.sodocs.net/doc/e718493449.html,er;

4.

5.public interface IUserService {

6.public User getUserById(int userId);

7.}

UserServiceImpl.java

[java]view plaincopyprint?

1.package https://www.sodocs.net/doc/e718493449.html,.hnust.service.impl;

2.

3.import javax.annotation.Resource;

4.

5.import org.springframework.stereotype.Service;

6.

7.import https://www.sodocs.net/doc/e718493449.html,.hnust.dao.IUserDao;

8.import https://www.sodocs.net/doc/e718493449.html,er;

9.import https://www.sodocs.net/doc/e718493449.html,.hnust.service.IUserService;

10.

11.@Service("userService")

12.public class UserServiceImpl implements IUserService {

13.@Resource

14.private IUserDao userDao;

15.@Override

16.public User getUserById(int userId) {

17.// TODO Auto-generated method stub

18.return https://www.sodocs.net/doc/e718493449.html,erDao.selectByPrimaryKey(userId);

19. }

20.

21.}

4.2.4.4、建立测试类

测试类在src/test/java中建立，下面测试类中注释掉的部分是不使用Spring时，一般情况下的一种测试方法；如果使用了Spring那么就可以使用注解的方式来引入配置文件和类，然后再将service接口对象注入，就可以进行测试了。

如果测试成功，表示Spring和Mybatis已经整合成功了。输出信息使用的是Log4j打印到控制台。[java]view plaincopyprint?

1.package org.zsl.testmybatis;

2.

3.import javax.annotation.Resource;

4.

5.import org.apache.log4j.Logger;

6.import org.junit.Before;

7.import org.junit.Test;

8.import org.junit.runner.RunWith;

9.import org.springframework.context.ApplicationContext;

10.import org.springframework.context.support.ClassPathXmlApplicationContext;

11.import org.springframework.test.context.ContextConfiguration;

12.import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

13.

14.import com.alibaba.fastjson.JSON;

15.import https://www.sodocs.net/doc/e718493449.html,er;

16.import https://www.sodocs.net/doc/e718493449.html,.hnust.service.IUserService;

17.

18.@RunWith(SpringJUnit4ClassRunner.class) //表示继承了

SpringJUnit4ClassRunner类

19.@ContextConfiguration(locations = {"classpath:spring-mybatis.xml"})

20.

21.public class TestMyBatis {

22.private static Logger logger = Logger.getLogger(TestMyBatis.class);

23.// private ApplicationContext ac = null;

24.@Resource

25.private IUserService userService = null;

26.

27.// @Before

28.// public void before() {

29.// ac = new ClassPathXmlApplicationContext("applicationContext.xml");

30.// userService = (IUserService) ac.getBean("userService");

31.// }

32.

33.@Test

34.public void test1() {

35. User user = userService.getUserById(1);

36.// System.out.println(user.getUserName());

37.// https://www.sodocs.net/doc/e718493449.html,("值："+user.getUserName());

38. https://www.sodocs.net/doc/e718493449.html,(JSON.toJSONString(user));

39. }

40.}

测试结果：

至此，完成Spring和mybatis这两大框架的整合，下面在继续进行SpringMVC的整合。

4.3、整合SpringMVC

上面已经完成了2大框架的整合，SpringMVC的配置文件单独放，然后在web.xml中配置整合。

4.3.1、配置spring-mvc.xml

配置里面的注释也很详细，在此就不说了，主要是自动扫描控制器，视图模式，注解的启动这三个。

[html]view plaincopyprint?

1.

2.

3.xmlns:xsi="https://www.sodocs.net/doc/e718493449.html,/2001/XMLSchema-instance" xmlns:p="http://ww

https://www.sodocs.net/doc/e718493449.html,/schema/p"

4.xmlns:context="https://www.sodocs.net/doc/e718493449.html,/schema/context"

5.xmlns:mvc="https://www.sodocs.net/doc/e718493449.html,/schema/mvc"

6.xsi:schemaLocation="https://www.sodocs.net/doc/e718493449.html,/schema/beans

7. https://www.sodocs.net/doc/e718493449.html,/schema/beans/spring-b

eans-3.1.xsd

8. https://www.sodocs.net/doc/e718493449.html,/schema/context

9. https://www.sodocs.net/doc/e718493449.html,/schema/context/spring

-context-3.1.xsd

10. https://www.sodocs.net/doc/e718493449.html,/schema/mvc

11. https://www.sodocs.net/doc/e718493449.html,/schema/mvc/spring-mvc

-4.0.xsd">

12.

13.

14.

15.

16.class="org.springframework.http.converter.json.MappingJacksonHttpMes

sageConverter">

17.

18.

19.text/html;charset=UTF-8

20.

21.

22.

23.

24.

25.class="org.springframework.web.servlet.mvc.annotation.AnnotationMeth

odHandlerAdapter">

26.

27.

28.

29.

30.

31.

32.

33.

34.

35.

36.

37.

38.

39.

40.

41.class="https://www.sodocs.net/doc/e718493449.html,monsMultipartRes

olver">

42.

43.

44.

45.

46.

47.

48.

49.

50.

4.3.2、配置web.xml文件

这里面对spring-mybatis.xml的引入以及配置的spring-mvc的Servlet就是为了完成SSM整合，之前2框架整合不需要在此处进行任何配置。配置一样有详细注释，不多解释了。

web.xml

[html]view plaincopyprint?

1.

2.

3.xmlns="https://www.sodocs.net/doc/e718493449.html,/xml/ns/javaee"

4.xsi:schemaLocation="https://www.sodocs.net/doc/e718493449.html,/xml/ns/javaee http://java.sun.co

m/xml/ns/javaee/web-app_3_0.xsd"

5.version="3.0">

6.Archetype Created Web Application

7.

8.

9.contextConfigLocation

10.classpath:spring-mybatis.xml

11.

12.

13.

14.encodingFilter

15.org.springframework.web.filter.CharacterEncodingFilter

16.true

17.

18.encoding

19.UTF-8

20.

21.

22.

23.encodingFilter

24./*

25.

26.

27.

28.org.springframework.web.context.ContextLoaderListene

r

29.

30.

31.

32.org.springframework.web.util.IntrospectorCleanupList

ener

33.

34.

35.

36.

37.SpringMVC

38.org.springframework.web.servlet.DispatcherServlet

rvlet-class>

39.

40.contextConfigLocation

41.classpath:spring-mvc.xml

42.

43.1

44.true

45.

46.

47.SpringMVC

48.

49./

50.

51.

52./index.jsp

53.

54.

55.

4.3.3、测试

至此已经完成了SSM三大框架的整合了，接下来测试一下，如果成功了，那么恭喜你，如果失败了，继续调试吧，作为程序员就是不停的与BUG做斗争！

4.3.3.1、新建jsp页面

showUser.jsp 此页面仅输出一下用户名，完成一个完整的简单流程。

[html]view plaincopyprint?

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

2.

3.

4.

5.

6.

7.

8.

9. ${https://www.sodocs.net/doc/e718493449.html,erName}

10.

11.

4.3.3.2、建立UserController类

UserController.java 控制器

[java]view plaincopyprint?

1.package https://www.sodocs.net/doc/e718493449.html,.hnust.controller;

2.

3.import javax.annotation.Resource;

4.import javax.servlet.http.HttpServletRequest;

5.

6.import org.springframework.stereotype.Controller;

7.import org.springframework.ui.Model;

8.import org.springframework.web.bind.annotation.RequestMapping;

9.

10.import https://www.sodocs.net/doc/e718493449.html,er;

11.import https://www.sodocs.net/doc/e718493449.html,.hnust.service.IUserService;

12.

13.@Controller

14.@RequestMapping("/user")

15.public class UserController {

16.@Resource

17.private IUserService userService;

18.

19.@RequestMapping("/showUser")

20.public String toIndex(HttpServletRequest request,Model model){

21.int userId = Integer.parseInt(request.getParameter("id"));

22. User user = https://www.sodocs.net/doc/e718493449.html,erService.getUserById(userId);

23. model.addAttribute("user", user);

24.return"showUser";

25. }

26.}

4.3.3.3、部署项目

输入地址：localhost:8080/项目名称/user/showUser?id=1

至此，SSM三大框架的整合就完成了，在此基础上可再添加其他功能。源码下载地址：https://www.sodocs.net/doc/e718493449.html,/detail/u012909091/7658611

（转载注明出处：https://www.sodocs.net/doc/e718493449.html,/zhshulin）