SSM框架——詳細整合教程（Spring+SpringMVC+MyBatisPlus+Maven）

記錄SSM 框架整合、使用Maven構建，說M實際上是MybatisPlus、是一種對Mybatis封裝好的框架、在不影響Mybatis原生的情況下，進行的一種擴展。

框架支持Freemarker 和 JSP 雙View展示（優先找Freemarker）。

項目環境：
JDK : 1.7
SpringMVC : 4.2.5
Spring : 4.2.5
Mybatis Plus : 2.0.5
IntelliJ IDEA : 2016.2.5
LomBok : 1.16.8
Veolcity : 1.7 只用來mybatis反向生成代碼
freemarker : 2.3.23

LomBok 是一種能自動生成Get & Set 等方法、大大減少開發時代碼量、保持代碼簡潔。
查看LomBok 操作：https://projectlombok.org/

Github 項目地址：https://github.com/Jandaes/liujilu-ssm

• Mybatis Plus 自動會引入Mybatis 的jar
• 使用Maven Tomcat Plugin部署運行 (Intellij IDEA 中如何部署項目到 Tomcat？)
• 可通過Eclipse 或MyEclipse部署運行、不僅限於IDEA

pom.xml :

    <build>
        <finalName>liujilu</finalName>
        <plugins>
            <!--添加Tomcat7 maven 插件-->
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
                <configuration>
                    <uriEncoding>UTF-8</uriEncoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
    <!--配置全局版本屬性-->
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <spring.version>4.2.5.RELEASE</spring.version>
        <junit.version>4.12</junit.version>
        <druid.version>1.0.18</druid.version>
        <fastjson.version>1.2.8</fastjson.version>
        <mybaitsplus.version>2.0.5</mybaitsplus.version>
        <mysql.version>5.1.38</mysql.version>
        <log4j.version>1.2.17</log4j.version>
        <slf4j.version>1.7.19</slf4j.version>
        <aspectjweaver.version>1.8.8</aspectjweaver.version>
        <shiro.version>1.3.1</shiro.version>
    </properties>
    
    <!-- Spring MVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
        <type>jar</type>
        <scope>compile</scope>
    </dependency>
    
    <!--參考項目源碼-->
    <!--......-->

web.xml

    <!-- SpringMVC 過濾 -->
    <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>classpath:spring/spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>spring-mvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    
    <!-- 加載Spring配置 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring/spring.xml,classpath:spring/spring-*.xml</param-value>
    </context-param>
    <!-- 啓動監聽器 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!--監聽器出用於主要爲了解決java.beans.Introspector導致內存泄漏的問題-->
    <listener>
        <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
    </listener>

從項目根目錄/開始攔截所有的請求、全部交給Springmvc管理，包括靜態資源（css,js,image），如果項目有引入靜態資源也被攔截的話、需要在springmvc.xml加入：
<mvc:resources location="/image/" mapping="/image/**"/> <mvc:resources location="/css/" mapping="/css/**"/> <mvc:resources location="/js/" mapping="/js/**"/>

classpath:spring/spring-*.xml : 加載所有spring目錄下spring- 開頭的xml文件

Spring.xml

    <!-- 自動掃描 -->
    <context:component-scan base-package="com.liujilu.service.*"/>
    <!-- 開啓註解 -->
    <context:annotation-config/>

    <!-- 引入配置文件 -->
    <bean id="propertyConfigurer"  class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <property name="location" value="classpath:jdbc.properties" />
    </bean>

SpringMVC.xml

    <!-- 自動掃描該包，使SpringMVC認爲包下用了@controller註解的類是控制器,不掃描Service，使用Spring中的Service -->
    <context:component-scan base-package="com.liujilu.controller">
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Service"/>
    </context:component-scan>
    <!-- 處理器映射器 -->
    <mvc:annotation-driven />
    <!-- 引入靜態資源 -->
    <mvc:default-servlet-handler/>
    <!-- 視圖解析器（ViewResolver）配置 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 前綴 -->
        <property name="prefix" value="/WEB-INF/pages/"/>
        <!-- 後綴 -->
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 視圖解析器（ViewResolver）配置 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 前綴 -->
        <property name="prefix" value="/WEB-INF/pages/"/>
        <!-- 後綴 -->
        <property name="suffix" value=".jsp"/>
    </bean>
    <!-- 添加Freemarker解析器 -->
    <!-- Freemarker配置 -->
    <bean id="freemarkerConfig"
          class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
        <property name="templateLoaderPath" value="/WEB-INF/views/" />
        <property name="defaultEncoding" value="utf-8" />
        <property name="freemarkerSettings">
            <props>
                <prop key="template_update_delay">10</prop>
                <prop key="locale">zh_CN</prop>
                <prop key="datetime_format">yyyy-MM-dd</prop>
                <prop key="date_format">yyyy-MM-dd</prop>
                <prop key="number_format">#.##</prop>
            </props>
        </property>
    </bean>
    <!-- 視圖解析器（ViewResolver）配置 -->
    <!--視圖解釋器 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"></property>
        <property name="suffix" value=".ftl" />
        <property name="contentType" value="text/html;charset=utf-8" />
        <property name="exposeRequestAttributes" value="true" />
        <property name="exposeSessionAttributes" value="true" />
        <property name="exposeSpringMacroHelpers" value="true" />
        <property name="requestContextAttribute" value="request" />
        <property name="order" value="1" />
    </bean>

/WEB-INF/pages/ : SpringMVC 的返回頁面、只返回.jsp結尾的文件
/WEB-INF/views/:Freemarker 的模版頁面、只返回.ftl結尾的文件

Freemarker文件後綴可自己編寫、比如：*.html

spring-mybatis.xml

    <!--數據源配置查看項目源碼-->
    <!-- Spring整合Mybatis，更多查看文檔：http://mp.baomidou.com -->
    <bean id="sqlSessionFactory" class="com.baomidou.mybatisplus.spring.MybatisSqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <!-- 自動掃描Mapping.xml文件 -->
        <property name="mapperLocations" value="classpath:mybatis/xml/*.xml"/>
        
        <!-- 配置 Mybatis 配置文件（可無） 
        <property name="configLocation" value="classpath:mybatis/mybatis-config.xml"/>
         -->
         <!-- 配置包別名 -->
        <property name="typeAliasesPackage" value="com.liujilu.model"/>
        <property name="plugins">
            <array>
                <!-- 分頁插件配置 -->
                <bean id="paginationInterceptor" class="com.baomidou.mybatisplus.plugins.PaginationInterceptor">
                    <property name="dialectType" value="mysql"/>
                </bean>
            </array>
        </property>
        <!-- 全局配置注入 -->
        <property name="globalConfig" ref="globalConfig" />
    </bean>
    
    <!-- 定義 MP 全局策略 -->
    <bean id="globalConfig" class="com.baomidou.mybatisplus.entity.GlobalConfiguration">
        <!-- 
            AUTO->`0`("數據庫ID自增")
            INPUT->`1`(用戶輸入ID")
            ID_WORKER->`2`("全局唯一ID")
            UUID->`3`("全局唯一ID")
        -->
        <property name="idType" value="2" />
        <!--
            MYSQL->`mysql`
            ORACLE->`oracle`
            DB2->`db2`
            H2->`h2`
            HSQL->`hsql`
            SQLITE->`sqlite`
            POSTGRE->`postgresql`
            SQLSERVER2005->`sqlserver2005`
            SQLSERVER->`sqlserver`
        -->
        <property name="dbType" value="mysql"/>
        
        <!-- Oracle需要添加該項 -->
        <!-- <property name="dbType" value="oracle" /> -->
        
        <!-- 全局表爲下劃線命名設置 true -->
        <property name="dbColumnUnderline" value="true" />
    </bean>

整合Mybatis plus 配置

SysUser.java

/**
 * <p>
 *      用戶信息表
 * </p>
 *
 * @since 2017-07-31
 */
@TableName("sys_user")
@Data
@AllArgsConstructor
@NoArgsConstructor
public class SysUser extends Model<SysUser> {

    private static final long serialVersionUID = 1L;

    /**
     * 編號
     */
    @TableId(value="id", type= IdType.ID_WORKER)
    private String id;
    /**
     * 姓名
     */
    private String name;
    /**
     * 暱稱
     */
    private String nickname;
    /**
     * 郵箱
     */
    private String email;
    /**
     * Q號碼
     */
    private String number;
    /**
     * 密碼
     */
    private String password;
    /**
     * 創建時間
     */
    @TableField("create_time")
    private Date createTime;
    /**
     * 最後登錄時間
     */
    @TableField("last_login_time")
    private Date lastLoginTime;
    /**
     * 狀態：0 鎖定、 1 正常
     */
    private Integer status;
    @Override
    protected Serializable pkVal() {
        return this.id;
    }

}

@Data : 會自動生成Set & Get方法
@AllArgsConstructor : 會自動生成構造方法
@NoArgsConstructor : 會自動生成無參構造方法
@TableId(type= IdType.ID_WORKER):主鍵生成策略、查看spring-mybatis.xml

PS : 如果有構造方法的話、必須要寫無參構造方法

SysUserController.java

@Controller
@RequestMapping("/")
public class SysUserController {
    private Logger logger = Logger.getLogger(SysUserController.class);

    @Autowired
    private SysUserService userService;

    /**
     * 返回到JSP
     * @return
     */
    @RequestMapping("index")
    public ModelAndView index(){
        ModelAndView mv = new ModelAndView("index");
        logger.info("進來了");
        List<SysUser> userList = userService.selectList(new EntityWrapper<SysUser>());
        for (SysUser user:userList) {
            System.out.println(user.toString());
        }
        mv.addObject("userList",userList);
        return mv;
    }

    /**
     * 返回到FreeMarker
     * @param model
     * @return
     */
    @RequestMapping("/freemarker/index")
    public String index(Model model){
        logger.info("進來了Freemarker 處理器");
        List<SysUser> userList = userService.selectList(new EntityWrapper<SysUser>());
        for (SysUser user:userList) {
            System.out.println(user.toString());
        }
        model.addAttribute("userList",userList);
        return "indexs";
    }
}

MpGenerator.java

/**
 * <p>
 *  代碼生成器請勿輕易操作
 *  操作時請取消 pom.xml 中的 velocity 註釋
 * </p>
 */
public class MpGenerator {

    /**
     * @param args
     */
    public static void main(String[] args) {
        AutoGenerator mpg = new AutoGenerator();
        // 全局配置
        GlobalConfig gc = new GlobalConfig();
        gc.setOutputDir("D://cache");//生成存放地址
        gc.setFileOverride(true);
        gc.setActiveRecord(true);
        gc.setEnableCache(false);// XML 二級緩存
        gc.setBaseResultMap(true);// XML ResultMap
        gc.setBaseColumnList(false);// XML columList
        gc.setAuthor("D.Yang");
        
        // 自定義文件命名，注意 %s 會自動填充表實體屬性！
        gc.setMapperName("%sMapper");
        gc.setXmlName("%sMapper");
        gc.setServiceName("%sService");
        gc.setServiceImplName("%sServiceImpl");
        gc.setControllerName("%sController");
        mpg.setGlobalConfig(gc);
        
        // 數據源配置
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setDbType(DbType.MYSQL);
        dsc.setTypeConvert(new MySqlTypeConvert(){
            // 自定義數據庫表字段類型轉換【可選】
            @Override
            public DbColumnType processTypeConvert(String fieldType) {
                System.out.println("轉換類型：" + fieldType);
                return super.processTypeConvert(fieldType);
            }
        });
        
        
        dsc.setDriverName("com.mysql.jdbc.Driver");
        dsc.setUsername("root");
        dsc.setPassword("");
        dsc.setUrl("jdbc:mysql://127.0.0.1:3306/liujilu?characterEncoding=utf8");
        mpg.setDataSource(dsc);
        
        // 策略配置
        StrategyConfig strategy = new StrategyConfig();
        strategy.setTablePrefix(new String[] {""});// 此處可以修改爲您的表前綴
        strategy.setNaming(NamingStrategy.underline_to_camel);// 表名生成策略
        //strategy.setInclude(new String[]{"sys_order"});//生成指定表
        mpg.setStrategy(strategy);
        
        // 包配置
        PackageConfig pc = new PackageConfig();
        pc.setParent("com");
        pc.setModuleName("liujilu");
        pc.setEntity("model");
        mpg.setPackageInfo(pc);
        // 執行生成
        mpg.execute();
    }

}

該工具類、自動通過連接數據庫生成對應的java文件、包括：
Controller、model、Service、ServiceImpl、Mappler、Mapperxml
只要修改配置裏面的數據庫連接地址、以及修改生成代碼的存放地址就可以使用。

具體更多的MybatisPlus方法操作、查看：http://git.oschina.net/baomidou/mybatis-plus

以上代碼爲主要代碼、更多代碼查看Github 源碼

參考網站：http://liujilu.com/