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项目创建
如果需要,参看之前的博文:http://blog.csdn.net/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
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
-
<?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:p="http://www.springframework.org/schema/p"
-
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-3.1.xsd
-
http://www.springframework.org/schema/context
-
http://www.springframework.org/schema/context/spring-context-3.1.xsd
-
http://www.springframework.org/schema/mvc
-
http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
-
-
<context:component-scan base-package="com.cn.hnust" />
-
-
<bean id="propertyConfigurer"
-
class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
-
<property name="location" value="classpath:jdbc.properties" />
-
</bean>
-
-
<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>
-
-
-
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
-
<property name="dataSource" ref="dataSource" />
-
-
<property name="mapperLocations" value="classpath:com/cn/hnust/mapping/*.xml"></property>
-
</bean>
-
-
-
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
-
<property name="basePackage" value="com.cn.hnust.dao" />
-
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
-
</bean>
-
-
-
<bean id="transactionManager"
-
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
-
<property name="dataSource" ref="dataSource" />
-
</bean>
-
-
</beans>
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
-
# 输出所以日志,如果换成DEBUG表示输出DEBUG以上级别日志
-
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) {
-
-
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)
-
@ContextConfiguration(locations = {"classpath:spring-mybatis.xml"})
-
-
public class TestMyBatis {
-
private static Logger logger = Logger.getLogger(TestMyBatis.class);
-
-
@Resource
-
private IUserService userService = null;
-
-
-
-
-
-
-
-
@Test
-
public void test1() {
-
User user = userService.getUserById(1);
-
-
-
logger.info(JSON.toJSONString(user));
-
}
-
}
测试结果:
至此,完成Spring和mybatis这两大框架的整合,下面在继续进行SpringMVC的整合。
4.3、整合SpringMVC
上面已经完成了2大框架的整合,SpringMVC的配置文件单独放,然后在web.xml中配置整合。
4.3.1、配置spring-mvc.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:p="http://www.springframework.org/schema/p"
-
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-3.1.xsd
-
http://www.springframework.org/schema/context
-
http://www.springframework.org/schema/context/spring-context-3.1.xsd
-
http://www.springframework.org/schema/mvc
-
http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
-
-
<context:component-scan base-package="com.cn.hnust.controller" />
-
-
<bean id="mappingJacksonHttpMessageConverter"
-
class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter">
-
<property name="supportedMediaTypes">
-
<list>
-
<value>text/html;charset=UTF-8</value>
-
</list>
-
</property>
-
</bean>
-
-
<bean
-
class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
-
<property name="messageConverters">
-
<list>
-
<ref bean="mappingJacksonHttpMessageConverter" />
-
</list>
-
</property>
-
</bean>
-
-
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
-
-
<property name="prefix" value="/WEB-INF/jsp/" />
-
<property name="suffix" value=".jsp" />
-
</bean>
-
-
-
<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>
-
-
</beans>
4.3.2、配置web.xml文件
这里面对spring-mybatis.xml的引入以及配置的spring-mvc的Servlet就是为了完成SSM整合,之前2框架整合不需要在此处进行任何配置。配置一样有详细注释,不多解释了。
web.xml
-
<?xml version="1.0" encoding="UTF-8"?>
-
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-
xmlns="http://java.sun.com/xml/ns/javaee"
-
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
-
version="3.0">
-
<display-name>Archetype Created Web Application</display-name>
-
-
<context-param>
-
<param-name>contextConfigLocation</param-name>
-
<param-value>classpath:spring-mybatis.xml</param-value>
-
</context-param>
-
-
<filter>
-
<filter-name>encodingFilter</filter-name>
-
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
-
<async-supported>true</async-supported>
-
<init-param>
-
<param-name>encoding</param-name>
-
<param-value>UTF-8</param-value>
-
</init-param>
-
</filter>
-
<filter-mapping>
-
<filter-name>encodingFilter</filter-name>
-
<url-pattern>/*</url-pattern>
-
</filter-mapping>
-
-
<listener>
-
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
-
</listener>
-
-
<listener>
-
<listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
-
</listener>
-
-
-
<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>
-
-
<url-pattern>/</url-pattern>
-
</servlet-mapping>
-
<welcome-file-list>
-
<welcome-file>/index.jsp</welcome-file>
-
</welcome-file-list>
-
-
</web-app>
4.3.3、测试
至此已经完成了SSM三大框架的整合了,接下来测试一下,如果成功了,那么恭喜你,如果失败了,继续调试吧,作为程序员就是不停的与BUG做斗争!
4.3.3.1、新建jsp页面
showUser.jsp 此页面仅输出一下用户名,完成一个完整的简单流程。
-
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
-
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
<html>
-
<head>
-
<title>测试</title>
-
</head>
-
-
<body>
-
${user.userName}
-
</body>
-
</html>
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三大框架的整合就完成了,在此基础上可再添加其他功能。