搭建SpringMVC+Mybatis轻量级框架

 
1 介绍
1.1 描述
本实验主要描述轻量级MVC框架（jquery+Spring MVC+Spring+Mybatis）的搭建。本实验分为两步骤进行介绍，第一步讲述Spring MVC框架环境的搭建，第二步讲述Spring与Mybatis框架的整合配置。
 
1.2 目的
学习轻量级MVC框架的搭建。通过本次实验要掌握Spring MVC框架的搭建，以及Spring与Mybatis框架的整合，并掌握Spring 事务的配置。
2 过程
2.1 Spring MVC环境搭建
2.1.1 创建动态Web项目。
鼠标点击File—>New—>Other。如图：
 
在弹窗中选择Web—>Dynamic Web Project，如下图：
 
输入项目名称：mvc_demo
 
点击Next两次，出现如下弹窗勾选复选框，完成。
 
完成后左侧导航栏如图：
 
2.1.2 修改项目配置。
选中项目右键，点击Properties。如图
 
在弹窗中选择Java Build Path按照下图顺序修改默认输出路径将build修改成WebContent/WEB_INF,点击完成。


修改项目编码格式，选中项目右键，点击Properties。选择ResourceOther:UTF-8，点击ok完成编码格式的设定。
 
2.1.3 Spring Jar包引入（相关类库可以在我的资源找到：Spring+Mybatis相关类库）
打开相关类库文件夹，一共有5个文件夹：
common文件夹：存放整个项目依赖的公用jar包；
js文件夹：存放前端依赖的js文件；
mybatis文件夹：存放后台持久化数据库Mybatis所依赖的jar包；
spring文件夹：spring框架的依赖jar包；
upload文件夹：文件上传的一些jar包。
首先，打开common文件夹复制所有的jar，粘贴到WEB-INF文件下的lib目录（该目录用于存放项目中所有用到的jar），如下图所示：
 
接着，复制spring文件下的所有jar包到lib中。至此，完成了spring框架jar引入。
2.1.4 Spring框架配置
2.1.4.1 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" 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">
  <display-name>demo01</display-name>
  <!-- 配置需要装载的Spring配置文件 -->
<!-- 默认的路径是"/WEB-INF/applicationContext.xml，多个路径用“，”号隔开 -->
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
    /WEB-INF/spring/applicationContext.xml    
    </param-value>
</context-param>


<!-- Spring监听配置，Web容器启动自动装配ApplicationContext的配置信息 -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>


<!-- Spring字符编码过滤器配置，处理中文乱码，针对post请求 -->
<filter>
<filter-name>characterEncodingFilter</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>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<!-- Spring Servlet配置 -->
<servlet>
<servlet-name>spring</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<!-- 默认的路径是"/WEB-INF/spring-servlet.xml，多个路径用“，”号隔开 -->
<param-value>/WEB-INF/spring/spring-servlet.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>spring</servlet-name>
<url-pattern>/service/*</url-pattern>
</servlet-mapping>


<welcome-file-list>
<welcome-file>jsp/index.jsp</welcome-file>
</welcome-file-list>


</web-app>
2.1.4.2 Spring MVC中文乱码解决办法
为了解决中文乱码问题，我们需要修改tomcat的server.xml配置文件，在路径D:\apache-tomcat-7.0.30\conf中打开server.xml。
找到
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
改为：
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8"/>。
打开eclipse中Servers下面的server.xml文件。
 
同样找到上面那段代码，我们将server.xml改为：
<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8"/>
2.1.4.3 应用上下文配置
Spring配置用于开启基于注解的spring功能，照web.xml中设定，在WEB-INF中添加名为spring的文件夹。然后，在该文件夹下添加applicationContext.xml。选中spring文件夹，鼠标右键选择File
 
添加applicationContext.xml文件名，点击完成。
 
配置applicationContext.xml如下：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:context="http://www.springframework.org/schema/context"
xmlns:beans="http://www.springframework.org/schema/beans"
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:mvc="http://www.springframework.org/schema/mvc" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
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
                    ">
                   
</beans>
2.1.4.4 DispatchServlet配置
Spring servlet配置用于开启基于注解的spring MVC功能，照web.xml中设定，在spring文件中建立spring-servlet.xml，过程同上。在spring-servlet.xml中添加如下代码：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:context="http://www.springframework.org/schema/context"
xmlns:beans="http://www.springframework.org/schema/beans"
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:mvc="http://www.springframework.org/schema/mvc" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
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.inspur"></context:component-scan>


<!-- 对模型视图名称的解析，在请求时模型视图名称添加前后缀 -->
<bean
class="org.springframework.web.servlet.view.InternalResourceViewResolver"
p:prefix="/jsp/" 
p:suffix=".jsp" >
    </bean>
</beans>  
至此，spring mvc框架搭建成功目录结构如下：
 
2.1.4.5 文件上传配置
复制相关类库下upload文件夹中的所有jar包到lib目录下。修改spring-servlet.xml文件添加文件上传的配置。添加如下代码中红色字体部分。
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:context="http://www.springframework.org/schema/context"
xmlns:beans="http://www.springframework.org/schema/beans"
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:mvc="http://www.springframework.org/schema/mvc" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
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.inspur"></context:component-scan>
<!-- 对模型视图名称的解析，在请求时模型视图名称添加前后缀 -->
<bean
class="org.springframework.web.servlet.view.InternalResourceViewResolver"
p:prefix="/jsp/" 
p:suffix=".jsp">
</bean>
<!-- 多部分文件上传 -->
<bean id="multipartResolver"
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<property name="maxUploadSize" value="104857600" />
<property name="maxInMemorySize" value="4096" />
<property name="defaultEncoding" value="UTF-8"></property>
</bean>

</beans>  


2.1.4.6 测试运行。
首先，在WebContent中添加jsp文件夹，在文件夹下创建index.jsp文件。创建步骤同.xml文件。将文件名命名为index.jsp。 
复制如下代码到该文件。
<%@ page language="java" contentType="text/html; charset=gb2312"
    pageEncoding="gb2312"%>
<!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=gb2312">
<title>首页</title>
</head>
<body>
<h>恭喜环境搭建成功!</h>
</body>
</html>
在WebContent下创建skin文件夹（该文件夹主要用来存放前端js文件和样式文件CSS）。接着，在skin文件下创建css和js文件夹。同时，将相关类库中js文件夹下的jquery.js和ajaxfileupload.js复制到js相应目录。如图：
 
为了能让项目正常运行，我们需要将相应的jar包添加到编译路径中。按照上面的步骤在Java Build Path中选择Libraries。点击Add JARs。在弹窗中选择mvc_demo项目找到WEB-INF下lib目录，选择该目录下所有jar包点击ok。
 
接着，添加jsp和servlet依赖jar包，点击Add External JARs，在弹出框中选择D盘tomcat目录下的lib文件，将jsp-api.jar和servlet-api.jar选中点击“打开”，添加到路径中。最后，点击确定完成jar导入。
 
在server视图，选中该tomcat右键选择Add and Remove如下图：
 
选择当前文件，add添加，完成项目部署。
 
选中tomcat右键选择publish，再start启动。
 
浏览器输入: http://localhost:8080/mvc_demo/jsp/index.jsp.出现如图界面，表示搭建成功：
 
为了后面的实验，这里我们再在jsp文件夹下添加一个rest.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">
<script type="text/javascript" src="<%=request.getContextPath()%>/skin/js/jquery.js"></script>
<title>Insert title here</title>
<script type="text/javascript">
$(function($){
$("#submit").bind("click",function(){
var methodName = $("#methodName").val();
var url = $("#urlPath").val();
var param = $("#param").val();
$.ajax({
url : url,
contentType: "application/json;charset=utf-8",
data : param,
async : false,
type: methodName,
success : function(data) {
$("#result").html(data);
},
error : function(data){
$("#result").html(data.responseText);
}
});
});
});
</script>
</head>
<body>

<table>
<tr><td>Method</td><td><select id="methodName"><option value="get">get</option><option value="post">post</option></select></td></tr>
<tr><td>URL</td><td><input id="urlPath" type="text" size="100" ></td></tr>
<tr><td>参数</td><td><textarea id="param" rows="3" cols="100"></textarea></td></tr>
<tr><td colspan="2"><input type="submit" id="submit" value="提交"/></td></tr>
</table>
<div id="result" style="border: 1px solid; #ced">
</div>
</body>
</html>


2.2 Spring与Mybatis整合 
2.2.1 Mybatis jar引入：
在上面实验基础上复制相关类库文件中mybatis文件下的所有jar包到lib目录下。
2.2.2 Mybatis配置
在上面项目的spring文件夹下添加datasource.xml数据源文件，用来配置数据源信息。添加如下代码：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:tx="http://www.springframework.org/schema/tx" xmlns:p="http://www.springframework.org/schema/p"
xmlns:aop="http://www.springframework.org/schema/aop" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans   
    http://www.springframework.org/schema/beans/spring-beans-3.2.xsd   
    http://www.springframework.org/schema/tx   
    http://www.springframework.org/schema/tx/spring-tx-3.2.xsd   
    http://www.springframework.org/schema/aop    
    http://www.springframework.org/schema/aop/spring-aop-3.2.xsd">
<!-- 配置数据源 -->
<bean id="dataSource"
class="org.springframework.jdbc.datasource.DriverManagerDataSource">
<property name="driverClassName">
<value>com.mysql.jdbc.Driver</value>
</property>
<property name="url">
<value>jdbc:mysql://localhost:3306/databaseName?characterEncoding=UTF-8
</value>
</property>
<property name="username">
<value>username</value>
</property>
<property name="password">
<value>password</value>
</property>
</bean>
</beans>
注：数据源配置中标红的字体需要修改成和自己匹配的数据信息。其中，databaseName：填写自己需要连接的数据库名称；
username：对应数据库的用户名称；
password：该用户的用户名密码。
在spring文件下添加Mybatis配置文件mybatis-config.xml。复制如下代码到该文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "classpath:/mybatis-3-config.dtd">


<configuration>
<settings>
<setting name="jdbcTypeForNull" value="NULL" />
<setting name="callSettersOnNulls" value="true" />
        <setting name="logImpl" value="LOG4J" />    
    </settings>
</configuration>
在spring文件下添加Mybatis上下文配置文件mybatis-context.xml。该文件用来配置和spring框架的依赖。复制如下代码到该文件。
<?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:tx="http://www.springframework.org/schema/tx"
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/tx 
http://www.springframework.org/schema/tx/spring-tx-3.2.xsd"
>


<bean id="mybatisTransactionManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>


<tx:annotation-driven transaction-manager="mybatisTransactionManager" />


<!-- define the SqlSessionFactory -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<property name="configLocation" value="/WEB-INF/spring/mybatis-config.xml"/>
</bean>
<!-- 定义扫描路径 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.inspur.**.dao" />
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
</bean> </beans>
修改web.xml文件。添加Mybatis配置文件路径。添加如下红色字体代码。
<?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">
  <display-name>demo01</display-name>
  <!-- 配置需要装载的Spring配置文件 -->
<!-- 默认的路径是"/WEB-INF/applicationContext.xml，多个路径用“，”号隔开 -->
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
    /WEB-INF/spring/datasource.xml
/WEB-INF/spring/mybatis-context.xml
    /WEB-INF/spring/applicationContext.xml    
    </param-value>
</context-param>


<!-- Spring监听配置，Web容器启动自动装配ApplicationContext的配置信息 -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>


<!-- Spring字符编码过滤器配置，处理中文乱码，针对post请求 -->
<filter>
<filter-name>characterEncodingFilter</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>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<!-- Spring Servlet配置 -->
<servlet>
<servlet-name>spring</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<!-- 默认的路径是"/WEB-INF/spring-servlet.xml，多个路径用“，”号隔开 -->
<param-value>/WEB-INF/spring/spring-servlet.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>spring</servlet-name>
<url-pattern>/service/*</url-pattern>
</servlet-mapping>


<welcome-file-list>
<welcome-file>jsp/index.jsp</welcome-file>
</welcome-file-list>


</web-app>
2.2.3 添加jar到编译路径
为了能让项目正常运行，我们需要将Mybatis的jar包添加到编译路径中。按照上面的步骤在Java Build Path中选择Libraries。点击Add JARs。在弹窗中选择mvc_demo项目找到WEB-INF下lib目录，选择该目录下刚刚添加的Mybatis jar包点击ok。
至此，Spring与Mybatis整合搭建完成，按照上面验证spring的方法，重新发布该项目到tomcat，然后运行，查看console控制台是否正常。
3 总结


1、 学会搭建Spring MVC框架，掌握环境搭建过程中一些重要文件的配置和参数作用。学会如何解决请求中出现的中文乱码问题。
2、 学会Spring MVC和Mybatis整合配置。掌握Mybatis配置文件的编写和注意事项。