来源:http://blog.csdn.net/zhshulin/article/details/37956105?utm_source=tuicool&utm_medium=referral(以下博文对原博文有改动和补充)
博文里红底白字的,为注意修改的地方,在这里先声明
开发环境:
Eclipse Java EE IDE for Web Developers. Version: Mars.2 Release (4.5.2)
MySQL 5.0.11-dev(官网下载需要账号登录,故不提供,请自行百度)
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、开发环境搭建
参看博文:MyEclipse+Tomcat+MAVEN+SVN项目完整环境搭建(作者:shu_lin)
3、Maven Web项目创建
参看博文:使用maven创建web项目(作者:shu_lin)(博文最后一步可以不用设置,Maven->Update Project...会自动设置)
补充:(可跳过)
新建的Maven,Java Resources只有resource
可以添加Server Library自动生成
右击项目->Properties->Java Build Path->Add Library...->Server Library
4、SSM整合
下面主要介绍三大框架的整合,至于环境的搭建以及项目的创建,参看上面的博文。这次整合我分了2个配置文件,分别是spring-mybatis.xml,包含spring和mybatis的配置文件,还有个是spring-mvc的配置文件,此外有2个资源文件:jdbc.propertis和log4j.properties。
使用框架都是较新的版本:
Spring 4.0.2 RELEASE(PS:无需手动下载,Maven会自动下)
Spring MVC 4.0.2 RELEASE(PS:无需手动下载,Maven会自动下)
MyBatis 3.2.6(下载:https://github.com/mybatis/mybatis-3/releases)
完整目录结构如下:
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)
4.2.2、Log4j的配置(跳过此步也没影响)
为了方便调试,一般都会使用日志来输出信息,Log4j是Apache的一个开放源代码项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件,甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。
Log4j的配置很简单,而且也是通用的,下面给出一个基本的配置,换到其他项目中也无需做多大的调整,如果想做调整或者想了解Log4j的各种配置,参看我转载的一篇博文,很详细:Log4j配置详解 (作者:shu_lin)
log4j.properties(文件编码修改为utf-8)
4.2.3、建立spring-mybatis.xml配置文件
这个文件就是用来完成spring和mybatis的整合的。这里面也没多少行配置,主要的就是自动扫描,自动注入,配置数据库。注释也很详细,大家看看就明白了。
spring-mybatis.xml
4.2.4、JUnit测试
经过以上步骤(log4j不配也没影响),我们已经完成了Spring和mybatis的整合,这样我们就可以编写一段测试代码来试试是否成功了。
4.2.4.1、创建测试用表
既然我们需要测试,那么我们就需要建立在数据库中建立一个测试表,这个表建的很简单,SQL语句为:
MySQL
# # Structure for table "user_t" # 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 table "user_t" # INSERT INTO `user_t` VALUES (1,‘测试‘,‘123456‘,24);
4.2.4.2、利用MyBatis Generator自动创建代码
随便找个位置建文件夹(路径最好都是英文),然后在里面建个src文件夹,下载下面那两个包,将generatorConfig.xml拷进去,最后打开cmd,进到文件夹,执行下面的命令,代码就会生成到src文件夹里
generatorConfig.xml
cmd命令
java -jar mybatis-generator-core-1.3.2.jar -configfile generatorConfig.xml -overwrite
可做成.bat文件备用,放在目录运行即可
cmd命令
set current_path="%cd%" java -jar mybatis-generator-core-1.3.2.jar -configfile generatorConfig.xml -overwrite pause exit
参考博文:SSM框架——使用MyBatis Generator自动创建代码(作者:shu_lin)
这个可根据表自动创建实体类、MyBatis映射文件以及DAO接口,完成后将文件复制到工程中。如图:
IUserService.java
package com.ssm.service; import com.ssm.pojo.User; public interface IUserService { public User getUserById(int userId); }
UserService.java
package com.ssm.service.impl; import javax.annotation.Resource; import org.springframework.stereotype.Service; import com.ssm.dao.UserMapper; import com.ssm.pojo.User; import com.ssm.service.IUserService; @Service("userService") public class UserService implements IUserService { @Resource private UserMapper userDao; public User getUserById(int userId) { return this.userDao.selectByPrimaryKey(userId); } }
4.2.4.4、建立测试类
测试类在src/test/java中建立,下面测试类中注释掉的部分是不使用Spring时,一般情况下的一种测试方法;如果使用了Spring那么就可以使用注解的方式来引入配置文件和类,然后再将service接口对象注入,就可以进行测试了。如果测试成功,表示Spring和Mybatis已经整合成功了。输出信息使用的是Log4j打印到控制台。
TestMyBatis.java
package com.ssm.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.ssm.pojo.User; import com.ssm.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 test() { User user = userService.getUserById(1); // System.out.println(user.getUserName()); // logger.info("值:"+user.getUserName()); logger.info(JSON.toJSONString(user)); } }
测试:
先clean项目(可跳过),再Maven->Update Project...(重点),就是为了更新项目设置,(右击项目->Run As->JUnit Test)
至此,完成Spring和mybatis这两大框架的整合,下面在继续进行SpringMVC的整合。
如测试失败请参考网友方法,一般clean项目和右击项目->Maven->Update Project...更新一下项目设置都可以解决:
4.3、整合SpringMVC
上面已经完成了2大框架的整合,SpringMVC的配置文件单独放,然后在web.xml中配置整合。
4.3.1、配置spring-mvc.xml
配置里面的注释也很详细,在此就不说了,主要是自动扫描控制器,视图模式,注解的启动这三个。
spring-mvc.xml
4.3.2、配置web.xml文件
这里面对spring-mybatis.xml的引入以及配置的spring-mvc的Servlet就是为了完成SSM整合,之前2框架整合不需要在此处进行任何配置。配置一样有详细注释,不多解释了。
web.xml
4.3.3、测试
至此已经完成了SSM三大框架的整合了,接下来测试一下,如果成功了,那么恭喜你,如果失败了,继续调试吧,作为程序员就是不停的与BUG做斗争!
4.3.3.1、新建jsp页面
User.jsp 此页面仅输出一下用户名,完成一个完整的简单流程。
User.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>测试</title> </head> <body>${user.userName} </body> </html>
4.3.3.2、建立UserController类
UserController.java
package com.ssm.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.ssm.pojo.User; import com.ssm.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 "User"; } }
4.3.3.3、部署项目
再次测试(右击项目->Run As->Run On Serser),输入地址:http://localhost:8080/app/user/showUser?id=1
如果成功请不要开心得太早,Maven->Update Project...或将项目拷到其他机上后会立马出现404!shu_lin与其他博主都没有为此作出任何后续说明,为此写出此博文作出补充。
补充:
无论是shu_lin的SSM框架——详细整合教程(Spring+SpringMVC+MyBatis)还是其他人的博文,都没有写明Maven->Update Project...后会导致项目不能运行,会出现关于Spring包的ClassNotFoundException错误这个问题,
(对于我这个新手(Java零基础新手,Eclipse也不熟悉)头大了。。。花了近一个月来学这个Hello World。就是卡在这个问题上。)
疑问开始,找Maven
带着这个疑问?就第一时间找到Maven,可是奇怪了,都包含了?!为什么还是找不到类?
从百度里找了多个答案后,终于找到问题所在,就是编译时没有复制依赖包到WEB-INF/lib里,编译时也没有生成lib文件夹
临时方法:(PS:感觉方法不太对,放弃了)
百度里有个方法就是教你修改.classpath,手动添加/WEB-INF/lib
<classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER"> <attributes> <attribute name="maven.pomderived" value="true"/> <attribute name="org.eclipse.jst.component.dependency" value="/WEB-INF/lib"/> </attributes> </classpathentry>
临时方法:
右击项目->Properties->Deployment Assembly->Add->Java Build Path Entries->Maven Dependencies->Finish完成添加,再点击OK关闭
再次测试(右击项目->Run As->Run On Serser),输入地址:http://localhost:8080/app/user/showUser?id=1,运行OK!
完美解决方法:
可是毕竟是临时方法,Maven->Update Project...后还是会导致项目不能运行,因为配置被Maven还原了!!!不行,这还是没有解决,还需要再找,几番周折终于找到了!
打开cmd,定位到项目目录下,执行下面命令
cmd命令(根据Java Build Path的列表得知,只要不改动包,就不需要再次运行此命令)
mvn eclipse:eclipse -Dwtpversion=2.0
可做成.bat文件备用,放在项目根目录运行即可
cmd命令
set current_path="%cd%" mvn eclipse:eclipse -Dwtpversion=2.0 pause exit
执行命令以后,clean项目和Maven->Update Project...后,Deployment Assembly和Java Build Path都有变化
再次测试(右击项目->Run As->Run On Serser),输入地址:http://localhost:8080/app/user/showUser?id=1,运行OK!完美!
再看看WEB-INF里,终于自动生成lib文件夹