2017-08-17 SSM 环境搭建

2017-08-17 SSM 环境搭建

前言

SSM（Spring、Spring MVC 和 Mybatis）的环境搭建，在网上看过不少教程，有些明明将代码一行行复制下来，却出错了。终究觉得需要自己码一篇来当作笔记以及教程。

概念性的东西并不是这里的重点，这个需要自己去查阅相关的知识点，建议先去了解 Spring、Spring MVC 和 Mybatis 的基础知识再来跟着操作。

本教程的项目可以在此链接中下载 点击我

默认环境

eclipse 4.6

JDK 1.8

1. 导入相关 Jar 包

• Spring 4.3.9

• MyBatis 3.4.4

• commons-logging-1.2.jar

• mybatis-spring-1.3.1.jar

• mysql-connector-java-5.1.43-bin.jar

• 其它的需要的时候再导入即可

2. 配置 web.xml 文件

在 WEB-INF 下创建一个 web.xml，按以下进行配置

主要配置的是 spring 的核心监听器 以及 Spring MVC 的前端控制器

Spring MVC 前端控制器配置默认会在 WEB-INF 文件夹查找：[servlet-name]-servlet.xml 文件

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                             http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         id="WebApp_ID" version="3.1">

    <display-name>test_SSM</display-name>
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>

    <!-- 配置 spring 核心监听器，默认会以 /WEB-INF/applicationContext.xml 作为配置文件 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- contextConfigLocation 参数用来指定 Spring 的配置文件 -->
<!--
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
-->
    <!-- 如果将配置文件存放到 src/config 文件夹下，则配置如下 -->
<!-- 
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath*:config/applicationContext.xml</param-value>
    </context-param>
 -->

    <!-- 定义 Spring MVC 前端控制器 -->
    <servlet>
        <servlet-name>spring-mvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring-mvc-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!-- 让 Spring MVC 的前端控制器拦截所有请求 -->
    <servlet-mapping>
        <servlet-name>spring-mvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- 编码过滤器 -->
    <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>
    </filter>
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

3. 配置 applicationContext.xml 文件

在 WEB-INF 文件夹下创建 applicationContext.xml 文件

在之后的文章里，将会将数据源更改为常用的 C3P0 连接池

<?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:tx="http://www.springframework.org/schema/tx"
    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.3.xsd
                        http://www.springframework.org/schema/tx
                        http://www.springframework.org/schema/tx/spring-tx-4.3.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/test?characterEncoding=UTF-8</value>
        </property>
        <property name="username">
            <value>root</value>
        </property>
        <property name="password">
            <value>123456</value>
        </property>
    </bean>

    <!-- 配置 SqlSessionFactory -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!--dataSource 属性指定要用到的连接池 -->
        <property name="dataSource" ref="dataSource" />
        <!-- configLocation 属性指定 mybatis 的核心配置文件 -->
        <property name="typeAliasesPackage" value="com.demo.bean" />
        <!-- 所有配置的 mapper 文件 -->
        <property name="mapperLocations" value="classpath*:/com/demo/mapper/*.xml" />
    </bean>

    <!-- JDBC事务管理器 -->
    <bean id="transactionManage-r"
        class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource" />
    </bean>

    <!-- 启用支持 annotation 注解方式事务管理 -->
    <tx:annotation-driven transaction-manager="transactionManager"/>

    <!-- MapperScannerConfigurer 自动扫描，将 Mapper 接口生成代理注入到 Spring -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.demo.mapper" />
    </bean>
</beans>

4. 配置 Spring MVC 前端控制器配置文件

在 WEB-INF 文件夹中创建 [servlet-name]-servlet.xml 文件，这里为 spring-mvc-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: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"
    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.3.xsd
                        http://www.springframework.org/schema/tx
                        http://www.springframework.org/schema/tx/spring-tx-4.3.xsd
                        http://www.springframework.org/schema/mvc
                        http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd">

    <!-- 自动扫描该包，SpringMVC 会将包下用了注解的类注册为 Spring 的 bean -->
    <context:component-scan base-package="com.demo.*" />

    <!-- 设置默认配置方案 -->
    <mvc:annotation-driven />

    <!-- 使用默认的 Servlet 来响应静态文件 -->
    <mvc:default-servlet-handler />

    <!-- 视图解析器  -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 前缀 -->
        <property name="prefix">
            <value>/WEB-INF/pages/</value>
        </property>
        <!-- 后缀 -->
        <property name="suffix">
            <value>.jsp</value>
        </property>
    </bean>
</beans>

创建对应的包与文件夹

在 src 下创建以下包名（根据自己的情况对包名进行修改，修改后记得改 SSM 配置文件）

* com.demo.bean
* com.demo.mapper
* com.demo.dao
* com.demo.service
* com.demo.controller

在 WEB-INF 文件夹中创建 pages 文件夹，将 jsp 文件存放在此处。关于为何将 jsp 文件存放在 WEB-INF 下可以查看这篇文章了解一下http://blog.csdn.net/saygoodbyetoyou/article/details/9944773

后言

SSM 的环境就先到这里，下一篇以登录功能来示范一下 SSM 的使用

本文基于个人的学习
分享出来纯当给大家参考一下，也当作自己的笔记

编辑：HochenChong
时间：2017-08-17