用Maven整合SSM框架

前述

　　Maven 是专门用于构建和管理Java相关项目的工具，利用 Maven 的主要目的是统一维护 jar 包。关于 Maven 的安装在这篇里面就不说了。

　　SSM（Spring+SpringMVC+MyBatis）框架集由Spring、MyBatis两个开源框架整合而成（SpringMVC是Spring中的部分内容）。常作为数据源较简单的web项目的框架。关于SSM框架的基本思想这里也不赘述了，主要是记录 Maven 整合 SSM 的过程。

　　借用之前学习的课本上的一段话，讲述 SSM 的整合思路：

　　由于Spring MVC是Spring框架中的一个模块，所以Spring MVC与Spring之间不存在整合的问题，只要引入相应JAR包就可以直接使用。因此SSM框架的整合就只涉及到了Spring与MyBatis的整合，以及Spring MVC与MyBatis的整合。Spring与MyBatis框架的整合时，

通过Spring实例化Bean，然后调用实例对象中的查询方法来执行MyBatis映射文件中的SQL语句的，如果能够正确查询出数据库中的数据，那么就可以认为Spring与MyBatis框架整合成功。加入Spring MVC后，如果可以通过前台页面来执行查询方法，并且查询出的数据能

够在页面中正确显示，那么就可以认为三大框架整合成功。

整体项目结构

创建Maven项目

新建Maven项目，选择Maven Project

默认下一步

选择webapp，下一步

设置GroupID和ArtifactID

项目创建完成

有报错，打开项目属性，找到Java Build Path -> Libraries ->Edit ->Workspace default

问题解决

利用Maven导入jar包

　　前述中我也说了，利用 Maven 的目的就是要统一维护 jar 包，而jar包的维护则是通过一个 pom.xml 文件来实现的，我们可以在目录中看到一个 pom.xml 文件，项目的 jar 包也正是要通过这个文件导入。

 <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/maven-v4_0_0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.cjk</groupId>
   <artifactId>ssm</artifactId>
   <packaging>war</packaging>
   <version>0.0.1-SNAPSHOT</version>
   <name>ssm Maven Webapp</name>
   <url>http://maven.apache.org</url>

   <properties>
       <!-- spring版本号 -->
       <spring.version>4.0.2.RELEASE</spring.version>
       <!-- mybatis版本号 -->
     <mybatis.version>3.2.6</mybatis.version>
     <!-- log4j日志文件管理包版本 -->
     <slf4j.version>1.7.7</slf4j.version>
     <log4j.version>1.2.17</log4j.version>
   </properties>
   <dependencies>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <version>3.8.1</version>
       <scope>test</scope>
     </dependency>
     <!-- 导入java ee jar包（可以去除index.jsp报错） -->
     <dependency>
         <groupId>javax</groupId>
         <artifactId>javaee-api</artifactId>
         <version>7.0</version>
     </dependency>
     <dependency>
         <groupId>junit</groupId>
         <artifactId>junit</artifactId>
         <version>4.11</version>
         <!-- 表示开发的时候引入，发布的时候不会加载此包 -->
         <scope>test</scope>
     </dependency>
     <!-- spring核心包 -->
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-core</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-oxm</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-jdbc</artifactId>
         <version>${spring.version}</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-webmvc</artifactId>
         <version>${spring.version}</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-aop</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-test</artifactId>
         <version>${spring.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>1.2.2</version>
     </dependency>
     <!-- 导入Mysql数据库链接jar包 -->
     <dependency>
         <groupId>mysql</groupId>
         <artifactId>mysql-connector-java</artifactId>
         <version>5.1.30</version>
     </dependency>
     <!-- 导入dbcp的jar包，用来在applicationContext.xml中配置数据库 -->
     <dependency>
         <groupId>commons-dbcp</groupId>
         <artifactId>commons-dbcp</artifactId>
         <version>1.2.2</version>
     </dependency>
     <!-- JSTL标签类 -->
     <dependency>
         <groupId>jstl</groupId>
         <artifactId>jstl</artifactId>
         <version>1.2</version>
     </dependency>
     <!-- 日志文件管理包 -->
     <!-- log start -->
     <dependency>
         <groupId>log4j</groupId>
         <artifactId>log4j</artifactId>
         <version>${log4j.version}</version>
     </dependency>
     <!-- 格式化对象，方便输出日志 -->
     <dependency>
         <groupId>com.alibaba</groupId>
         <artifactId>fastjson</artifactId>
         <version>1.1.41</version>
     </dependency>
     <dependency>
         <groupId>org.slf4j</groupId>
         <artifactId>slf4j-api</artifactId>
         <version>${slf4j.version}</version>
     </dependency>
     <dependency>
         <groupId>org.slf4j</groupId>
         <artifactId>slf4j-log4j12</artifactId>
         <version>${slf4j.version}</version>
     </dependency>
     <!-- log end -->
     <!-- 映入JSON -->
     <dependency>
         <groupId>org.codehaus.jackson</groupId>
         <artifactId>jackson-mapper-asl</artifactId>
         <version>1.9.13</version>
     </dependency>
     <!-- 上传组件包 -->
     <dependency>
         <groupId>commons-fileupload</groupId>
         <artifactId>commons-fileupload</artifactId>
         <version>1.3.1</version>
     </dependency>
     <dependency>
         <groupId>commons-io</groupId>
         <artifactId>commons-io</artifactId>
         <version>2.4</version>
     </dependency>
     <dependency>
         <groupId>commons-codec</groupId>
         <artifactId>commons-codec</artifactId>
         <version>1.9</version>
     </dependency>
     <!-- 自动生成 -->
     <dependency>
         <groupId>org.mybatis.generator</groupId>
         <artifactId>mybatis-generator-core</artifactId>
         <version>1.3.6</version>
     </dependency>

   </dependencies>
   <build>
     <finalName>ssm</finalName>
     <plugins>
      <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.5.1</version>
         <configuration>
             <source>1.8</source>
             <target>1.8</target>
             <encoding>UTF-8</encoding>
         </configuration>
      </plugin>
   </plugins>
   </build>
 </project>

建立 jdbc 属性配置文件， db.properties

 jdbc.driver=com.mysql.jdbc.Driver
 jdbc.url=jdbc:mysql://localhost:3306/mybatis
 jdbc.username=root
 jdbc.password=密码

建立 log4j 日志配置文件， log4j.properties

 #定义LOG输出级别
 log4j.rootLogger=INFO,Console,File
 #定义日志输出目的地为控制台
 log4j.appender.Console=org.apache.log4j.ConsoleAppender
 log4j.appender.Console.Target=System.out
 #可以灵活地指定日志输出格式，下面一行是指定具体的格式
 log4j.appender.Console.layout = org.apache.log4j.PatternLayout
 log4j.appender.Console.layout.ConversionPattern=[%c] - %m%n
 #文件大小到达指定尺寸的时候产生一个新的文件
 log4j.appender.File = org.apache.log4j.RollingFileAppender
 #指定输出目录
 log4j.appender.File.File = logs/springmvcMybist/ssm.log
 #定义文件最大大小
 log4j.appender.File.MaxFileSize = 10MB
 #输出所以日志，如果换成DEBUG表示输出DEBUG以上级别日志
 log4j.appender.File.Threshold = ALL
 log4j.appender.File.layout = org.apache.log4j.PatternLayout

建立 applicationContext.xml 配置文件

　　applicationContext.xml 是spring 的配置文件，读取 db.properties 文件的配置和数据源配置，配置事务管理器、开启事务注解。配置用于整合 Mybatis 框架的 Mybatis 工厂信息，定义 mapper 扫描器来扫描 DAO 和 Service 层的配置。

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

     <!-- 读取db.properties -->
     <context:property-placeholder location="classpath:db.properties"/>
     <!-- 配置数据源 -->
     <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
         <!-- 数据库驱动 -->
         <property name="driverClassName" value="${jdbc.driver}"/>
         <property name="url" value="${jdbc.url}"/>
         <property name="username" value="${jdbc.username}"/>
         <property name="password" value="${jdbc.password}"/>
     </bean>
     <!-- 事务管理器，依赖于数据源 -->
     <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
         <property name="dataSource" ref="dataSource"/>
     </bean>
     <!-- 开启事务注解 -->
     <tx:annotation-driven transaction-manager="transactionManager"/>
     <!-- 配置MyBatis工厂 SqlSessionFactory -->
     <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
         <!-- 注入数据源 -->
         <property name="dataSource" ref="dataSource"/>
         <!-- 指定Mybatis核心配置文件位置 -->
         <property name="configLocation" value="classpath:mybatis-config.xml"/>
     </bean>
     <!-- 配置mapper扫描器 -->
     <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
         <property name="basePackage" value="dao"/>
     </bean>
     <!-- 扫描Service -->
     <context:component-scan base-package="service"/>
 </beans>

建立 Mybatis 配置文件， mybatis-config.xml

　　因为已经在 Spring 中配置了数据源信息以及 mapper 接口文件扫描器，所以在 Mybatis 的配置文件中只需要根据 POJO 类路径进行别名配置。

 <?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>
     <!-- 别名定义 -->
     <typeAliases>
         <package name="po"/>
     </typeAliases>
 </configuration>

建立 Spring MVC 的配置文件，springmvc-config.xml

　　配置用于扫描 @Controller 注解的包扫描器、注解驱动器以及视图解析器。

 <?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-4.0.xsd
         http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd">
     <!-- 配置包扫描器，扫描@Controller注解的类 -->
     <context:component-scan base-package="controller"/>
     <!-- 加载注解驱动 -->
     <mvc:annotation-driven/>
     <!-- 配置视图解析器 -->
     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
         <property name="prefix" value="/WEB-INF/jsp/"/>
         <property name="suffix" value=".jsp"/>
     </bean>
 </beans>

修改 web.xml 文件

　　配置 spring 的文件监听器、编码过滤器以及 Spring MVC 的前端控制器等信息。

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns="http://java.sun.com/xml/ns/javaee"
     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
     version="3.0">
   <display-name>Archetype Created Web Application</display-name>

     <!-- 配置加载Spring文件的监听器 -->
     <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>
     <!-- 编码过滤器 -->
     <filter>
         <filter-name>encoding</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>encoding</filter-name>
         <url-pattern>/*</url-pattern>
     </filter-mapping>
     <!-- 配置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:springmvc-config.xml</param-value>
         </init-param>
         <!-- 配置服务器启动后立即加载SpringMVC配置文件 -->
         <load-on-startup>1</load-on-startup>
     </servlet>
     <servlet-mapping>
         <servlet-name>springmvc</servlet-name>
         <url-pattern>/</url-pattern>
     </servlet-mapping>
 </web-app>

整合应用测试

　　到这里利用 Maven 整合 SSM 框架的所有操作已经完成了，那么接下来让我们验证一下，刚刚的整合操作是否存在问题呢？

建立 Student.java 持久化类

　　用于映射数据库表的持久化类。

 package po;

 public class Student {
     private Integer id;
     private String stuno;
     private String name;
     private Integer age;
     public Integer getId() {
         return id;
     }
     public void setId(Integer id) {
         this.id = id;
     }
     public String getStuno() {
         return stuno;
     }
     public void setStuno(String stuno) {
         this.stuno = stuno;
     }
     public String getName() {
         return name;
     }
     public void setName(String name) {
         this.name = name;
     }
     public Integer getAge() {
         return age;
     }
     public void setAge(Integer age) {
         this.age = age;
     }
     @Override
     public String toString() {
         return "Student [id=" + id + ", stuno=" + stuno + ", name=" + name + ", age=" + age + "]";
     }
 }

建立StudentDao接口文件和映射文件

　　接口文件中定义类一个根据 id 查询学生信息的方法。

　　映射文件中变细了对应这个方法的 sql 语句。

 package dao;

 import po.Student;

 public interface StudentDao {
     public Student findStudentById(Integer id);
 }

 <?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="dao.StudentDao">
     <select id="findStudentById" parameterType="Integer" resultType="Student">
         select * from t_stu_ex51 where id=#{id}
     </select>
 </mapper>

建立 StudentService 接口文件

　　定义通过 id 查询学生信息的方法

 package service;

 import po.Student;

 public interface StudentService {
     public Student findStudentById(Integer id);
 }

建立 StudentServiceImpl.java 实现类

　　在类中调用了 CustomerDao 的查询学生信息的方法。

　　实现类采用了基于注解的形式， @Service 注解标识业务层的实现类， @Transactional 注解标识类中的所有方法都进行了 spring 中的事务管理， @Autowired 注解将 CustomerDao 接口对象注入到类中。

 package service.impl;

 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;

 import dao.StudentDao;
 import po.Student;
 import service.StudentService;

 @Service
 @Transactional
 public class StudentServiceImpl implements StudentService {

     @Autowired
     private StudentDao studentDao;

     public Student findStudentById(Integer id) {
         return this.studentDao.findStudentById(id);
     }
 }

建立 StudentController.java 类

　　用于处理页面请求的控制器类 CustomerController，编写了一个根据 id 查询学生信息的方法，该方法将获取到的学生信息返回到了 student 视图中，即 student.jsp 页面中。

　　采用了基于注解的形式， @Controller 来标识控制器类， @Autowired 将 StudentService 接口对象注入到类中

 package controller;

 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Controller;
 import org.springframework.ui.Model;
 import org.springframework.web.bind.annotation.RequestMapping;

 import po.Student;
 import service.StudentService;

 @Controller
 public class StudentController {
     @Autowired
     private StudentService studentService;
     @RequestMapping("/findStudentById")
     public String findStudentById(Integer id, Model model) {
         Student student = studentService.findStudentById(id);
         model.addAttribute("student", student);
         return "student";
     }
 }

建立 student.jsp 文件

 <%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
 <!DOCTYPE html>
 <html>
 <head>
 <meta charset="UTF-8">
 <title>学生信息</title>
 </head>
 <body>
     <table border="1">
         <tr>
             <td>编号</td>
             <td>学号</td>
             <td>姓名</td>
             <td>年龄</td>
         </tr>
         <tr>
             <td>${student.id}</td>
             <td>${student.stuno}</td>
             <td>${student.name}</td>
             <td>${student.age}</td>
         </tr>
     </table>
 </body>
 </html>

将项目发布到 tomcat 中

输入URL测试

---

　　

　　写这篇博客主要是为了记录一下 Maven 整合框架的基本操作。实现的功能也都是最基本的功能。就当留个印象，以后再开发项目可以回过头来看。

　　代码已上传至github：https://github.com/JYRoy/MavenSSM