搭建SpringMVC+MyBatis+MySql框架

第一次搭建springmvc+mybatis框架还是踩了不少坑。通过不断的搜索和比对别人的搭建过程，还是让我搭建出来了。于是，打算总结一下我的搭建过程，并附上所需的jar包。希望能帮到下一个要搭建SpringMVC框架的人。

搭建框架的大致步骤是：

• 导入相关jar包；
• 添加并配置springmvc、mybatis文件；
• 在web.xml中配置springmvc和mybatis文件；
• 在代码中的使用。

一、依赖的jar包

我用到的jar包可以点击这里下载，主要是spring的框架包，这个可以到官网下载最新版。还有mybatis的jar包，mybatis-spring(这个尽量用最新版的，可以到这里下载,之前搭建的时候因为用的是旧版的，有出现了强转失败的情况，新版则没有。)以及其他相关的jar包。具体如下图

二、添加springmvc-servlet.xml配置文件

这个文件我是放到WEB-INF目录下（这个路径在后面web.xml配置中需要用到）。主要配置了需要注解驱动、扫描包文件、已经jsp路径，代码如下

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:mvc="http://www.springframework.org/schema/mvc" 
    xmlns:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-3.2.xsd 
    http://www.springframework.org/schema/mvc
    http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd">  
      
     <!-- 启动注解驱动的Spring MVC功能，注册请求url和注解POJO类方法的映射-->  
     <mvc:annotation-driven />  
     <!-- 启动包扫描功能，以便注册带有@Controller、@Service、@repository、@Component等注解的类成为spring的bean -->  
     <context:component-scan base-package="com.jarvis" />  
     
    <!-- 启动SpringMVC的注解功能，完成请求和注解POJO的映射 -->
    <bean
        class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
    </bean>
     
     <!-- 对模型视图名称的解析，在请求时模型视图名称添加前后缀,除了index.jsp，其他jsp页面都放在了WEB-INF/view下面了。 -->  
     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" p:prefix="/WEB-INF/view/" p:suffix=".jsp" />  
</beans>

三、配置mybatis

（1）、spring-mybatis配置文件

1、前提是mysql数据库已经装好，且测试正常。那么，接下来就是配置mybatis文件了。

<?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">
    <!-- 自动扫描,dao目录下的接口文件 -->
    <context:component-scan base-package="com.jarvis.dao" />
    <!-- 引入配置文件 -->
    <bean id="propertyConfigurer"
        class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <property name="location" value="classpath:datasource.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>
    <!-- spring和MyBatis完美整合，不需要mybatis的配置映射文件 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource" />
        <!-- 自动扫描mapping.xml文件 -->
        <property name="mapperLocations" value="classpath:com/jarvis/mapping/*.xml"></property>
    </bean>
    <!-- DAO接口所在包名，Spring会自动查找其下的类 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.jarvis.dao" />
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
    </bean>
    <!-- (事务管理)transaction manager, use JtaTransactionManager for global tx -->
    <bean id="transactionManager"
        class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource" />
    </bean>
</beans>

（2）、mysql配置参数

在上面的配置文件中，可以看到参数是通过

<!-- 引入配置文件 -->
   <bean id="propertyConfigurer"
       class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
       <property name="location" value="classpath:datasource.properties" />
   </bean>

来引入的，引入的文件为datasource.properties，添加properties文件主要是为了方便数据库配置

driver=com.mysql.jdbc.Driver
#访问地址和端口号，test为数据库名
url=jdbc:mysql://127.0.0.1:3306/test
#用户名
username=root
#密码
password=123456
#定义初始连接数
initialSize=0
#定义最大连接数
maxActive=20
#定义最大空闲
maxIdle=20
#定义最小空闲
minIdle=1
#定义最长等待时间
maxWait=60000

四、配置web.xml

基本的配置文件都写完后，需要在web.xml配置把它们配置进去，才能在项目启动时加载它们。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" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    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和mybatis的配置文件 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring-servlet.xml,
        classpath*:spring-mybatis.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- 配置spring核心servlet -->
    <servlet>
        <servlet-name>spring</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <!-- url-pattern配置为/，不带文件后缀，会造成其它静态文件(js，css等)不能访问。如配为*.do，则不影响静态文件的访问 -->
    <servlet-mapping>
        <servlet-name>spring</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <!-- 编码过滤器 -->
    <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>
    <!-- 防止Spring内存溢出监听器 -->
    <listener>
        <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
    </listener>
    <welcome-file-list>
        <welcome-file>/index.jsp</welcome-file>
    </welcome-file-list>
    <!-- 配置SESSION超时，单位是分钟 -->
    <session-config>
        <session-timeout>15</session-timeout>
    </session-config>
</web-app>

五、使用流程

到这边的话，就基本是配置完了。接下来，就来看看如何使用了。首先，我们假设一个业务流程，根据用户的id来获取用户名，并显示到页面上。

1、添加表及数据

我在mysql中创建了一个test数据库，并添加了一个user的表

• 建表语句

  create table user 
  ( 
  id INT NOT NULL PRIMARY KEY AUTO_INCREMENT COMMENT '编号', 
  name varchar(32) NOT NULL  COMMENT '姓名',
  password varchar(128) NOT NULL  COMMENT '密码'
  
  );

• 添加的数据

  insert into user values(2,"test","123456")

2、添加constroller

首先是在com.jarvis包下添加一个constroller包，专门用来方式constroller。然后创建一个LoginConstroller.java，代码如下

package com.jarvis.constroller;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;

import com.jarvis.pojo.User;
import com.jarvis.serv.IUserService;

@Controller  
@RequestMapping("/user")
public class LoginConstroller {
	
	@Resource
	private IUserService userService;
	
	 public LoginConstroller() {}  
	    @RequestMapping(value = "/login/{id}", method = RequestMethod.GET)  
	    public ModelAndView myMethod(HttpServletRequest request,HttpServletResponse response,   
	            @PathVariable("id") String id, ModelMap modelMap) throws Exception {  
	      
                User users = userService.getUserById(Integer.valueOf(id));
	        modelMap.put("loginUser", users.getUserName());  
	        return new ModelAndView("/login/hello", modelMap);  
	    }

上面这个方法是通过url传入id，然后通过id查询数据库，并取出用户，信息输入用户名，然后跳转到/login下的hello.jsp。从这个类中可以看到，除了查询数据库的service外，还有一个pojo类User。接下来，就先创建pojo类。

3、添加pojo

package com.jarvis.pojo;
public class User {
    private Integer id;
    private String userName;
    private String password;
    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 == null ? null : userName.trim();
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password == null ? null : password.trim();
    }
}

4、添加userService

这边需要注意的是，在controller中使用到的userService，是通过注解来完成，而注解的名称就是userService。所以在添加userService时，需要注意一下，不要写错了。

• 先添加一个接口IUserService

  package com.jarvis.serv;
  import com.jarvis.pojo.User;
  public interface IUserService {
      public User getUserById(int userId);
  }

• 添加实现类UserServiceImpl

  package com.jarvis.serv.impl;
  
  import org.springframework.beans.factory.annotation.Autowired;
  import org.springframework.beans.factory.annotation.Qualifier;
  import org.springframework.stereotype.Service;
  
  import com.jarvis.dao.IUserDao;
  import com.jarvis.pojo.User;
  import com.jarvis.serv.IUserService;
  
  @Service("userService")
  public class UserServiceImpl implements IUserService {
  	@Autowired
      @Qualifier("IUserDao")
  	private IUserDao IUserDao;
  	@Override
  	public User getUserById(int userId) {
  		return this.IUserDao.selectByPrimaryKey(userId);
  	}
  
  }

这里用到的IUserDao是直接在UserServiceImpl这个类中注解的。

5、添加dao

package com.jarvis.dao;

import org.springframework.transaction.annotation.Isolation;
import org.springframework.transaction.annotation.Propagation;
import org.springframework.transaction.annotation.Transactional;

import com.jarvis.pojo.User;
@Transactional(propagation=Propagation.REQUIRES_NEW,readOnly=false,isolation=Isolation.DEFAULT)
public interface IUserDao {
    User selectByPrimaryKey(Integer id);
}

6、添加dao对应的mapper文件

<?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.jarvis.dao.IUserDao" >

  <resultMap id="BaseResultMap" type="com.jarvis.pojo.User" >
    <id column="id" property="id" jdbcType="INTEGER" />
    <result column="name" property="userName" jdbcType="VARCHAR" />
    <result column="password" property="password" jdbcType="VARCHAR" />
  </resultMap>

  <sql id="Base_Column_List" >
    id, name, password
  </sql>

  <select id="selectByPrimaryKey" resultMap="BaseResultMap" parameterType="java.lang.Integer" >
    select 
 <include refid="Base_Column_List" />
   from user where id = #{id,jdbcType=INTEGER}
  </select>

</mapper>

7、添加对应的页面

因为在springmvc-servlet中，我们把页面的路径放到了WEB-INF目录下的view目录，而在LoginController中返回的路径是login下的hello.jsp,所以，我们首先要在WEB-INF下创建一个view目录，在view下，创建一个login目录，在login目录下创建一个名为hello的jsp文件。
hello.jsp的代码如下

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  
<%  
String path = request.getContextPath();  
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";  
%>  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
<html>  
<head>  
<base href="<%=basePath%>">  
<title>My JSP 'hello.jsp' starting page</title>  
<meta http-equiv="pragma" content="no-cache">  
<meta http-equiv="cache-control" content="no-cache">  
</head>  
<body>  
    你好:<%=request.getAttribute("loginUser") %>，现在时间是<%= new Date() %>  
</body>  
</html>

8、测试

到这边，就可以开始测试了。不过首先，我们要搞清楚访问的url。首先肯定是http://ip:端口/项目名，然后是看LoginController中，类的@RequestMapping是"/user",方法的@RequestMapping是"/login/{id}"。其中的{id}是我们要传的值。所以，访问的url是

http://localhost:8080/项目名/user/login/id

运行效果如下：