IDEA 整合SSM入门

IDEA整合SSM，有很多坑，这里记录一下，新建项目首先采用的普通Java Enterprise项目，后面使用Maven项目。

创建SSM项目前期搭建

（1）先创建一个Java Enterprise项目，一般是选择Spring来创建，并且会自动导包，这里使用另外一种方式来实现。

（2）创建完成后需要设置，进入Project Structure界面，跟其他IDE可以直接使用不同，IDEA的还需要设置source目录和resource目录，代表代码和资源文件存放的地方。如图所示在src目录下建立main目录，main目录下建立java和resource目录，分别存放量产代码和配置文件，test文件夹也可以设置，这里省略了。上面Mark as标签可以看出来，可以分别设置量产代码文件夹（Sources）、测试代码文件夹（Tests），量产资源文件夹（Resources）、测试资源文件夹（Test Resources）和排它文件夹（不被使用）。

（3）设置Tomcat部署路径，这里选择部署在Tomcat的Webapp下。

（4）设置Tomcat服务器，选择菜单Edit Configurations进入设置界面，可以将After lauch勾选掉，另外更新和鼠标离焦选项选择Update classes and resources，这样就支持热部署，即无需重启tomcat也可以支持更新。

另外切换到Deployment，将Application Context修改，这样访问资源是通过如下web虚拟路径名可以访问到部署到tomcat后的真正资源。

以上就完成前期的基本配置，后面需要配置SpringMVC、Spring和MyBatis的核心配置文件了。

SSM项目核心文件配置

SpringMVC配置

（1）web.xml中配置启动前端控制器，需要读取SpringMVC核心配置文件。注意spring-mvc.xml是放在前面的resource文件夹下。

<!--配置SpringMVC前端控制器-->
    <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>
        <!--设置启动tomcat就启动-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>*.action</url-pattern>
    </servlet-mapping>
    
    <!--配置全站式乱码解决，只针对post有效-->
    <filter>
        <filter-name>filtercoding</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>filtercoding</filter-name>
        <url-pattern>*.action</url-pattern>
    </filter-mapping>

（2）配置SpringMVC核心配置文件，这里需要配置前端控制器、需要配置包扫描、mvc注解驱动和视图解析器，通过采坑后发现，后面配置Spring也需要扫描包，如果都配置可能会导致事务失效，这里因为没有配置事务因此将不需要事务的包在这里扫描。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:util="http://www.springframework.org/schema/util"
       xmlns:aop="http://www.springframework.org/schema/aop"
       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-4.3.xsd
               http://www.springframework.org/schema/context
               http://www.springframework.org/schema/context/spring-context-4.3.xsd
               http://www.springframework.org/schema/util
               http://www.springframework.org/schema/util/spring-util-4.3.xsd
               http://www.springframework.org/schema/aop
               http://www.springframework.org/schema/aop/spring-aop-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"
     >

     <!--开启包扫描-->
     <context:component-scan base-package="com.boe.dao"></context:component-scan>
     <!--注释掉，sevice层上的事务才能生效，将service层的扫描放到spring配置文件中扫描，赋予事务-->
     <!--<context:component-scan base-package="com.boe.service"></context:component-scan>-->
     <context:component-scan base-package="com.boe.web"></context:component-scan>
     <!--开启mvc注解-->
     <mvc:annotation-driven></mvc:annotation-driven>
     <!--配置视图解析器-->
     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
          <property name="suffix" value=".jsp"></property>
          <property name="prefix" value="/WEB-INF/jsp/"></property>
     </bean>

</beans>

Spring配置

（1）web.xml中配置，使用listener来读取applicationContext.xml配置文件，启动Spring容器。

    <!--配置监听器，spring在web初始化时自动加载-->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

（2）spring核心配置文件中，需要配置包扫描、DI注入、事务等。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:util="http://www.springframework.org/schema/util"
       xmlns:aop="http://www.springframework.org/schema/aop"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xmlns:mvc="http://www.springframework.org/schema/cache"
       xsi:schemaLocation=
               "http://www.springframework.org/schema/beans
               http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
               http://www.springframework.org/schema/context
               http://www.springframework.org/schema/context/spring-context-4.3.xsd
               http://www.springframework.org/schema/util
               http://www.springframework.org/schema/util/spring-util-4.3.xsd
               http://www.springframework.org/schema/aop
               http://www.springframework.org/schema/aop/spring-aop-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"
>

    <!-- 开启包扫描 -->
    <!--<context:component-scan base-package="com.boe.web"/>-->
    <context:component-scan base-package="com.boe.service"/>
    <!--<context:component-scan base-package="com.boe.dao"/>-->
    <!--DI依赖注入-->
    <context:annotation-config></context:annotation-config>
    <!--引入外部数据库连接配置文件 -->
    <context:property-placeholder location="classpath:connConf/db.properties"/>
    <!--配置数据源 -->
    <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="driverClass" value="${driverClass}"/>
        <property name="jdbcUrl" value="${jdbcUrl}"/>
        <property name="user" value="${user}"/>
        <property name="password" value="${password}"/>
    </bean>

    <!--配置事务管理器-->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"></property>
    </bean>
    <!--开启事务注解-->
    <tx:annotation-driven></tx:annotation-driven>

</beans>

Mybatis配置

（1）mybatis的配置需要准备核心配置文件sqlMapConfig和mapper映射文件（这里准备了一个UserMapper.xml）。

sqlMapConfig.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>

    <!--配置mapper映射文件-->
    <!--<mappers>
        <mapper resource="UserMapper.xml"></mapper>
    </mappers>-->

</configuration>

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

<mapper namespace="com.boe.dao.UserMapper">

    <!--查询user-->
    <select id="findAll" resultType="com.boe.domain.User">
        SELECT * FROM user;
    </select>


    <!--插入一个user-->
    <insert id="addUser" parameterType="com.boe.domain.User">
        INSERT INTO user
        <trim prefix="(" suffix=")" suffixOverrides=",">
            id,
            <if test="name!=null">name,</if>
            <if test="age!=0">age,</if>
        </trim>
        VALUES
        <trim prefix="(" suffix=")" suffixOverrides=",">
            null,
            <if test="name!=null">#{name},</if>
            <if test="age!=0">#{age},</if>
        </trim>
    </insert>

</mapper>

（2）在spring核心配置文件中添加跟Mybatis相关的配置，完成整合。需要配置Sqlsessionfactorybean，里面配置了数据源、mybatis核心配置文件和mapper映射文件（原来在mybatis核心配置文件中完成数据源和mapper映射文件的配置），最后配置MapperScannerConfigurer，实现对mapper映射器（接口）的扫描（原本需要使用SqlSession的getMapper方法获得）。

<!--整合mybatis，配置sqlsession-->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!--引入数据源-->
        <property name="dataSource" ref="dataSource"></property>
        <!--引入mybatis核心配置文件-->
        <property name="configLocation" value="classpath:sqlMapConfig.xml"></property>
        <!--引入映射文件-->
        <property name="mapperLocations" value="classpath:Mapper/UserMapper.xml"></property>
    </bean>

    <!--配置包mapper扫描，里面放置接口-->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.boe.dao"></property>
    </bean>

以上就完成了SSM核心文件的配置，跟数据库连接相关的属性文件这里略去不展示，最后配置完成后的项目结构如下图。

启动SSM测试

配置完成后还没有完成，需要启动tomcat服务器查看是否正常启动，这里就可能开始踩坑了。

（1）java.lang.ClassNotFoundException:org.springframework.web.context.ContextLoaderListener

启动后发现部署提示OK，但是继续查看Tomcat Localhost Log发现执行报错，提示说找不到这个类，但是实际上配置web.xml中是可以找到这个类，所以说明包是有的（spring-web相关jar包），后面查看发现部署到tomcat后没有lib目录，因此报错。

解决办法最简单粗暴的方式是重新添加Artifacts，先将当前的删除。

然后重新从Module中添加，发现Output Layout里有lib目录，另外tomcat可能需要重新配置一下Deployment，将刚开新的artifacts重新导入一下，重新启动发现不再报错。

 

（2）无法读取到配置文件信息，如spring-mvc.xml等，这种情况一般就是没有配置sources和resources目录导致，按照上面的方法配置即可，刚开始也采坑多次，才发现IDEA需要配置这个。

最后没问题做测试，可以发送请求正常连接数据库，并返回json数据。

Maven整合

上面就是普通项目的SSM整合，接下来使用maven来整合，其实整体来说和普通整合区别不大，就是jar包不需要手动导入了，通过pom文件来实现，另外可以使用maven的tomcat插件，无需部署。其他springmvc、spring和mybatis的配置文件基本不用改动。

pom文件内容如下，其他均参考上面配置。

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.boe</groupId>
  <artifactId>mavenssm</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>mavenssm Maven Webapp</name>
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    
    <!-- springmvc包 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>4.3.7.RELEASE</version>
    </dependency>    
    
    <!-- spring web包 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>4.3.7.RELEASE</version>
    </dependency>
    
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <!-- 运行期不导入，只作用在编译期防止编译报错 -->
        <scope>provided</scope>
    </dependency>
    
    <!-- 导入spring相关包 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>4.3.7.RELEASE</version>
    </dependency>

    <!--mybatis相关-->
    
    <!-- 引入mysql驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.0.8</version>
    </dependency>
    
    <!-- 引入数据源c3p0 -->
    <dependency>
        <groupId>com.mchange</groupId>
        <artifactId>c3p0</artifactId>
        <version>0.9.5.2</version>
    </dependency>
    
    <!-- 引入springJDBC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>4.3.7.RELEASE</version>
    </dependency>
    
    <!-- mybatis的包 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.4.5</version>
    </dependency>

    <!-- mybatis整合spring的包 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>1.3.1</version>
    </dependency>
    
    <!-- json相关包 -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-core</artifactId>
        <version>2.8.8</version>
    </dependency>
    
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.8.8</version>
    </dependency>
    
    
       
  </dependencies>

  <build>
    <finalName>mavenssm</finalName>
    <pluginManagement>
      <plugins>
        
        <!-- 配置插件，指定jdk版本 -->
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
          <configuration>
              <source>1.8</source>
              <target>1.8</target>
              <encoding>UTF-8</encoding>
          </configuration>         
        </plugin>

          <!-- tomcat插件-->
        <plugin>
            <groupId>org.apache.tomcat.maven</groupId>
            <artifactId>tomcat7-maven-plugin</artifactId>
            <version>2.2</version>
            <configuration>
                <!-- 端口 -->
                <port>8080</port>       
                <!-- contextPath -->
                <path>/</path>
                <!-- receive utf-8 -->
                <uriEncoding>UTF-8</uriEncoding>
            </configuration>
        </plugin>
      
      </plugins>
    </pluginManagement>
  </build>
</project>

启动tomcat可以使用maven的tomcat插件，配置如下，添加一个maven application，Command line写入命令即可，注意不要添加mvn，直接写命令参数。

启动后访问页面，发现能正常访问。

控制台可以正常获取db数据。

 

参考博文：

（1）https://www.jianshu.com/p/18d068f47b09