Spring+SpringMVC4+Mybatis3+MySQL框架环境搭建和案例解析

来源:互联网 发布:宠物商店淘宝 编辑:程序博客网 时间:2024/06/06 18:37
  • 框架需求
  • 案例解析
  • 经验问题总结

SSM框架,已经被越来越多的公司企业所采用的主流框架。本人出于兴趣原因,利用业余时间,从CSDN上找了一些案例进行学习、研究,在案例的反复调试、测试过程中,遇到了很多问题(因为很多案例解析不详细,导致我反复碰壁~_~)。因此,我将在调试过程中遇到的问题和小小的心得分享出来,供各位网友借鉴。声明:高手请匆匆而过!针对一些初学者和有兴趣研究一下这个框架的同学,本文可能有一定的借鉴意义。

框架需求

1. IDE:eclipse(for jee)

2. 所需jar包:

  • spring jar包
    这里写图片描述
  • mybatis jar包
    这里写图片描述
  • MySQL jar包(jdbc数据库链接)
    这里写图片描述
  • 其他 jar包 (log、jstl)
    这里写图片描述

将上面的所有jar整合以后,全部放在WEB-INF下的lib文件夹中,如下:
这里写图片描述

案例解析

通过实际案例,分析代码,是学习知识最便捷的方式,因此,下面,我将通过一个“用户信息的增改删查”案例,详细介绍Spring+SpingMVC+Mybatis+Mysql框架的搭建和功能实现。

1. 新建web project项目

-项目名称:SpringAndMybatis

2. 在WEB-INF下,新建lib文件夹,并拷贝进上面所提到的所有jar包。

3. 配置web.xml

  • 声明入口页面:即在index.jsp(这里切记一点:index.jsp文件必须放在WebContent文件夹下,不能放在WEB-INF下,否则,启动以后,无法进入第一个页面。

  • 声明spring和mybatis配置文件:

    <!-- Spring和mybatis的配置文件 -->      <context-param>          <param-name>contextConfigLocation</param-name>          <param-value>classpath:applicationContext.xml</param-value>      </context-param>  
  • 声明spring监听器:
    <!-- Spring监听器 -->      <listener>          <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>      </listener>      <!-- 防止Spring内存溢出监听器 -->      <listener>          <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>      </listener>
  • 声明编码过滤器(编码过滤器是web开发中一般都是要使用的)
    <!-- 编码过滤器 -->      <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> 
  • 声明dispatcherServlet(这是SpringMVC核心映射管理器)
    <!-- Spring MVC servlet -->      <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:spring-mvc.xml</param-value>          </init-param>          <load-on-startup>1</load-on-startup>          <async-supported>true</async-supported>      </servlet>      <servlet-mapping>          <servlet-name>SpringMVC</servlet-name>          <!-- 此处可以可以配置成*.do,对应struts的后缀习惯 -->          <url-pattern>*.do</url-pattern>      </servlet-mapping>
  • 声明静态文件映射(在SpringMVC中,为了能访问静态文件,一般都需要声明静态文件映射)
    <!-- 配置静态资源不经过spring mvc -->    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.css</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.js</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.json</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.gif</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.png</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.jpg</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.ico</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.doc</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.xls</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.docx</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.xlsx</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.txt</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.swf</url-pattern>    </servlet-mapping>    <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.ocx</url-pattern>    </servlet-mapping>        <servlet-mapping>        <servlet-name>default</servlet-name>        <url-pattern>*.cab</url-pattern>    </servlet-mapping>   

至此,web.xml基本配置完毕!

4. 配置applicationContext.xml

说明:在web.xml文件中,显示声明了上下文配置文件(即spring和mybatis配置文件)为classpath:applicationContext.xml
classpath:意思是只在class目录下(注意区别classpath*)。

  • beans头声明:
<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:tx="http://www.springframework.org/schema/tx"     xmlns:mvc="http://www.springframework.org/schema/mvc"      xmlns:aop="http://www.springframework.org/schema/aop"    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/mvc                            http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd                        http://www.springframework.org/schema/aop                        http://www.springframework.org/schema/aop/spring-aop-4.0.xsd                        http://www.springframework.org/schema/tx                        http://www.springframework.org/schema/tx/spring-tx-4.0.xsd">  

这里需要注意:所有需要添加的链接都不能缺少,而且,同类声明之间不能随便隔开,例如:
这里写图片描述
上图,被红方框圈起来的两个链接,被其中选定的链接隔开了,就会报错(有些标签找不到声明)如下:
cvc-complex-type.2.4.c: The matching wildcard is strict, but no declaration can be found for element ‘tx:annotation-driven’.

  • SpringMVC“注解”声明和扫描(每个SpringMVC都必须要配置的内容,只有配置这里,dispatcherServlet才能根据请求,找到指定的controller进行处理):
  <!-- spring基础配置 begin -->      <context:annotation-config/>    <!-- 自动扫描 -->      <context:component-scan base-package="com.test" /> 
  • 声明数据库链接配置信息:

这里首先需要建立一个数据库链接配置文件,这里以jdbc为例–“jdbc.properties”,该文件一般与其他配置文件放在一个目录下,例如:
这里写图片描述
jdbc-properties配置文件内容如下:

这里写图片描述
上图:mybatis为数据库名。

引入数据库配置文件:

   <!-- 引入配置文件 -->      <bean id="propertyConfigurer"          class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">          <property name="location" value="classpath:jdbc.properties" />      </bean>  
  • 配置数据源(DataSource):
    <!-- 1.配置数据源(dataSource) -->        <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">            <!-- driver -->            <property name="driverClassName">                <value>${jdbc.driver}</value>            </property>            <!-- url -->            <property name="url">                <value>${jdbc.url}</value>            </property>            <!-- username -->            <property name="username">                <value>${jdbc.username}</value>            </property>            <!-- password -->            <property name="password">                <value>${jdbc.password}</value>            </property>        </bean> 
  • 声明与数据库进行具体操作的mapper.xml(具体内容即sql操作语句)的位置信息:
    <!-- 2.spring和MyBatis完美整合,不需要mybatis的配置映射文件 -->      <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">          <property name="dataSource" ref="dataSource" />          <!-- 自动扫描mapper.xml文件 :这里有下面两种方式-->          <!-- 第一种是:直接声明mapper.xml文件所在位置 (如采用这种方式,则不需要mybatis-config.xml配置文件)-->        <!-- <property name="mapperLocations" value="classpath:mapper/*.xml"></property> -->        <!-- 第二种是:采用mybatis配置文件(mybatis-config.xml)的方式来间接声明mapper.xml文件的位置,同时,这里可以直接定义mapper.xml文件中所用到的各种类的别名 -->        <property name="configLocation" value="classpath:mybatis-config.xml" />      </bean>

从上图,大家可以看到,我已经说明了两种声明方式,第一种是直接通过mapperLocations指定*mapper.xml文件位置;
这里写图片描述
上图声明的是mapperLocation,位置是在class路径下的mapper文件夹下的所有xml文件,即mapper.xml。

另一种是间接通过声明mybatis的配置文件(mybatis-config.xml)位置,声明*mapper.xml的位置信息,当然mybatis-config.xml还可以*mapper.xml文件中所有类型的别名等。
这里写图片描述
上图声明的mybatis配置文件在class路径下,名字为mybatis-config.xml,该文件其中声明了*mapper.xml的位置。

  • 声明与*mapper.xml对应的DAO所在包名(这个很关键!必须要正确!)
    <!-- 3.DAO接口所在包名,Spring会自动查找其下的类 -->      <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">          <property name="basePackage" value="com.test.mapper" />          <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>      </bean>

上图,所有与各种*mapper.xml对应的DAO,都放在了com.test.mapper包下。

  • 设定事务管理(transactionManager)
    <!-- 4.设定事务管理配置(transactionManager) -->        <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">                <property name="dataSource" ref="dataSource" />      </bean>        <!-- 通过注解配置事务 -->     <!-- 5. 使用声明式事务           transaction-manager:引用上面定义的事务管理器       -->      <tx:annotation-driven transaction-manager="txManager" />     <!-- spring基础配置 end -->  

至此,spring和mybatis全局配置文件,总算配置完成了~

5. 配置mybatis的配置文件–mybatis-config.xml

  • 声明mybatis-config.xml(如果在applicationContext.xml中声明*mapper.xml位置信息的方式采用的是第二种:configLocation的形式。否则,这个文件就不需要配置)

这里写图片描述

上图,最关键的是(必须配置的):
这里写图片描述
这个配置,是与前面第一种mapper.xml位置信息声明异曲同工:

这里写图片描述

  • 别名设置:

这里写图片描述

如果这里不设置User和Integer的别名,那么在mapper.xml中的类型,就必须要声明清楚:java.lang.Integer,com.test.model.User。

6. 配置DispatcherServlet的配置文件–spring-mvc.xml

说明:web.xml显式声明了DispatcherServlet——SpringMVC的contextConfigLocation是class路径下的spring-mvc.xml(如果这里没有声明,系统将默认SpringMVC的配置文件是SpringMVC-Servlet.xml)。

  • 配置Controller控制器所在包名,以及视图解析器的解析模式。
    <!-- 注解驱动:相当于注册了DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter两个bean,配置一些messageconverter。即解决了@Controller注解的使用前提配置。 -->      <mvc:annotation-driven/>      <!-- 配置自动扫描的包路径:自动扫描该包,使SpringMVC认为包下用了@controller注解的类是控制器  -->        <context:component-scan base-package="com.test"/>       <!-- 定义跳转的文件的前后缀 ,视图模式配置-->      <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">          <!-- 这里的配置我的理解是自动给后面action的方法return的字符串加上前缀和后缀,变成一个 可用的url地址 -->          <property name="prefix" value="/WEB-INF/" />          <property name="suffix" value=".jsp" />      </bean>
  • 配置json响应模式以及文件上传下载配置(如果web中需要页面响应功能–“添加成功”“删除成功”等提示,以及文件上传下载功能)
  <!--避免IE执行AJAX时,返回JSON出现下载文件 -->      <bean id="mappingJacksonHttpMessageConverter"          class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter">          <property name="supportedMediaTypes">              <list>                  <value>text/html;charset=UTF-8</value>              </list>          </property>      </bean>      <!-- 启动SpringMVC的注解功能,完成请求和注解POJO的映射 -->      <bean          class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">          <property name="messageConverters">              <list>                  <ref bean="mappingJacksonHttpMessageConverter" /> <!-- JSON转换器 -->              </list>          </property>      </bean>          <!-- 配置文件上传,如果没有使用文件上传可以不用配置,当然如果不配,那么配置文件中也不必引入上传组件包 -->      <bean id="multipartResolver"            class="org.springframework.web.multipart.commons.CommonsMultipartResolver">            <!-- 默认编码 -->          <property name="defaultEncoding" value="utf-8" />            <!-- 文件大小最大值 -->          <property name="maxUploadSize" value="10485760000" />            <!-- 内存中的最大值 -->          <property name="maxInMemorySize" value="40960" />        </bean>

至此,SpringMVC最关键的DispatcherServlet配置完成~

7.配置mapper.xml

例如,在本案例中,操作数据库表User,所对应的mapper.xml是UserMapper.xml,它对应的类是com.test.mapper下面的类UserMapper。
UserMapper.java:

package com.test.mapper;import java.util.List;import com.test.model.User;public interface UserMapper {    void save(User user);    boolean update(User user);    boolean delete(int id);    User findById(int id);    List<User> findAll();}

UserMapper.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">  <!--     这里需要注意的事项:      1.namespace:必须与对应的接口全类名一致      2.id:必须与对应接口的某个对应的方法名一致      3.数据类型(例如User、Integer等,如果在mybatis-config中已经声明了别名,则直接使用别名,否则,必须使用全名(例如com.test.model.User、java.lang.Integer))  --> <mapper namespace="com.test.mapper.UserMapper">    <insert id="save" parameterType="User">        insert into user (user_name,user_age) values (#{userName},#{age})    </insert>    <update id="update" parameterType="User">        update user set user_name=#{userName}, user_age=#{age} where user_id=#{id}    </update>    <delete id="delete" parameterType="Integer">        delete from user where user_id=#{id}    </delete>    <select id="findById" parameterType="Integer" resultType="User">        select user_id id,user_name userName,user_age age from user where user_id =#{id}    </select>    <select id="findAll" resultType="User">        select user_id id,user_name userName,user_age age from user    </select></mapper>

8.编写具体web页面和逻辑代码

这里只贴一下UserController的代码,因为这是前端控制器Controller的处理逻辑。

UserController.java:

package com.test.controller;import java.io.IOException;import java.io.PrintWriter;import java.util.List;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import com.test.service.UserService;import com.test.model.User;@Controller@RequestMapping("/user")public class UserController {    @Autowired    private UserService userService;    /**     * 获取所有用户列表     * @param request     * @return     */    @RequestMapping("/getAllUser.do")    public String getAllUser(HttpServletRequest request){        List<User> findAll = userService.findAll();        request.setAttribute("userList", findAll);        return "allUser";    }    /**     * 跳转到添加用户界面     * @param request     * @return     */    @RequestMapping("/toAddUser.do")    public String toAddUser(HttpServletRequest request){        return "addUser";    }    /**     * 添加用户并重定向     * @param user     * @param request     * @return     */    @RequestMapping("/addUser.do")    public String addUser(User user,HttpServletRequest request){        userService.save(user);        return "redirect:/user/getAllUser.do";    }    /**     * 获取所有用户列表     * @param request     * @return     */    @RequestMapping("/save.do")    public String save(HttpServletRequest request){        System.out.println("save");        User user = new User();        user.setUserName("yanwenju");        user.setAge("100");        userService.save(user);        //request.setAttribute("userList", findAll);        return "index";    }    /**     * 删除用户     * @param id     * @param request     * @param response     */    @RequestMapping("/deleteUser.do")    public void delUser(int id,HttpServletRequest request,HttpServletResponse response){        String result = "{\"result\":\"error\"}";        if(userService.delete(id)){            result = "{\"result\":\"success\"}";        }        response.setContentType("application/json");        try {            PrintWriter out = response.getWriter();            out.write(result);        } catch (IOException e) {            e.printStackTrace();        }    }    /**     * 根据id查询单个用户     * @param id     * @param request     * @return     */    @RequestMapping("/getUser.do")    public String getUser(int id,HttpServletRequest request){        request.setAttribute("user", userService.findById(id));        return "editUser";    }    /**     *编辑用户     * @param user     * @param request     * @return     */    @RequestMapping("/updateUser.do")    public String updateUser(User user,HttpServletRequest request){        if(userService.update(user)){            user = userService.findById(user.getId());            request.setAttribute("user", user);            return "redirect:/user/getAllUser.do";        }else{            return "error";        }    }   }

如果需要整个项目的源代码,可以联系我,QQ:596703245

经验问题总结

  • 项目的框架搭建很关键,要注意每个配置文件的具体位置,一旦配置文件的具体位置与配置信息不匹配,项目根本无法运行,或者各种错误。
    建议:除了web.xml放在webContent下的WEB-INF下面,其他配置文件统一放在javaResources->config下面。所有的mapper.xml统一放在javaResource->config->mapper下面。这样以来,除了web.xml文件以外,程序编译和发布后,其他配置文件都在classes文件夹下面。

  • 一定要区分开全局配置文件(这里是applicationContext.xml)和DispatcherServelt的配置文件。mybatis的配置信息以及数据库链接信息等都是在applicationContext.xml中配置的。DispatcherServelt中配置的只是与请求访问相关的信息。

项目源代码下载

0 0