Spring+SpringMVC+Mybatis环境的搭建（使用Intellij IDEA）

前言：本文主要介绍利用IDEA如何搭建SSM环境，并使用mybatis的逆向生成功能，根据数据表生成对应mapper接口和sql映射文件。具体步骤如下。

开发环境：

　　　　IDEA 14.1.7

　　　　maven 3.5.2

---

1.搭建web环境

利用idea搭建web环境的具体步骤，请参考笔者的另一篇博文：使用IntelliJ IDEA和Maven管理搭建Web开发环境（以Spring MVC为例）（一）文中有详细介绍。

2.通过maven添加相关依赖包

搭建ssm环境，需要spring、mybatis、数据库驱动等相关依赖包。具体如下pom文件。

    <!--相关文件版本-->
     <properties>
         <spring.version>4.2.1.RELEASE</spring.version>
         <aspectj.version>1.8.1</aspectj.version>
         <servlet.version>2.5</servlet.version>
         <jstl.version>1.2</jstl.version>
         <mybatis.version>3.4.5</mybatis.version>
         <mybatis-spring.version>1.3.1</mybatis-spring.version>
         <junit.version>4.12</junit.version>
         <mysql-driver.version>5.1.20</mysql-driver.version>
         <log4j.version>1.2.17</log4j.version>
         <slf4j.version>1.7.25</slf4j.version>
         <c3p0.version>0.9.0.2</c3p0.version>
         <mchange.version>0.2.14</mchange.version>
         <mbg.version>1.3.6</mbg.version>
     </properties>

     <!--相关依赖-->
     <dependencies>
         <!--spring相关jar包-->
         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-core</artifactId>
             <version>${spring.version}</version>
         </dependency>
         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-context-support</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-jdbc</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-tx</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-web</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-webmvc</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.aspectj</groupId>
             <artifactId>aspectjweaver</artifactId>
             <version>${aspectj.version}</version>
         </dependency>

         <!--mybatis依赖包-->
         <dependency>
             <groupId>org.mybatis</groupId>
             <artifactId>mybatis</artifactId>
             <version>${mybatis.version}</version>
         </dependency>
         <!--mybatis整合spring依赖包-->
         <dependency>
             <groupId>org.mybatis</groupId>
             <artifactId>mybatis-spring</artifactId>
             <version>${mybatis-spring.version}</version>
         </dependency>
         <!--数据源依赖-->
         <dependency>
             <groupId>c3p0</groupId>
             <artifactId>c3p0</artifactId>
             <version>${c3p0.version}</version>
         </dependency>

         <dependency>
             <groupId>com.mchange</groupId>
             <artifactId>mchange-commons-java</artifactId>
             <version>${mchange.version}</version>
         </dependency>
         <!--mysql驱动依赖-->
         <dependency>
             <groupId>mysql</groupId>
             <artifactId>mysql-connector-java</artifactId>
             <version>${mysql-driver.version}</version>
         </dependency>

         <!-- servlet相关依赖-->
         <dependency>
             <groupId>javax.servlet</groupId>
             <artifactId>servlet-api</artifactId>
             <version>${servlet.version}</version>
         </dependency>

         <dependency>
             <groupId>javax.servlet</groupId>
             <artifactId>jstl</artifactId>
             <version>${jstl.version}</version>
         </dependency>
         <!--日志依赖-->
         <dependency>
             <groupId>log4j</groupId>
             <artifactId>log4j</artifactId>
             <version>${log4j.version}</version>
         </dependency>

         <dependency>
             <groupId>org.slf4j</groupId>
             <artifactId>slf4j-log4j12</artifactId>
             <version>${slf4j.version}</version>
         </dependency>

         <!--junit测试包依赖-->
         <dependency>
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
             <version>${junit.version}</version>
         </dependency>
     </dependencies>
     <build>
         <plugins>
             <plugin>
                 <!--Mybatis-generator插件,用于自动生成Mapper和POJO-->
                 <groupId>org.mybatis.generator</groupId>
                 <artifactId>mybatis-generator-maven-plugin</artifactId>
                 <version>${mbg.version}</version>
                 <configuration>
                     <!--配置文件的位置-->
                     <configurationFile>src/main/resources/mybatis-generator-config.xml</configurationFile>
                     <verbose>true</verbose>
                     <overwrite>true</overwrite>
                 </configuration>
                 <executions>
                     <execution>
                         <id>Generate MyBatis Artifacts</id>
                         <goals>
                             <goal>generate</goal>
                         </goals>
                     </execution>
                 </executions>
                 <dependencies>
                     <dependency>
                         <groupId>org.mybatis.generator</groupId>
                         <artifactId>mybatis-generator-core</artifactId>
                         <version>${mbg.version}</version>
                     </dependency>
                 </dependencies>
             </plugin>
         </plugins>
     </build>

注：该pom文件中，还加入了mybatis generator插件，其具体用法，请参考笔者的另一篇博文：MyBatis Generator的使用文中有详细介绍。

通过上面两步，并创建相关包目录，最终程序目录结构如下。

3.添加数据库配置文件

在databaseconfig目录下，添加dbconfig.properties文件，并添加数据库连接信息。内容如下。

 jdbc.driver=com.mysql.jdbc.Driver
 jdbc.url=jdbc:mysql://127.0.0.1:3306/mybatisstudy?useUnicode=true&characterEncoding=UTF-8
 jdbc.username=root
 #密码为空，不能写""不然会报错，这里直接不写
 jdbc.password=

4.添加mybatis核心配置文件

在mybatis目录下，添加mybatis-config.xml文件，并做如下配置。

 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE configuration
         PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
         "http://mybatis.org/dtd/mybatis-3-config.dtd">
 <configuration>

     <!--为了防止Oracle中插入null值报错，可以将jdbcTypeForNull，设置为NULL,mysql中是支持NULL和OTHER的-->
     <settings>
         <setting name="jdbcTypeForNull" value="NULL"/>
         <!--以下两个属性配置后进行延迟加载-->
         <setting name="lazyLoadingEnabled" value="true"/>
         <setting name="aggressiveLazyLoading" value="false"/>
         <setting name="cacheEnabled" value="true"/><!--开启二级缓存-->
     </settings>

     <!--别名处理器：typeAliases可以为java类型起别名-->
     <typeAliases>
         <!--别名不区分大小写-->
         <!--type:指实体类的全类名；默认别名为类名小写
             alias：新的名称-->
         <!--typeAlias为单独一个实体类起别名 -->
         <!--<typeAlias type="com.mybatisstudy.domain.User"/>-->
         <!--package批量起别名
           为某个包下的所有实体类对象起别名
           name:指定包名，为包下及其子包下的实体类对象都起一个别名，默认类名的小写
          -->
         <!--使用@Alias注解为冲突的类名，重新起一个别名，但是类名重复一般不存在-->
         <package name="com.ssm.domain"/>
     </typeAliases>

 </configuration>

5.添加spring核心配置文件

在spring目录下，添加spring-content.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:aop="http://www.springframework.org/schema/aop"
        xmlns:tx="http://www.springframework.org/schema/tx"
        xmlns:mybatis="http://mybatis.org/schema/mybatis-spring"
        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/tx
        http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
        http://www.springframework.org/schema/aop
        http://www.springframework.org/schema/aop/spring-aop-4.0.xsd
        http://mybatis.org/schema/mybatis-spring
        http://mybatis.org/schema/mybatis-spring.xsd">

     <!--扫描包-->
     <context:component-scan base-package="com.ssm.domain"/>
     <context:component-scan base-package="com.ssm.mapper"/>
     <context:component-scan base-package="com.ssm.service"/>

     <!--配置数据源-->
     <context:property-placeholder location="classpath:databaseconfig/dbconfig.properties"/>
     <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"
            destroy-method="close"
             p:driverClass="${jdbc.driver}"
             p:jdbcUrl="${jdbc.url}"
             p:user="${jdbc.username}"
             p:password="${jdbc.password}"/>

     <!--spring事务管理-->
     <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"
           p:dataSource-ref="dataSource"/>
     <tx:annotation-driven transaction-manager="transactionManager"/>

     <!--整合mybatis
       目的：1.spring来管理所有组件，通过自动注入来进行操作
                2.spring来管理事务
     -->
     <!--通过configLocation指定mybatis配置文件的位置，mybatis全局配置文件
       mapperLocations:通过该属性，指定mapper文件的位置，就可以进行自动注册  mapper.xml文件
       注意这里的写法，是该文件夹下所有的xml文件
      -->
     <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"
           p:dataSource-ref="dataSource"
           p:configLocation="classpath:mybatis/mybatis-config.xml"
           p:mapperLocations="classpath:mapperxml/*.xml"
             />
    <!--扫描所有的mapper文件，可以让其自动注册-->
     <mybatis:scan base-package="com.ssm.mapper"/>
 </beans>

注：在spring核心配置文件中，进行了数据库、事务以及整合mybatis的相关配置。

6.添加springmvc配置文件

在WEB-INF目录下，添加dispatcherServlet-servlet.xml文件，进行springmvc的相关配置。

 <?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.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">

     <mvc:default-servlet-handler/>
     <mvc:annotation-driven/>

     <!--default-servlet-handler的作用-->
     <context:component-scan base-package="com.ssm.web"/>

     <!-- 配置视图解析器-->
     <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"
           p:viewClass="org.springframework.web.servlet.view.JstlView"
           p:prefix="/WEB-INF/jsp/"
           p:suffix=".jsp"/>

 </beans>

注：在springmvc配置文件中，主要进行视图解析器等相关配置。

7.在web.xml文件中进行spring及其相关配置。

在web.xml中需要对spring配置文件的启动，以及springmvc配置文件的相关信息进行配置，具体如下。

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app xmlns="http://java.sun.com/xml/ns/javaee"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
           http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
            version="2.5">

     <!-- spring位置文件信息-->
     <context-param>
         <param-name>contextConfigLocation</param-name>
         <param-value>classpath:spring/spring-content.xml</param-value>
     </context-param>

     <!-- 配置监听器-->
     <listener>
         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
     </listener>

     <!-- 配置servlet-->
     <servlet>
         <servlet-name>dispatcherServlet</servlet-name>
         <servlet-class>
             org.springframework.web.servlet.DispatcherServlet
         </servlet-class>
         <load-on-startup>1</load-on-startup>
     </servlet>

     <servlet-mapping>
         <servlet-name>dispatcherServlet</servlet-name>
         <url-pattern>/</url-pattern> <!--配置为/则对html和restful风格的都可以使用，这种方式更为灵活-->
     </servlet-mapping>

     <!--配置字符过滤器，解决中文乱码问题-->
     <filter>
         <filter-name>CharacterEncoding</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>CharacterEncoding</filter-name>
         <url-pattern>/*</url-pattern>
     </filter-mapping>

 </web-app>

通过以上配置，ssm环境的基本框架已经搭建成功，下面通过MBG进行相关文件的逆向生成，具体操作步骤，请参考：MyBatis Generator的使用。通过MBG生成文件如下：

至此，其前期主要工作已准备就绪，下面进行测试。

主要实现功能：

1）向数据库中添加用户信息。

2）显示所有用户信息。

其具体测试步骤，笔者这里不再进行详述，直接给出该工程的源码，以及数据库的创建脚本，有兴趣的读者可自行进行测试。

注：1）由于该工程基于maven，因此需修改idea的maven配置。

　　2）注意mysql版本与驱动的对应关系，具体可参考：MySQL JDBC驱动版本与MySQL数据库版本对应关系。

　　3）本项目源码下载

---

by Shawn Chen，2018.3.23日，晚。