SSM项目整合纪实

一 　前 言

　　本来是为了探究一些功能性问题，需要一套完整的项目架构，本以为SSM用过那么多了，轻松搭建不在话下，但是过程中还是遇到一些问题，踩到一些未曾料想的坑。博文以搭建极简架构为目的，附带一些关键阐述，既是备忘，也是分享。

二 　Maven奠基

　　IDEA中用 Maven 的方式搭建 web 项目的时候如果你选择了 web 项目骨架，那么最终生成的项目目录结构是很不标准的一个目录结构，而如果不选择 web 项目骨架，产生的项目目录标准但却少了 web 目录。当然，基于IDEA的强大，肯定不至于让你手动去整理包结构，请按以下简单步骤操作即可：

　　没有选择骨架的Maven项目结构如下——

　　然后项目右键 Add Frameworks Support 添加 web 支持——

三 　Java 配置集成 Spring+Spring MVC

　　通常的做法是需要在 web.xml 中配置 Spring 初始化上下文的监听器 ContextLoaderListener 和 Spring MVC的核心 DispatcherServlet，它们会加载各自路径中的xml配置文件来产生各自的上下文对象。不过博主并不想这么做，而是采用纯 Java 配置的方式，所以本项目示例中没有 web.xml的存在。通过Java配置的方式，我们需要两个配置类，一个配置类扩展 WebApplicationInitializer 接口的派生类 AbstractAnnotationConfigDispatcherServletInitializer ，其会同时创建 ContextLoaderListener 和 DispatcherServlet 的上下文，并根据需要配置 DispatcherServlet 的映射路径和相关配置类：

public class BluesInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    //给定的Java 配置类将定义 ContextLoaderListener 上下文中的 bean 实例 本示例中没有给出根配置类
    protected Class[] getRootConfigClasses() {
        return new Class[0];
    }

    // 给定的Java 配置类将定义 DispatcherServlet 上下文的bean 实例
    protected Class[] getServletConfigClasses() {
        return new Class[]{WebConfig.class}; 
    }

    // 配置一个或多个 映射路径
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

　　另一个就是MVC的基础配置类——

@Configuration
@ComponentScan(basePackages = {"net"})
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {

    //配置视图解析器
    @Bean
    public ViewResolver viewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/pages/");
        resolver.setSuffix(".jsp");
        return resolver;
    }

    /**
     * 通过继承 WebMvcConfigurerAdapter 类的方式配置静态资源请求
     * 将对静态资源的访问交由容器中默认的 Servlet 处理
     */
    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        /** 相当于 xml 配置中的  配置 */
        configurer.enable();
    }
}

　　完成两个配置类后其实Spring和Spring MVC就已经配置完了，你可以编写控制器做页面跳转测试，这里限于篇幅博主不再贴出。想要知道为什么能用以上的Java配置取代经常用的 web.xml中的配置 ，首先你必须得清楚 web.xml 中的 ContextLoaderListener 和 DispatcherServlet 的作用。关于这两者的深层理解，可参考一位博友的源码分析，这里博主还是按照己的理解来叙述：　　　　　　         

　　ContextLoaderListener 是Spring的一个监听器，当其监听到容器启动会根据定义文件（可以理解为创建 bean 实例及维护bean依赖关系的图纸，默认是WEB-INF下的applicationContext.xml文件）创建Spring的上行下对象，也即容器对象，有了该容器对象程序运行时才能从容器中获取到bean; DispatcherServlet 本质就是一个Servlet ，所以，Servlet容器启动时自然会将其初始化（配置为正数），关键这家伙是 Spring 的，功能很强大，也能够根据自己的 xml定义文件（默认 WEB-INF下的【servlet-name】-servlet.xml）产生一个上下文对象，这个上下文容器对象负责管理维护Spring MVC生态体系中的 控制器啊，视图解析器，处理映射器等bean;这两个容器对象有关系吗，当然有关系，可以粗浅的理解为父子关系，前者是整个应用的根容器对象，是全局的，后者只是管理应用于Servlet相关组件。

　   而为什么扩展了AbstractAnnotationConfigDispatcherServletInitializer 类就能完成上述相同的功能呢？因为在Servlet 3.0 规范中，为第三方组件提供了一个叫 ServletContainerInitializer 的接口用来做一些初始化相关的工作，第三方组件只要实现此接口就可以完成自己的一些初始化操作。在Spring中提供的实现类叫 SpringServletContainerInitializer ，追踪源码，你可以发现，真正的初始化配置其实是交给 WebApplicationInitializer 接口的子类来完成的，而上面代码中的 AbstractAnnotationConfigDispatcherServletInitializer 就是WebApplicationInitializer 接口的子类，所以，我们可以继承该类，根据业务需求重写相应的方法，来完成我们初始化Spring 和Spring MVC 上下文的相关配置。至此，我想你应该能看懂上面的配置是什么意思以及和web.xml中的配置的对应关系了。

四 　整合Mybatis

　　持久层的整合无需多说，在资源文件夹下新建 spring-mybatis.xml 和 db.properties文件，依次配置连接数据库的数据源(应该从 db.properties中获取数据库连接信息 )、生成SqlSession 的 SqlSessionFactory定义（其依赖于数据源和mapper.xml文件路径）以及映射器配置类 MapperScannerConfigurer。db.propertie和spring-mybatis.xml 配置文件如下：

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/sql_eve?useUnicode=true&characterEncoding=utf-8
jdbc.username=root
jdbc.password=123456

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

    
    <context:property-placeholder location="classpath:db.properties"/>

    
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
        <property name="driverClassName" value="${jdbc.driver}" />
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
        
        <property name="initialSize" value="1" />
        
        <property name="minIdle" value="1" />
        
        <property name="maxActive" value="5" />
        
        <property name="maxWait" value="10000" />
    bean>

    
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="mapperLocations" value="classpath:mapper/*.xml"/>
    bean>
    
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="net.dao"/>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    bean>
beans>

 

　　现在这个配置文件Spring容器是不知道的，需要在上面的Java配置类WebConfig上标注 @ImportResource("classpath:spring-mybatis.xml") 进行引入。然后，来一个mapper.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="net.dao.ProductDao">
    <select id="queryProducts" resultType="net.entity.Product">
            select * from products
    select>
mapper>

五 　避坑指南

　　① IDEA编译问题

　　有时候我们可能会将mapper.xml文件写在dao下面的mapper包里，但是在IDEA的Maven项目中，编译器只会对java包下面.java文件进行编译处理，而忽略掉其中的资源文件，在运行时就会找不到相应的配置文件。所以资源文件最好直接放在resources目录中，如果确实需要放在java目录中，需在pom.xml中配置（配置链接）。

　　② 缺少 jdbc 支持异常

　　③ 返回参数类型错误

 

 附 pom.xml 依赖：

 

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.0modelVersion>
    <groupId>com.buyigroupId>
    <artifactId>bluesartifactId>
    <version>1.0-SNAPSHOTversion>

    <properties>
        <spring.version>4.3.7.RELEASEspring.version>
    properties>

    <dependencies>
        
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-webmvcartifactId>
            <version>${spring.version}version>
        dependency>

        
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-jdbcartifactId>
            <version>${spring.version}version>
        dependency>

 
        
        <dependency>
            <groupId>com.fasterxml.jackson.coregroupId>
            <artifactId>jackson-coreartifactId>
            <version>2.5.4version>
        dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.coregroupId>
            <artifactId>jackson-databindartifactId>
            <version>2.5.4version>
        dependency>


        
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatisartifactId>
            <version>3.4.2version>
        dependency>
        
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatis-springartifactId>
            <version>1.3.1version>
        dependency>

        
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>5.1.25version>
            <scope>runtimescope>
        dependency>
        
        <dependency>
            <groupId>com.alibabagroupId>
            <artifactId>druidartifactId>
            <version>1.0.12version>
        dependency>

        
        <dependency>
            <groupId>junitgroupId>
            <artifactId>junitartifactId>
            <version>4.12version>
            <scope>testscope>
        dependency>
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-testartifactId>
            <version>${spring.version}version>
        dependency>

        
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-websocketartifactId>
            <version>${spring.version}version>
        dependency>
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-messagingartifactId>
            <version>${spring.version}version>
        dependency>
    dependencies>
project>