【计理01组08号】SSM框架整合
数据库准备
本次课程使用 MySQL 数据库。首先启动 mysql ：
sudo service mysql start然后在终端下输入以下命令，进入到 MySQL 数据库（-u 表示用户名，比如这里的 root，-p 表示密码，这里没有密码就省略了）：
mysql -u root为了实验方便，我们在这里新建一个数据库并取名 ssm 用作实验。
create database ssm;
在数据库 ssm 下创建表 user ，代码如下：
use ssm;
create table user(
id int primary key auto_increment,
username varchar(20),
password varchar(20),
sex varchar(10),
age int
);
我们先往 user 表插入一条测试数据：
insert into user(username,password,sex,age) value('shiyanlou','123456','male',22);
新建工程项目
首先打开 WEB IDE，选择 File->Open New Terminal，在终端中输入：
mvn archetype:generate -DgroupId=com.shiyanlou -DartifactId=SSMTest -DarchetypeArtifactId=maven-archetype-webapp
参数说明：
- Group Id：项目的组织机构，也是包的目录结构，一般都是域名的倒序，比如 com.shiyanlou；
- Atifact Id ：项目实际的名字，比如 SSMTest；
- archetype Artifact Id ：使用的 maven 骨架名称
输入命令之后，maven 会提示我们输入版本号，这里可以直接定义版本号也可以直接回车，接着 maven 会提示当前要创建项目的基本信息，输入 y 然后回车确认，接着在 src/main/ 目录中创建 java 目录。
在 src/main/java 下新建各层的包，如图：
- model 下是一系列 POJO，即各种实体类
- mapper 相当于 DAO 层，由于这里采用 MyBatis，所以把它称为 Mapper，其下包括 Mapper 接口和 Mapper 配置文件，通过 SQL 语句的映射完成 CRUD 操作
- service 由一系列业务逻辑对象组成，放置各种 service 接口
- service.impl 是 service 的具体实现
- controller 由一系列控制器组成，处理用户请求并作出响应
接下来添加相关依赖包，如 spring、mybatis 等。打开 pom.xml，添加以下内容
4.0.0
com.shiyanlou
SSMTest
1.0-SNAPSHOT
war
5.1.47
3.3.0
1.2.2
5.1.1.RELEASE
UTF-8
junit
junit
4.12
test
org.springframework
spring-test
${spring.version}
test
commons-logging
commons-logging
1.1.3
commons-collections
commons-collections
3.2.1
commons-io
commons-io
2.4
commons-lang
commons-lang
2.6
org.mybatis
mybatis
${mybatis.version}
org.mybatis
mybatis-spring
${mybatis-spring.version}
mysql
mysql-connector-java
${jdbc.driver.version}
runtime
org.slf4j
slf4j-api
1.7.7
org.slf4j
slf4j-log4j12
1.7.7
log4j
log4j
log4j
log4j
1.2.16
org.aspectj
aspectjrt
1.7.4
org.aspectj
aspectjweaver
1.7.4
org.springframework
spring-core
${spring.version}
org.springframework
spring-beans
${spring.version}
org.springframework
spring-context-support
${spring.version}
org.springframework
spring-jdbc
${spring.version}
org.springframework
spring-tx
${spring.version}
org.springframework
spring-webmvc
${spring.version}
javax.servlet
javax.servlet-api
3.1.0
provided
javax.servlet.jsp
jsp-api
2.2
javax.servlet
jstl
1.2
org.eclipse.jetty
jetty-maven-plugin
9.4.12.v20180830
10
/
model层实体类User
在包 com.shiyanlou.model 下新建类 User.java， 一个用户具有：id、username、password、sex、age 五个属性，代码如下：
package com.shiyanlou.model;
public class User {
private Integer id; // 用户 id
private String username; // 用户名
private String password; // 密码
private String sex; // 性别
private Integer age; // 年龄
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
// 重写了 toString 方法，方便后面的测试
public String toString() {
return "id:" + id + ",username:" + username + ",password:" + password
+ ",sex:" + sex + ",age:" + age;
}
}mapper(dao)层实现
在包 com.shiyanlou.mapper 下建一个 UserMapper.java
UserMapper 接口的代码如下：
package com.shiyanlou.mapper;
import com.shiyanlou.model.User;
import java.util.List;
public interface UserMapper {
/**
* 用户登录查询
*
* @param user
* @return User
**/
User selectLogin(User user);
/**
* 查询全部用户
*
* @return List
**/
List selectAllUser();
/**
* 新增用户
*
* @param user
**/
void addUser(User user);
/**
* 更新用户
*
* @param user
**/
void updateUser(User user);
/**
* 删除用户
*
* @param id
**/
void deleteUser(Integer id);
} 接着在 src/main/resources 下建立一个 mappers 文件夹，并在其中建立 UserMapper.xml，UserMapper.xml 的配置如下：
insert into user (username, password, sex, age)
values (#{username}, #{password}, #{sex}, #{age})
update user
set username = #{username},
password = #{password},
sex = #{sex},
age = #{age}
where id = #{id}
delete
from user
where id = #{id}
到这里， DAO 层的代码就写完了，接下来我们来实现 Service 层的代码。
注：MyBatis 的配置文件放在整合时在进行处理。
service层实现
Service 层接口
在包 com.shiyanlou.service 下建一个 UserService.java 接口文件，添加如下代码：
package com.shiyanlou.service;
import com.shiyanlou.model.User;
import java.util.List;
public interface UserService {
/**
* 用户登录
*
* @param user
* @return 登录成功返回 User 对象，失败返回 null
**/
User login(User user);
/**
* 查询所有用户
*
* @return 查询到的所有 User 对象的 list
**/
List selectAllUser();
/**
* 新增用户
*
* @param user
**/
void addUser(User user);
/**
* 更新用户
*
* @param user
**/
void updateUser(User user);
/**
* 删除用户
*
* @param id（用户 id）
**/
void deleteUser(Integer id);
} Service 层接口实现类
在包 com.shiyanlou.service.impl 下建一个类 UserServiceImpl.java ，用来实现 UserService 接口中的方法，添加如下代码：
package com.shiyanlou.service.impl;
import com.shiyanlou.mapper.UserMapper;
import com.shiyanlou.model.User;
import com.shiyanlou.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.util.List;
/**
* 将当前类注释为一个 Spring 的 bean
*
* @author shiyanlou
*/
@Service
@Transactional(rollbackFor = Exception.class)
public class UserServiceImpl implements UserService {
/**
* 自动注入 UserMapper
**/
@Autowired
public UserMapper userMapper;
// 下面是 UserService 接口所有方法的具体实现
public User login(User user) {
return userMapper.selectLogin(user);
}
public List selectAllUser() {
return userMapper.selectAllUser();
}
public void addUser(User user) {
userMapper.addUser(user);
}
public void updateUser(User user) {
userMapper.updateUser(user);
}
public void deleteUser(Integer id) {
userMapper.deleteUser(id);
}
} 到这里， Service 层的代码就写完了，接下来将 Spring 和 MyBatis 进行整合。
Spring和MyBatis整合
MyBatis 配置文件
在目录 src/main/resources 下新建 MyBatis 配置文件 mybatis-config.xml ，代码如下：
注：在这里，我们没有配置 MyBatis 的运行环境、数据源等，那是因为我们要将这些交给 Spring 进行配置管理。
applicationContext.xml
在目录 src/main/resources 下新建文件 applicationContext.xml，该文件用来完成 Spring 和 MyBatis 的整合，主要包括了自动扫描，自动注入，配置数据库等，内容如下：
在这里，我们将数据源配置信息写死在 applicationContext.xml 中的，也可以新建 jdbc.properties 文件，然后进行引入。
log4j.properties 配置日志
在目录 src/main/resources 下新建日志文件 log4j.properties ，在里面添加如下内容：
# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n到这里，Spring 和 MyBatis 就整合完成，下面我们通过一个测试类测试整合是否成功。
Spring、MyBatis 整合测试
在目录 src/test/java 下新建测试类 SpringMybatisTest，添加如下代码：
import com.shiyanlou.model.User;
import com.shiyanlou.service.UserService;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import java.util.List;
/**
* 配置spring和junit整合，junit启动时加载springIOC容器 spring-test,junit
**/
@RunWith(SpringJUnit4ClassRunner.class)
// 告诉junit spring配置文件
@ContextConfiguration({"classpath:applicationContext.xml"})
public class SpringMybatisTest {
@Autowired
private UserService userService;
/* @Autowired
private User user;*/
/* @Test
public void testLogin() {
//User user = new User();
user.setUsername("shiyanlou");
user.setPassword("123456");
System.out.println(userService.login(user).toString());
}*/
@Test
public void testSelectAllUser() {
List users = userService.selectAllUser();
for (User us : users) {
System.out.println(us.toString());
}
}
/* @Test
public void testAdd() {
//User user = new User();
user.setUsername("user2");
user.setPassword("123456");
user.setSex("female");
user.setAge(25);
userService.addUser(user);
}
@Test
public void testUpdate() {
//User user = new User();
user.setId(3);
user.setUsername("user2");
user.setPassword("123");
user.setSex("female");
user.setAge(30);
userService.updateUser(user);
}
@Test
public void testUpdate() {
int id = 3;
userService.deleteUser(id);
}*/
} 在这里，我们采用 Junit 进行单元测试，分别测试五个方法，这里只演示查询所有用户 testSelectAllUser() 方法，打开终端输入 mvn test 命令，结果如下：
我们 user 表中只有一条数据，可以看到 Spring 和 MyBatis 已经整合成功。
如果想要在测试类中注入 User 对象，需要做两点：
- 在测试类中添加代码
@Autowired
private User user;- 在 model 层的 User 类中添加 @Component 注解
@Component
public class User {
private Integer id;
private String username;
private String password;
private String sex;
private Integer age;
......
}注：但是一般实体类的对象不进行注入，而是由外部传入，这里是为了方便测试。
整合完 Spring 和 MyBatis 后，我们要完成 Spring MVC 的整合。
Controller层实现
在包 com.shiyanlou.controller 下建一个 Controller 类 UserController.java，代码如下：
package com.shiyanlou.controller;
import com.shiyanlou.model.User;
import com.shiyanlou.service.UserService;
import org.apache.ibatis.annotations.Param;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;
import java.util.List;
/**
* 处理用户请求 Controller
**/
@Controller
public class UserController {
/**
* 自动注入 UserService
**/
@Autowired
private UserService userService;
// 登录
@RequestMapping("/login")
public String login(User user, Model model, HttpSession session) {
User loginUser = userService.login(user);
if (loginUser != null) {
session.setAttribute("user", loginUser);
return "redirect:alluser";
} else {
session.setAttribute("message", "username or password is wrong!");
return "redirect:loginform.jsp";
}
}
// 退出
@RequestMapping(value = "/loginout")
public String loginout(HttpSession session) {
session.invalidate();
return "redirect:loginform.jsp";
}
// 查询所有用户
@RequestMapping("/alluser")
public String selectAllUser(HttpServletRequest request) {
List listUser = userService.selectAllUser();
request.setAttribute("listUser", listUser);
return "userlist";
}
// 跳转至新增用户页面
@RequestMapping("/toadduser")
public String toAddUserPage() {
return "adduser";
}
// 新增用户
@RequestMapping("/adduser")
public String addUser(User user, HttpServletRequest request) {
userService.addUser(user);
List listUser = userService.selectAllUser();
request.setAttribute("listUser", listUser);
return "userlist";
}
// 跳转至更新用户页面
@RequestMapping("/toupdateuser")
public String toUpdateUser(@Param("id") Integer id,
HttpServletRequest request, Model model) {
model.addAttribute("user_id", id);
return "updateuser";
}
// 更新用户
@RequestMapping("/updateuser")
public String updateUser(User user, HttpServletRequest request) {
userService.updateUser(user);
List listUser = userService.selectAllUser();
request.setAttribute("listUser", listUser);
return "userlist";
}
// 删除用户
@RequestMapping("/deleteuser")
public String deleteUser(@Param("id") Integer id, HttpServletRequest request) {
userService.deleteUser(id);
List listUser = userService.selectAllUser();
request.setAttribute("listUser", listUser);
return "userlist";
}
} JSP页面
loginform.jsp
在 src/main/webapp 目录下新建一个 JSP 页面命名为 loginform.jsp，作为登录页面，代码如下：
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
Login Page
Login Page
userlist.jsp
在 webapp/WEB-INF/ 目录下新建一个目录 jsp，并且在其中新建一个 JSP 页面命名为 userlist.jsp，作为主页面，代码如下：
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
ssm
Welcome,[${sessionScope.user.username}] | Exit
id
username
password
sex
age
Options
${user.id}
${user.username}
${user.password}
${user.sex}
${user.age}
modify
delete
Add a new user
adduser.jsp
在 webapp/WEB-INF/jsp 目录下新建一个 JSP 页面命名为 adduser.jsp，作为新增用户页面，代码如下：
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
Add Page
AddUser Page
updateuser.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
Modify Page
Modify Page
配置spring-mvc.xml文件
在目录 Java Resources/src 下新建 Spring MVC 配置文件 spring-mvc.xml ，代码如下：
配置web.xml文件
现在我们来到整合的最后一步，配置 web.xml 文件，代码如下：
SSMTest
org.springframework.web.context.ContextLoaderListener
contextConfigLocation
classpath:applicationContext.xml
springMVC
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:spring-mvc.xml
1
springMVC
/
org.springframework.web.util.IntrospectorCleanupListener
encodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceEncoding
true
encodingFilter
/*
loginform.jsp
到这里，SSM 框架就全部整合完毕，接下来我们要进行测试。
运行测试
打开终端 File -> Open New Terminal
输入 mvn jetty:run 运行程序，点击工具-- web 服务按钮，访问 web 服务。
注意：目前实验楼只支持 8080 端口启动服务，如果使用其他端口，将无法访问到服务，这里 jetty 默认就是 8080 端口，所以不用更改。
输入错误的用户名或密码（我们最开始的数据是 username:shiyanlou，password:123456）。
当用户名和密码都正确的时候进入首页。
在这里一共只有一条数据。
点击下面的 Add a new user 链接，进入新增用户页面，并填写新增用户的信息。
点击 add 按钮，完整用户的新增操作，可以看到用户新增成功。
点击 id 为 2 的用户记录行的 modify 链接，进入更新用户页面，并填写更新信息。
点击 modify 按钮，完整用户的更新操作，可以看到用户信息更新成功。
点击 id 为 2 的用户记录行的 delete 链接，删除该用户。
点击右上角的 Exit 链接，退出主页到登录页面。
