用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 包也正是要通过这个文件导入。

  1 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  2   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  3   <modelVersion>4.0.0modelVersion>
  4   <groupId>com.cjkgroupId>
  5   <artifactId>ssmartifactId>
  6   <packaging>warpackaging>
  7   <version>0.0.1-SNAPSHOTversion>
  8   <name>ssm Maven Webappname>
  9   <url>http://maven.apache.orgurl>
 10   
 11   <properties>
 12       
 13       <spring.version>4.0.2.RELEASEspring.version>
 14       
 15     <mybatis.version>3.2.6mybatis.version>
 16     
 17     <slf4j.version>1.7.7slf4j.version>
 18     <log4j.version>1.2.17log4j.version>
 19   properties>
 20   <dependencies>
 21     <dependency>
 22       <groupId>junitgroupId>
 23       <artifactId>junitartifactId>
 24       <version>3.8.1version>
 25       <scope>testscope>
 26     dependency>
 27     
 28     <dependency>
 29         <groupId>javaxgroupId>
 30         <artifactId>javaee-apiartifactId>
 31         <version>7.0version>
 32     dependency>
 33     <dependency>
 34         <groupId>junitgroupId>
 35         <artifactId>junitartifactId>
 36         <version>4.11version>
 37         
 38         <scope>testscope>
 39     dependency>
 40     
 41     <dependency>
 42         <groupId>org.springframeworkgroupId>
 43         <artifactId>spring-coreartifactId>
 44         <version>${spring.version}version>
 45     dependency>
 46     <dependency>
 47         <groupId>org.springframeworkgroupId>
 48         <artifactId>spring-webartifactId>
 49         <version>${spring.version}version>
 50     dependency>
 51     <dependency>
 52         <groupId>org.springframeworkgroupId>
 53         <artifactId>spring-oxmartifactId>
 54         <version>${spring.version}version>
 55     dependency>
 56     <dependency>
 57         <groupId>org.springframeworkgroupId>
 58         <artifactId>spring-txartifactId>
 59         <version>${spring.version}version>
 60     dependency>
 61     <dependency>
 62         <groupId>org.springframeworkgroupId>
 63         <artifactId>spring-jdbcartifactId>
 64         <version>${spring.version}version>
 65     dependency>
 66     <dependency>
 67         <groupId>org.springframeworkgroupId>
 68         <artifactId>spring-webmvcartifactId>
 69         <version>${spring.version}version>
 70     dependency>
 71     <dependency>
 72         <groupId>org.springframeworkgroupId>
 73         <artifactId>spring-aopartifactId>
 74         <version>${spring.version}version>
 75     dependency>
 76     <dependency>
 77         <groupId>org.springframeworkgroupId>
 78         <artifactId>spring-context-supportartifactId>
 79         <version>${spring.version}version>
 80     dependency>
 81     <dependency>
 82         <groupId>org.springframeworkgroupId>
 83         <artifactId>spring-testartifactId>
 84         <version>${spring.version}version>
 85     dependency>
 86     
 87     <dependency>
 88         <groupId>org.mybatisgroupId>
 89         <artifactId>mybatisartifactId>
 90         <version>${mybatis.version}version>
 91     dependency>
 92     
 93     <dependency>
 94         <groupId>org.mybatisgroupId>
 95         <artifactId>mybatis-springartifactId>
 96         <version>1.2.2version>
 97     dependency>
 98     
 99     <dependency>
100         <groupId>mysqlgroupId>
101         <artifactId>mysql-connector-javaartifactId>
102         <version>5.1.30version>
103     dependency>
104     
105     <dependency>
106         <groupId>commons-dbcpgroupId>
107         <artifactId>commons-dbcpartifactId>
108         <version>1.2.2version>
109     dependency>
110     
111     <dependency>
112         <groupId>jstlgroupId>
113         <artifactId>jstlartifactId>
114         <version>1.2version>
115     dependency>
116     
117     
118     <dependency>
119         <groupId>log4jgroupId>
120         <artifactId>log4jartifactId>
121         <version>${log4j.version}version>
122     dependency>
123     
124     <dependency>
125         <groupId>com.alibabagroupId>
126         <artifactId>fastjsonartifactId>
127         <version>1.1.41version>
128     dependency>
129     <dependency>
130         <groupId>org.slf4jgroupId>
131         <artifactId>slf4j-apiartifactId>
132         <version>${slf4j.version}version>
133     dependency>
134     <dependency>
135         <groupId>org.slf4jgroupId>
136         <artifactId>slf4j-log4j12artifactId>
137         <version>${slf4j.version}version>
138     dependency>
139     
140     
141     <dependency>
142         <groupId>org.codehaus.jacksongroupId>
143         <artifactId>jackson-mapper-aslartifactId>
144         <version>1.9.13version>
145     dependency>
146     
147     <dependency>
148         <groupId>commons-fileuploadgroupId>
149         <artifactId>commons-fileuploadartifactId>
150         <version>1.3.1version>
151     dependency>
152     <dependency>
153         <groupId>commons-iogroupId>
154         <artifactId>commons-ioartifactId>
155         <version>2.4version>
156     dependency>
157     <dependency>
158         <groupId>commons-codecgroupId>
159         <artifactId>commons-codecartifactId>
160         <version>1.9version>
161     dependency>
162     
163     <dependency>
164         <groupId>org.mybatis.generatorgroupId>
165         <artifactId>mybatis-generator-coreartifactId>
166         <version>1.3.6version>
167     dependency>
168 
169     
170   dependencies>
171   <build>
172     <finalName>ssmfinalName>
173     <plugins>
174      <plugin>
175         <groupId>org.apache.maven.pluginsgroupId>
176         <artifactId>maven-compiler-pluginartifactId>
177         <version>3.5.1version>
178         <configuration>
179             <source>1.8source>
180             <target>1.8target>
181             <encoding>UTF-8encoding>
182         configuration>
183      plugin>
184   plugins>
185   build>
186 project>

 

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

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

 

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

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

 

建立 applicationContext.xml 配置文件

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

 1 xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:context="http://www.springframework.org/schema/context" xmlns:p="http://www.springframework.org/schema/p"
 4     xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"
 5     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 6     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
 7     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
 8     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
 9     http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-4.0.xsd">
10 
11     
12     <context:property-placeholder location="classpath:db.properties"/>
13     
14     <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
15         
16         <property name="driverClassName" value="${jdbc.driver}"/>
17         <property name="url" value="${jdbc.url}"/>
18         <property name="username" value="${jdbc.username}"/>
19         <property name="password" value="${jdbc.password}"/>
20     bean>
21     
22     <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
23         <property name="dataSource" ref="dataSource"/>
24     bean>
25     
26     <tx:annotation-driven transaction-manager="transactionManager"/>
27     
28     <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
29         
30         <property name="dataSource" ref="dataSource"/>
31         
32         <property name="configLocation" value="classpath:mybatis-config.xml"/>
33     bean>
34     
35     <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
36         <property name="basePackage" value="dao"/>
37     bean>
38     
39     <context:component-scan base-package="service"/>
40 beans>

 

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

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

1 xml version="1.0" encoding="UTF-8" ?>
2 DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
3 "http://mybatis.org/dtd/mybatis-3-config.dtd">
4 <configuration>
5     
6     <typeAliases>
7         <package name="po"/>
8     typeAliases>
9 configuration>

 

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

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

 1 xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
 4     xmlns:context="http://www.springframework.org/schema/context"
 5     xmlns:mvc="http://www.springframework.org/schema/mvc"
 6     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
 7         http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
 8         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd">
 9     
10     <context:component-scan base-package="controller"/>
11     
12     <mvc:annotation-driven/>
13     
14     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
15         <property name="prefix" value="/WEB-INF/jsp/"/>
16         <property name="suffix" value=".jsp"/>
17     bean>
18 beans>

 

修改 web.xml 文件

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

 1 xml version="1.0" encoding="UTF-8"?>
 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3     xmlns="http://java.sun.com/xml/ns/javaee"
 4     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
 5     version="3.0">
 6   <display-name>Archetype Created Web Applicationdisplay-name>
 7 
 8     
 9     <context-param>
10         <param-name>contextConfigLocationparam-name>
11         <param-value>classpath:applicationContext.xmlparam-value>
12     context-param>
13     <listener>
14         <listener-class>
15             org.springframework.web.context.ContextLoaderListener
16         listener-class>
17     listener>
18     
19     <filter>
20         <filter-name>encodingfilter-name>
21         <filter-class>
22             org.springframework.web.filter.CharacterEncodingFilter
23         filter-class>
24         <init-param>
25             <param-name>encodingparam-name>
26             <param-value>UTF-8param-value>
27         init-param>
28     filter>
29     <filter-mapping>
30         <filter-name>encodingfilter-name>
31         <url-pattern>/*url-pattern>
32     filter-mapping>
33     
34     <servlet>
35         <servlet-name>springmvcservlet-name>
36         <servlet-class>
37             org.springframework.web.servlet.DispatcherServlet
38         servlet-class>
39         <init-param>
40             <param-name>contextConfigLocationparam-name>
41             <param-value>classpath:springmvc-config.xmlparam-value>
42         init-param>
43         
44         <load-on-startup>1load-on-startup>
45     servlet>
46     <servlet-mapping>
47         <servlet-name>springmvcservlet-name>
48         <url-pattern>/url-pattern>
49     servlet-mapping>
50 web-app>

 

整合应用测试

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

建立 Student.java 持久化类

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

 1 package po;
 2 
 3 public class Student {
 4     private Integer id;
 5     private String stuno;
 6     private String name;
 7     private Integer age;
 8     public Integer getId() {
 9         return id;
10     }
11     public void setId(Integer id) {
12         this.id = id;
13     }
14     public String getStuno() {
15         return stuno;
16     }
17     public void setStuno(String stuno) {
18         this.stuno = stuno;
19     }
20     public String getName() {
21         return name;
22     }
23     public void setName(String name) {
24         this.name = name;
25     }
26     public Integer getAge() {
27         return age;
28     }
29     public void setAge(Integer age) {
30         this.age = age;
31     }
32     @Override
33     public String toString() {
34         return "Student [id=" + id + ", stuno=" + stuno + ", name=" + name + ", age=" + age + "]";
35     }
36 }

 

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

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

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

1 package dao;
2 
3 import po.Student;
4 
5 public interface StudentDao {
6     public Student findStudentById(Integer id);
7 }

1 xml version="1.0" encoding="UTF-8" ?>
2 DOCTYPE mapper
3 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
4 "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
5 <mapper namespace="dao.StudentDao">
6     <select id="findStudentById" parameterType="Integer" resultType="Student">
7         select * from t_stu_ex51 where id=#{id}
8     select>
9 mapper>

 

建立 StudentService 接口文件

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

1 package service;
2 
3 import po.Student;
4 
5 public interface StudentService {
6     public Student findStudentById(Integer id);
7 }

 

建立 StudentServiceImpl.java 实现类

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

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

 1 package service.impl;
 2 
 3 import org.springframework.beans.factory.annotation.Autowired;
 4 import org.springframework.stereotype.Service;
 5 import org.springframework.transaction.annotation.Transactional;
 6 
 7 import dao.StudentDao;
 8 import po.Student;
 9 import service.StudentService;
10 
11 @Service
12 @Transactional
13 public class StudentServiceImpl implements StudentService {
14     
15     @Autowired
16     private StudentDao studentDao;
17 
18     public Student findStudentById(Integer id) {
19         return this.studentDao.findStudentById(id);
20     }
21 }

 

建立 StudentController.java 类

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

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

 1 package controller;
 2 
 3 import org.springframework.beans.factory.annotation.Autowired;
 4 import org.springframework.stereotype.Controller;
 5 import org.springframework.ui.Model;
 6 import org.springframework.web.bind.annotation.RequestMapping;
 7 
 8 import po.Student;
 9 import service.StudentService;
10 
11 @Controller
12 public class StudentController {
13     @Autowired
14     private StudentService studentService;
15     @RequestMapping("/findStudentById")
16     public String findStudentById(Integer id, Model model) {
17         Student student = studentService.findStudentById(id);
18         model.addAttribute("student", student);
19         return "student";
20     }
21 }

 

建立 student.jsp 文件

 1 <%@ page language="java" contentType="text/html; charset=UTF-8"
 2     pageEncoding="UTF-8"%>
 3 DOCTYPE html>
 4 <html>
 5 <head>
 6 <meta charset="UTF-8">
 7 <title>学生信息title>
 8 head>
 9 <body>
10     <table border="1">
11         <tr>
12             <td>编号td>
13             <td>学号td>
14             <td>姓名td>
15             <td>年龄td>
16         tr>
17         <tr>
18             <td>${student.id}td>
19             <td>${student.stuno}td>
20             <td>${student.name}td>
21             <td>${student.age}td>
22         tr>
23     table>
24 body>
25 html>

 

将项目发布到 tomcat 中

输入URL测试

 

---

　　

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

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