用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.0</modelVersion> 4 <groupId>com.cjk</groupId> 5 <artifactId>ssm</artifactId> 6 <packaging>war</packaging> 7 <version>0.0.1-SNAPSHOT</version> 8 <name>ssm Maven Webapp</name> 9 <url>http://maven.apache.org</url> 10 11 <properties> 12 <!-- spring版本号 --> 13 <spring.version>4.0.2.RELEASE</spring.version> 14 <!-- mybatis版本号 --> 15 <mybatis.version>3.2.6</mybatis.version> 16 <!-- log4j日志文件管理包版本 --> 17 <slf4j.version>1.7.7</slf4j.version> 18 <log4j.version>1.2.17</log4j.version> 19 </properties> 20 <dependencies> 21 <dependency> 22 <groupId>junit</groupId> 23 <artifactId>junit</artifactId> 24 <version>3.8.1</version> 25 <scope>test</scope> 26 </dependency> 27 <!-- 导入java ee jar包(可以去除index.jsp报错) --> 28 <dependency> 29 <groupId>javax</groupId> 30 <artifactId>javaee-api</artifactId> 31 <version>7.0</version> 32 </dependency> 33 <dependency> 34 <groupId>junit</groupId> 35 <artifactId>junit</artifactId> 36 <version>4.11</version> 37 <!-- 表示开发的时候引入,发布的时候不会加载此包 --> 38 <scope>test</scope> 39 </dependency> 40 <!-- spring核心包 --> 41 <dependency> 42 <groupId>org.springframework</groupId> 43 <artifactId>spring-core</artifactId> 44 <version>${spring.version}</version> 45 </dependency> 46 <dependency> 47 <groupId>org.springframework</groupId> 48 <artifactId>spring-web</artifactId> 49 <version>${spring.version}</version> 50 </dependency> 51 <dependency> 52 <groupId>org.springframework</groupId> 53 <artifactId>spring-oxm</artifactId> 54 <version>${spring.version}</version> 55 </dependency> 56 <dependency> 57 <groupId>org.springframework</groupId> 58 <artifactId>spring-tx</artifactId> 59 <version>${spring.version}</version> 60 </dependency> 61 <dependency> 62 <groupId>org.springframework</groupId> 63 <artifactId>spring-jdbc</artifactId> 64 <version>${spring.version}</version> 65 </dependency> 66 <dependency> 67 <groupId>org.springframework</groupId> 68 <artifactId>spring-webmvc</artifactId> 69 <version>${spring.version}</version> 70 </dependency> 71 <dependency> 72 <groupId>org.springframework</groupId> 73 <artifactId>spring-aop</artifactId> 74 <version>${spring.version}</version> 75 </dependency> 76 <dependency> 77 <groupId>org.springframework</groupId> 78 <artifactId>spring-context-support</artifactId> 79 <version>${spring.version}</version> 80 </dependency> 81 <dependency> 82 <groupId>org.springframework</groupId> 83 <artifactId>spring-test</artifactId> 84 <version>${spring.version}</version> 85 </dependency> 86 <!-- mybatis核心包 --> 87 <dependency> 88 <groupId>org.mybatis</groupId> 89 <artifactId>mybatis</artifactId> 90 <version>${mybatis.version}</version> 91 </dependency> 92 <!-- mybatis/spring包 --> 93 <dependency> 94 <groupId>org.mybatis</groupId> 95 <artifactId>mybatis-spring</artifactId> 96 <version>1.2.2</version> 97 </dependency> 98 <!-- 导入Mysql数据库链接jar包 --> 99 <dependency> 100 <groupId>mysql</groupId> 101 <artifactId>mysql-connector-java</artifactId> 102 <version>5.1.30</version> 103 </dependency> 104 <!-- 导入dbcp的jar包,用来在applicationContext.xml中配置数据库 --> 105 <dependency> 106 <groupId>commons-dbcp</groupId> 107 <artifactId>commons-dbcp</artifactId> 108 <version>1.2.2</version> 109 </dependency> 110 <!-- JSTL标签类 --> 111 <dependency> 112 <groupId>jstl</groupId> 113 <artifactId>jstl</artifactId> 114 <version>1.2</version> 115 </dependency> 116 <!-- 日志文件管理包 --> 117 <!-- log start --> 118 <dependency> 119 <groupId>log4j</groupId> 120 <artifactId>log4j</artifactId> 121 <version>${log4j.version}</version> 122 </dependency> 123 <!-- 格式化对象,方便输出日志 --> 124 <dependency> 125 <groupId>com.alibaba</groupId> 126 <artifactId>fastjson</artifactId> 127 <version>1.1.41</version> 128 </dependency> 129 <dependency> 130 <groupId>org.slf4j</groupId> 131 <artifactId>slf4j-api</artifactId> 132 <version>${slf4j.version}</version> 133 </dependency> 134 <dependency> 135 <groupId>org.slf4j</groupId> 136 <artifactId>slf4j-log4j12</artifactId> 137 <version>${slf4j.version}</version> 138 </dependency> 139 <!-- log end --> 140 <!-- 映入JSON --> 141 <dependency> 142 <groupId>org.codehaus.jackson</groupId> 143 <artifactId>jackson-mapper-asl</artifactId> 144 <version>1.9.13</version> 145 </dependency> 146 <!-- 上传组件包 --> 147 <dependency> 148 <groupId>commons-fileupload</groupId> 149 <artifactId>commons-fileupload</artifactId> 150 <version>1.3.1</version> 151 </dependency> 152 <dependency> 153 <groupId>commons-io</groupId> 154 <artifactId>commons-io</artifactId> 155 <version>2.4</version> 156 </dependency> 157 <dependency> 158 <groupId>commons-codec</groupId> 159 <artifactId>commons-codec</artifactId> 160 <version>1.9</version> 161 </dependency> 162 <!-- 自动生成 --> 163 <dependency> 164 <groupId>org.mybatis.generator</groupId> 165 <artifactId>mybatis-generator-core</artifactId> 166 <version>1.3.6</version> 167 </dependency> 168 169 170 </dependencies> 171 <build> 172 <finalName>ssm</finalName> 173 <plugins> 174 <plugin> 175 <groupId>org.apache.maven.plugins</groupId> 176 <artifactId>maven-compiler-plugin</artifactId> 177 <version>3.5.1</version> 178 <configuration> 179 <source>1.8</source> 180 <target>1.8</target> 181 <encoding>UTF-8</encoding> 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 <!-- 读取db.properties --> 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 <!-- 配置MyBatis工厂 SqlSessionFactory --> 28 <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> 29 <!-- 注入数据源 --> 30 <property name="dataSource" ref="dataSource"/> 31 <!-- 指定Mybatis核心配置文件位置 --> 32 <property name="configLocation" value="classpath:mybatis-config.xml"/> 33 </bean> 34 <!-- 配置mapper扫描器 --> 35 <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> 36 <property name="basePackage" value="dao"/> 37 </bean> 38 <!-- 扫描Service --> 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 <!-- 配置包扫描器,扫描@Controller注解的类 --> 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 Application</display-name> 7 8 <!-- 配置加载Spring文件的监听器 --> 9 <context-param> 10 <param-name>contextConfigLocation</param-name> 11 <param-value>classpath:applicationContext.xml</param-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>encoding</filter-name> 21 <filter-class> 22 org.springframework.web.filter.CharacterEncodingFilter 23 </filter-class> 24 <init-param> 25 <param-name>encoding</param-name> 26 <param-value>UTF-8</param-value> 27 </init-param> 28 </filter> 29 <filter-mapping> 30 <filter-name>encoding</filter-name> 31 <url-pattern>/*</url-pattern> 32 </filter-mapping> 33 <!-- 配置SpringMVC前端核心控制器 --> 34 <servlet> 35 <servlet-name>springmvc</servlet-name> 36 <servlet-class> 37 org.springframework.web.servlet.DispatcherServlet 38 </servlet-class> 39 <init-param> 40 <param-name>contextConfigLocation</param-name> 41 <param-value>classpath:springmvc-config.xml</param-value> 42 </init-param> 43 <!-- 配置服务器启动后立即加载SpringMVC配置文件 --> 44 <load-on-startup>1</load-on-startup> 45 </servlet> 46 <servlet-mapping> 47 <servlet-name>springmvc</servlet-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