基础SpringMVC+Spring+MyBatis框架搭建

头像
羊都是我吃的
    阅读 15 分钟
    6

    前言

    先唠叨一下，这部分没啥用，可以跳过。
    刚刚工作没多久，公司的框架都不用自己搭，所以打算自己学习搭建一个框架练练手，于是查了很多SpringMVC+Spring+MyBatis搭建教程，说真的不结合五六个教程根本看不懂，有的教程搭着搭着突然让用自动生成工具弄，然后生成的代码也看不到。我还是更希望能把最最基础的，一个核心的流程描述出来，有了根基再弄那些自动化的，省力的，或者自己的小技巧也不迟。
    下面开始搭建框架，我写的也很渣，希望能慢慢改进，大神勿喷。

    项目的创建

    新建工程（Dynamic Web Project）选择好自己的tomcat版本后finish即可。
    工程的创建

    新建成功后的目录结构：
    图片描述

    jar包的引入

    所需jar包大合影：
    jar包合影

    jar包我放在了百度网盘上网盘地址，密码是：fso6，下载好之后放在lib包下。

    SpringMVC的环境搭建：

    步骤选择了先SpringMVC，然后加入Sping和MyBatis整合。SpringMVC能直接在浏览器上看到，增加点成就感，更能鼓励自己。

    首先在WEB-INF下新建一个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"
    id="WebApp_ID" version="3.0">

    <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:springmvc-servlet.xml</param-value>
        </init-param>
    </servlet>

    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    
    
</web-app>

    并在src目录下加入 springmvc-servlet.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: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.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.1.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.1.xsd">                    
 
    <!-- 扫描这个包下的类 -->
    <context:component-scan base-package="com.mytestpro"/>
 
    <!-- 防止静态资源获取不到 -->
    <mvc:default-servlet-handler />
 
    <!-- 如果需要使用注解，下面的配置必须有 -->
    <mvc:annotation-driven />
     
    <!-- 配置资源的前缀和后缀 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
            id="internalResourceViewResolver">
        <!-- 前缀 -->
        <property name="prefix" value="/WEB-INF/jsp/" />
        <!-- 后缀 -->
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

    关于classpath：默认是你项目下的WEB-INF/classes目录。这个目录不是说我们eclipse中的目录，而是打包放在tomcat下的目录。两个文件创建好之后clean一下tomcat应该就能在你发布的目录下看到springmvc-servlet.xml文件了。

    然后创建Controller的java文件：

    package com.mytestpro.demo.Controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class TestController {

    @RequestMapping("/test")
    public String test(){
        System.out.println("dsadas");
        //这里return了test，SpringMVC会加上你配置的前缀后缀去找页面
        return "test";
    }
    
}

    我们再加入一个test.jsp方便测试，因为之前配置的前缀是WEB-INF/jsp，所以我们在WEB-INF下建一个jsp包，然后把test.jsp放进去（建议从页面到数据库整套环境使用UTF-8以减少乱码的可能性）。

    <%@ 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>Insert title here</title>
</head>
<body>
    this is my test JSP
</body>
</html>

    此时，项目的代码结构如下：
    代码目录结构

    然后其实这个时候就能跑了~放在tomcat下然后运行吧！
    结果就是这样了：
    图片描述

    至此，SpringMVC的环境顺利的建好了。

    整合Spring+MyBatis

    我们所要搭建的完整的架构中，应该是Controller-Service-Dao-DB这个从上至下的顺序，当然了由于MyBatis的加入，我们弱化了Dao层，并且没有对Dao接口的实现，如果使用Hibernate那么Dao接口对应的impl也是要有的。

    数据表的创建：
    这个SQL超简单就不说明了。

    CREATE TABLE test_user(
    id int not null primary key,
    name varchar(20),
        password varchar(100),
        phone VARCHAR(30)
);

    然后在web.xml中加入关于Spring的配置。修改后的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"
    id="WebApp_ID" version="3.0">

    <!-- Spring -->
    <!-- 配置Spring配置文件路径 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>  
            classpath:applicationContext.xml  
        </param-value>
    </context-param>
    <!-- 配置Spring上下文监听器 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- Spring -->

    <!-- 配置Spring字符编码过滤器 -->
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <init-param>
            <param-name>forceEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/</url-pattern>
    </filter-mapping>


    <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:springmvc-servlet.xml</param-value>
        </init-param>
    </servlet>

    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    
    
</web-app>

    然后和springmvc-servlet.xml那个配置文件一样，放在src下一个applicationContext.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.mytestpro" />  
    <!-- 引入配置文件 -->  
    <bean id="propertyConfigurer"  
        class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">  
        <property name="location" value="classpath:jdbc.properties" />  
    </bean>  
  
      <!-- 这里使用了dbcp的连接池，可以看做是用来建立和数据库的连接的，具体好处可以自行百度 -->
    <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>  
  
    <!-- spring和MyBatis整合,扫描目录下的mybatis配置映射文件 -->  
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">  
        <property name="dataSource" ref="dataSource" />  
        <!-- 自动扫描mapping.xml文件 -->  
        <property name="mapperLocations" value="classpath:com/mytestpro/demo/mapping/*.xml"></property>  
    </bean>
  
    <!-- DAO接口所在包,Spring会查找其下的类,用来和mapper.xml对应起来 -->  
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">  
        <property name="basePackage" value="com.mytestpro.demo.dao" />  
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>  
    </bean>
  
    <!-- 事务管理 -->  
    <bean id="transactionManager"  
        class="org.springframework.jdbc.datasource.DataSourceTransactionManager">  
        <property name="dataSource" ref="dataSource" />  
    </bean>  
  
</beans>

    其中使用到的jdbc.properties配置文件，需要在src上新建这个文件，主要为了配置连接池的相关信息。内容如下：

    driver=com.mysql.jdbc.Driver
url=jdbc:mysql://127.0.0.1:3306/fooler
username=root
password=
#\u5B9A\u4E49\u521D\u59CB\u8FDE\u63A5\u6570  
initialSize=0
#\u5B9A\u4E49\u6700\u5927\u8FDE\u63A5\u6570  
maxActive=20
#\u5B9A\u4E49\u6700\u5927\u7A7A\u95F2  
maxIdle=20
#\u5B9A\u4E49\u6700\u5C0F\u7A7A\u95F2  
minIdle=1
#\u5B9A\u4E49\u6700\u957F\u7B49\u5F85\u65F6\u95F4  
maxWait=60000

    然后在建一系列的包，项目结构如下：
    项目结构

    然后建立TestUser实体，当然了，在Entity包下。

    package com.mytestpro.demo.Entity;

public class TestUser {

    private Integer id;
    private String name;
    private String password;
    private String phone;
    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
    public String getPhone() {
        return phone;
    }
    public void setPhone(String phone) {
        this.phone = phone;
    }
    
}

    接下来就是mybatis的功能的建设了。由于我们在applicationcontext.xml文件里配置了关于mybatis的映射文件存在包（com/mytestpro/demo/mapping/*.xml）和dao接口所在的包（com.mytestpro.demo.dao）。所以这里我们直接把xml文件和dao接口放到对应的包里就好了。

    TestUserMapper.xml文件:

    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.mytestpro.demo.dao.TestUserDao">

    <select id="getUser" parameterType="com.mytestpro.demo.Entity.TestUser" resultType="com.mytestpro.demo.Entity.TestUser">
        select * from test_user where name = #{name} and password= #{password}
    </select> 
</mapper>

    这里需要说明的地方：
    namespace：对应的dao接口的目录及名字。
    id：这个方法的名字，和dao接口的方法名字一定要一样。
    parameterType：传入参数的类型。
    resultType：返回结果的类型。

    对应的dao接口：

    package com.mytestpro.demo.dao;

import com.mytestpro.demo.Entity.TestUser;

public interface TestUserDao {
    TestUser getUser(TestUser user);
}

    然后建立service接口以及实现类，这里先提供一个按照用户名密码查找用户的借口好了。
    接口及其实现类如下：
    UserService:

    package com.mytestpro.demo.service;

import com.mytestpro.demo.Entity.TestUser;

public interface UserService {

    TestUser getUser(TestUser user);
    
}

    UserServiceImpl:

    package com.mytestpro.demo.service.impl;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import com.mytestpro.demo.Entity.TestUser;
import com.mytestpro.demo.dao.TestUserDao;
import com.mytestpro.demo.service.UserService;
@Service
public class UserServiceImpl implements UserService{

    @Autowired
    TestUserDao testUserDao;
    
    @Override
    public TestUser getUser(TestUser user) {
        // TODO Auto-generated method stub
        return testUserDao.getUser(user);
    }

}

    并且为了便于测试，我在Controller层也做了变化，定义了两个函数，一个用于展示登录页面，一个处理登陆的操作：

    package com.mytestpro.demo.Controller;

import org.apache.ibatis.io.ResolverUtil.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

import com.mytestpro.demo.Entity.TestUser;
import com.mytestpro.demo.service.UserService;

@Controller
public class TestController {

    @Autowired
    UserService userService;
    
    @RequestMapping("/test")
    public String test(){
        System.out.println("dsadas");
        return "test";
    }
    
    @RequestMapping("/doLogin")
    public String doLogin(TestUser user){
        TestUser testUser = userService.getUser(user);
        if(testUser!=null){
            System.out.println(testUser.getPhone());
            return "success";
        }else{
            return "false";
        }
    }
}

    对新的Controller的解释：
    test()函数直接让页面展示test.jsp，没什么好说的。
    doLogin调用了service的getUser方法，检测是否有这个用户存在，如果有则进入success.jsp页面，否则进入false.jsp页面。
    三个页面的内容如下：
    test.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>
    <% 
    String path = request.getContextPath();
    String basePath = request.getScheme() + "://"
            + request.getServerName() + ":" + request.getServerPort()
            + path + "/";
    %>
    <title>TestLogin</title>
    <link rel="stylesheet" type="text/css" href="bower_components/bootstrap/dist/css/bootstrap.min.css">
    <link rel="stylesheet" href="https://cdn.static.runoob.com/libs/bootstrap/3.3.7/css/bootstrap.min.css">  
</head>
<body>
    <div class="container">
          <h2>Please input your name and password</h2>
          <form action="${basepath}doLogin">
          
              <div class="input-group">
                <span class="input-group-addon" >UserName</span>
                <input type="text" class="form-control" id="name" name="name">
            </div>
            <br>
            <div class="input-group">
                <span class="input-group-addon">Password</span>
                <input type="password" id="password" name="password" class="form-control" >
            </div>
            <br>    
            <div class="input-group">
                <button id="fat-btn" class="btn btn-success" type="submit">登录</button>
            </div>
              
          </form>
          
    </div>
<script type="text/javascript" src="bower_components/angular/angular.min.js"></script>
</body>
</html>

    为了美观，这里使用了bootstrap，form的action直接将表单提交到doLogin方法中（字段会自动封装到TestUser实体中）。

    success.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>Insert title here</title>
</head>
<body>
    登陆成功！
</body>
</html>

    false.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>Insert title here</title>
</head>
<body>
    登陆失败！
</body>
</html>

    我们数据库中现有的数据：
    数据库数据

    操作页面，用户名whr，密码123456：
    操作

    登陆结果：
    结果

    最后的项目结构：

    图片描述

    至此，一个最简单的SpringMVC+Spring+MyBatis的框架搭建完成了。

    代码可以在这里下载到，密码是：ubrr，这里的代码是我从workspace直接copy出来的。

    最后的梳理

    也不说那些专业的了，毕竟那些百度都能看到，说一下我对运行的直观理解吧。
    SpringMVC主要负责从页面上到我们程序中的流转，页面上的请求按照@RequestMapping的地址转到对应的方法中，然后这个方法中我们调用Service接口，Service的接口实现中，再调用Dao层的东西，这里就是MyBatis了。Spring主要负责了bean的注入，说白了就是不用我们自己new了，用一个注解比如@Autowired就可以注入一个接口。而MyBatis呢，就是为了方便使用数据库，对数据库进行操作的一个框架。

    总结就这么多吧。
    如果看到这里希望你也是已经能搭建成功了。
    我也是新手，不熟练，文中如有不当还望各位指出，谢谢！

    springspring-mvcmybatisjava-ee框架
    羊都是我吃的
    1.4k 声望2.9k 粉丝

    将来的你，一定会感谢现在拼命努力的自己。

    « 上一篇
    前台传中文到后台Controller乱码问题的解决
    下一篇 »
    dubbo 2.5.3对于java.sql的反序列化BUG

    引用和评论

    推荐阅读
    头像
    Spring中的循环依赖

    羊都是我吃的阅读 1.3k

    头像
    Spring 实现 3 种异步流式接口，干掉接口超时烦恼

    程序员小富赞 4阅读 1k

    头像
    MySQL 亿级数据平滑迁移实战

    vivo互联网技术赞 2阅读 812

    头像
    Thymeleaf的使用

    zZ_jie赞 3阅读 269

    头像
    Spring Boot创建定时任务

    杜若赞 1阅读 2.3k

    头像
    Spring Boot 中的上下文

    zZ_jie赞 2阅读 289

    头像
    spring使用@Async注解导致循环依赖问题异常的排查

    我不是码农阅读 957

    0 条评论
    得票最新