SpringMVC与MyBatis是我们现在最流行的开发框架组合之一,这里我来整理一下框架的集成搭建过程
前言
使用IDE:IntelliJ IDEA
JDK:1.8
打开IDEA,新建maven工程
第一步:打开IDEA,点击Create New Project
第二步:
选择新建一个Maven项目,然后从Maven项目模板工具包中选择常用的[maven-archetype-webapp]模板
在这个项目里,有WEB-INF目录,并且有web.xml和一个index.jsp ,选中之后,点击next下一步
第三步:
输入maven的GroupId和ArtifactId,完成之后选择next
GroupID是项目组织唯一的标识符,实际对应JAVA的包的结构,是main目录里java的目录结构。
ArtifactID是项目的唯一的标识符,实际对应项目的名称,就是项目根目录的名称。
第四步:
查看maven相关配置(一般如果没什么问题,可直接跳过,进行下一步)
第五步:
设置项目的名称和存放目录,输入完成后,点击Finish完成
第六步:
完成之后,打开项目,初始化结构如图所示,(maven的pom.xml结构改变时,记得点击右下角出现的:Import Changes)
完善项目目录结构
我们看到,通过maven模板建立的项目结构并不是我们常用的,此时,我们需要进行一些添加
如果你新建的文件夹(比如java目录),没有被idea识别,你可以手动设置改变文件夹属性,操作如下
编辑maven的pom.xml文件,设置项目建造和引入相关依赖
我的pom.xml文件如下,具体写在注释里了
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
com.sample.ssm
sample-web
1.0-SNAPSHOT
war
1.8
1.8
4.2.3.RELEASE
junit
junit
4.11
test
org.slf4j
slf4j-api
1.7.7
ch.qos.logback
logback-core
1.1.7
ch.qos.logback
logback-classic
1.1.7
javax.servlet
javax.servlet-api
3.1.0
javax.servlet.jsp
jsp-api
2.2
taglibs
standard
1.1.2
jstl
jstl
1.2
com.alibaba
fastjson
1.2.38
org.springframework
spring-core
${spring-version}
org.springframework
spring-beans
${spring-version}
org.springframework
spring-context
${spring-version}
org.springframework
spring-web
${spring-version}
org.springframework
spring-webmvc
${spring-version}
org.springframework
spring-test
${spring-version}
org.hibernate
hibernate-validator
5.4.1.Final
mysql
mysql-connector-java
5.1.6
com.alibaba
druid
1.0.15
org.mybatis
mybatis
3.3.0
com.github.pagehelper
pagehelper
4.0.1
org.mybatis
mybatis-spring
1.2.3
org.springframework
spring-tx
${spring-version}
cglib
cglib
3.2.4
org.springframework
spring-jdbc
${spring-version}
tk.mybatis
mapper
3.3.9
org.mybatis.generator
mybatis-generator-core
1.3.3
sample-admin
src/main/java
**/*.properties
**/*.xml
false
src/main/resources
generator*.*
org.mybatis.generator
mybatis-generator-maven-plugin
1.3.3
src/main/resources/generatorConfig.xml
true
true
org.mybatis.generator
mybatis-generator-core
1.3.3
tk.mybatis
mapper
3.3.9
org.apache.maven.plugins
maven-surefire-plugin
2.19
true
-Dfile.encoding=UTF-8
org.apache.maven.plugins
maven-compiler-plugin
3.1
1.8
1.8
utf8
配置Spring,并且集成MyBatis
我们需要集成SpringMVC与MyBatis,所以,我们从ORM框架开始集成,最后在组建Spring MVC,一步一步来,不容易出错。Spring相关的文件这里统一放在resources的spring文件夹下。集成MyBatis的文件为spring-dao.xml,其中需要配置文件:mybatis-config.xml和单独提出数据库连接信息存放文件:jdbc.properties(记得修改自己的数据库连接信息)
spring-dao.xml
xmlns="http://www.springframework.org/schema/beans"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd ">
classpath:jdbc.properties
init-method="init" destroy-method="close">
dialect=mysql
mappers=tk.mybatis.mapper.common.Mapper
jdbc.properties
#jdbc settings
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1/sample-web?useUnicode=true&characterEncoding=utf-8
jdbc.username=root
jdbc.password=12345
#pool settings
jdbc.pool.init=1
jdbc.pool.minIdle=3
jdbc.pool.maxActive=20
#jdbc.testSql=SELECT 'x'
jdbc.testSql=SELECT 'x' FROM DUAL
mybatis-config.xml
/p>
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
构建数据结构
我们需要一个简单的数据进行测试,这里我就建立一张user_info表吧,
/*
Navicat MySQL Data Transfer
Source Server : 本地
Source Server Version : 50557
Source Host : 127.0.0.1:3306
Source Database : sample-web
Target Server Type : MYSQL
Target Server Version : 50557
File Encoding : 65001
Date: 2018-08-24 09:31:45
*/
SET FOREIGN_KEY_CHECKS=0;
-- ----------------------------
-- Table structure for user_info
-- ----------------------------
DROP TABLE IF EXISTS `user_info`;
CREATE TABLE `user_info` (
`user_id` int(11) NOT NULL AUTO_INCREMENT,
`user_name` varchar(255) NOT NULL,
PRIMARY KEY (`user_id`,`user_name`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;
-- ----------------------------
-- Records of user_info
-- ----------------------------
INSERT INTO `user_info` VALUES ('1', '用户1');
INSERT INTO `user_info` VALUES ('2', '用户2');
MyBatis集成完成后,进行调试
在框架的集成过程中,我们得一步一步来,保证每一步都不会出错才能顺利得进行下去。现在,我们对user_info这个字段进行操作,主要是:建立实体类UserInfo.java,建立Mapper类,UserInfoMapper.java,建立映射文件UserInfoMapper.xml,具体分别如下:
UserInfo.java
package com.sample.ssm.model;
/**
* @author yuyufeng
* @date 2018/8/24.
*/
public class UserInfo {
private Integer userId;
private String userName;
public Integer getUserId() {
return userId;
}
public void setUserId(Integer userId) {
this.userId = userId;
}
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
@Override
public String toString() {
return "UserInfo{" +
"userId=" + userId +
", userName='" + userName + '\'' +
'}';
}
}
UserInfoMapper.java
package com.sample.ssm.mapper;
import com.sample.ssm.model.UserInfo;
import org.apache.ibatis.annotations.Param;
/**
* @author yuyufeng
* @date 2018/8/24.
*/
public interface UserInfoMapper {
/**
* 根据ID获取单个对象
* @param userId
* @return
*/
UserInfo selectOne(@Param("userId") Integer userId);
}
UserInfoMapper.xml
user_id, user_name
SELECT user_id, user_name FROM user_info WHERE user_id = #{userId,jdbcType=INTEGER}
目前项目的结构如上图所示。
接着,我们需要使用Junit结合Spring进行调试:
在test目录下建立UserInfoMapperTest.java
package com.sample.ssm.mapper;
import com.sample.ssm.model.UserInfo;
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;
/**
* @author yuyufeng
* @date 2018/8/24.
*/
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration({"classpath:spring/spring-dao.xml"})
public class UserInfoMapperTest {
@Autowired
private UserInfoMapper userInfoMapper;
@Test
public void testSelectOne(){
UserInfo userInfo = userInfoMapper.selectOne(1);
System.out.println(userInfo);
}
}
执行调试debug:
返回结果如下图所示:
到这里,我们已经成功集成Spring+MyBatis了
集成Spring MVC
首先,我们还是在xml进行一些Spring MVC的基础配置,具体内容写在注释里
spring-web.xml
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
validator="validator">
application/json
text/html;charset=UTF-8
QuoteFieldNames
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
value="org.springframework.web.servlet.view.JstlView"/>
接着,我们需要在web项目启动的时候去加载这些Spring配置文件,打开web.xml,常用配置如下
web.xml
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1"
metadata-complete="false">
sample-web
encodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceEncoding
true
encodingFilter
/*
spring-mvc
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:spring/spring-*.xml
spring-mvc
/
建立Controller和jsp
UserController.class
package com.sample.ssm.action;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* @author yuyufeng
* @date 2018/8/24.
*/
@Controller
public class UserController {
@RequestMapping("/user")
private String toUser(){
return "user";
}
}
WEB-INF/jsp/user.jsp
Created by IntelliJ IDEA.
User: yuyufeng
Date: 2018/8/24
Time: 10:01
To change this template use File | Settings | File Templates.
--%>
用户信息Hello 你好
配置Tomcat
第一步:选择编辑配置
第二步:选择使用过Tomcat
第三步:配置Tomcat信息
第四步:部署war包到Tomcat下
选择exploded版本可以在运行过程中进行编译
设置及时更新class文件,为了调试时编译
第五步:点击debug启动tomcat
启动成功后,打开浏览器,输入http://127.0.0.1:8080/user,打开网页,访问到如下图,
此时此刻,Spring MVC已经部署完毕;
SpringMVC 与 MyBatis的使用
接下来,我们就要在Controller中使用Spring中已经集成的MyBatis了,在此,我们可以构建常用的目录,加入Service层
在service中,我们经常使用Spring集成的事务,此时,我们增加一个Spring配置
spring-service.xml
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.0.xsd
http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd">
此时的目录结构:
现在,我们建立Service类,IUserService.java,UserServiceImpl.java
IUserService.java
package com.sample.ssm.service;
import com.sample.ssm.model.UserInfo;
/**
* @author yuyufeng
* @date 2018/8/24.
*/
public interface IUserService {
/**
* 根据userId获取用户
* @param userId
* @return
*/
UserInfo getUserInfoByUserId(Integer userId);
}
UserServiceImpl.java
package com.sample.ssm.service.impl;
import com.sample.ssm.mapper.UserInfoMapper;
import com.sample.ssm.model.UserInfo;
import com.sample.ssm.service.IUserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
/**
* @author yuyufeng
* @date 2018/8/24.
*/
@Service
public class UserServiceImpl implements IUserService{
@Autowired
private UserInfoMapper userInfoMapper;
@Override
public UserInfo getUserInfoByUserId(Integer userId) {
return userInfoMapper.selectOne(userId);
}
}
接着,在Controller中引用,
package com.sample.ssm.action;
import com.sample.ssm.model.UserInfo;
import com.sample.ssm.service.IUserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* @author yuyufeng
* @date 2018/8/24.
*/
@Controller
public class UserController {
@Autowired
private IUserService userService;
@RequestMapping("/user")
private String toUser(Model model,Integer userId){
UserInfo userInfo = userService.getUserInfoByUserId(userId);
model.addAttribute("user", userInfo);
return "user";
}
}
在jsp中,使用EL表达式接收:
Created by IntelliJ IDEA.
User: yuyufeng
Date: 2018/8/24
Time: 10:01
To change this template use File | Settings | File Templates.
--%>
用户信息Hello 你好
用户ID:${user.userId}
用户NAME:${user.userName}
编辑完成后,重启Tomcat,打开地址http://127.0.0.1:8080/user?userId=1,效果如下
到这里,SpringMVC与MyBatis集成基础已经完成,已经可以进行基本的开发了。至于更细的操作,比如使用generator生成Java代码,使用TKMybatis减少MyBatis开发过程中的代码编写,JSP项目的页面便于开发的结构等,都将集成在此项目的版本中,请待今后的文章更新吧。
代码地址:https://github.com/yuyufeng1994/sample-web-ssm/tree/v1