优质文章,及时送达
我想大多数做 Java 开发的同学对SSM框架的搭建已经都轻车熟路了,但是大家搭建的大多数是单模块的,网上也有非常多的例子,但是如何用maven去构建多module的ssm项目呢?下面来手把手的,利用IntelliJ IDEA搭建一次多module的ssm项目,给大家一个参考。
为什么要搭建多模块的maven项目?
首先抛出这么一个问题,我们为什么要搭建多模块的maven项目呢?以多模块的方式组织项目,其实也是maven一直倡导的。做开发的同学都知道的一个概念就是“低耦合,高内聚”,将项目划分多模块,可以极大的增大代码的重用性,防止随着项目的增大,pom文件越来越臃肿。
对于一般的java项目我们一般是这么分层的:
dao层负责数据库的交互。
service层主要处理业务逻辑。
web层负责与客户端交互。
pojo层存放的是实体类。
common层存放我们常用的一些公用的工具类等。
对应的,在一个项目中,我们会看到一些包名:
com.leeyom.ssm.dao
com.leeyom.ssm.service
com.leeyom.ssm.web
com.leeyom.ssm.common
com.leeyom.ssm.pojo
这样整个项目的框架就清晰了,但随着项目的进行,你可能会遇到如下问题:
这个应用可能需要有一个前台和一个后台管理端,你发现大部分dao,一些service,和大部分util是在两个应用中均可用。
pom.xml中的依赖列表越来越长以重用的,但是,由于目前只有一个项目(WAR),你不得不新建一个项目依赖这个WAR,这变得非常的恶心,因为在Maven中配置对WAR的依赖远不如依赖JAR那样简单明了,而且你根本不需要com.leeyom.ssm.web。有人修改了dao,提交到svn并且不小心导致build失败了,你在编写service的代码,发现编译不过,只能等那人把dao修复了,你才能继续进行,很多人都在修改,到后来你根本就不清楚哪个依赖是谁需要的,渐渐的,很多不必要的依赖被引入。甚至出现了一个依赖有多个版本存在。
build整个项目的时间越来越长,尽管你只是一直在web层工作,但你不得不build整个项目。
某个模块,比如util,你只想让一些经验丰富的人来维护,可是,现在这种情况,每个开发者都能修改,这导致关键模块的代码质量不能达到你的要求。
我们会发现,其实这里实际上没有遵守一个设计模式原则:“高内聚,低耦合”。虽然我们通过包名划分了层次,并且你还会说,这些包的依赖都是单向的,没有包的环依赖。这很好,但还不够,因为就构建层次来说,所有东西都被耦合在一起了。因此我们需要使用Maven划分模块。
以上的讲解是参考:
https://www.iteye.com/blog/juvenshun-305865
项目结构
项目整体目录
ssm-demo
├── ssm-common -- 公共模块,主要存放一些工具类
| ├── src
| ├── pom.xml -- 打包方式:jar
├── ssm-dao -- 存放mybatis相关的mapper接口
| ├── src
| ├── pom.xml -- 打包方式:jar
├── ssm-pojo -- 存放实体类
| ├── src
| ├── pom.xml -- 打包方式:jar
├── ssm-service -- 存放业务逻辑类
| ├── src
| ├── pom.xml -- 打包方式:jar
├── ssm-web -- 存放前台页面,客户端交互相关的controller
| ├── src
| ├── pom.xml -- 打包方式:war
├── pom.xml --打包方式为pom,一些公用的依赖
各模块的依赖关系
Maven多模块项目创建
1. 先创建一个空的maven项目(ssm-demo)作为父级项目,创建成功后,删除掉src目录! 保留 pom 文件。
2. 在pom文件中添加公有的依赖,公有的依赖主要有:spring核心包、日志包、json包、apache工具包,点击查看完整的父级pom.xml。
右击我们刚刚创建的父级项目ssm-demo,选择 new --> Module,创建ssm-common模块
填写Artifactldssm-common:
点击Finish,就可以建好ssm-common模块。
打开ssm-common的pom.xml文件,添加该模块的打包方式为jar,不需要依赖其他的模块,也不需要继承父级的依赖,所以需要删掉parent标签段,完整的如下:
4.0.0
com.leeyom.ssm
ssm-common
1.0-SNAPSHOT
jar
UTF-8
1.8
1.8
1.8
完整源码地址在公众号后台回复「多模块」获取。
由于该模块是共有的依赖的,也就是说其他的模块可能会用到,所以需要将他添加到父级pom的dependencies中去。
1. 创建ssm-pojo模块,该模块主要存放实体类,不需要依赖其他的模块,处理方式和ssm-common大致相似。
2. 创建ssm-dao模块,由于该模块需要跟数据库打交道,所以跟数据库相关的依赖,应该放到该模块的pom文件中,同时该模块依赖于ssm-pojo模块进行数据库实体映射,如下所示:
com.leeyom.ssm
ssm-pojo
1.0-SNAPSHOT
org.mybatis
mybatis
${mybatis.version}
org.mybatis
mybatis-spring
${mybatis-spring.version}
mysql
mysql-connector-java
${mysql-connector.version}
runtime
com.github.pagehelper
pagehelper
${pagehelper.version}
com.alibaba
druid
${druid.version}
3. 创建ssm-service模块,该模块主要用于处理业务逻辑,需要依赖ssm-dao模块和数据库打交道,同时还需要在此处继承父级的依赖,实现事务管理,自动装配等等:
ssm
com.leeyom.ssm
1.0-SNAPSHOT
4.0.0
ssm-service
jar
UTF-8
1.8
1.8
1.8
com.leeyom.ssm
ssm-dao
1.0-SNAPSHOT
4. 创建`ssm-web`,该模块主要的作用是处理http请求,所以servlet、jsp、文件上传组件包相关的依赖写在该模块的pom文件中,该模块主要跟客户端打交道,该模块需要依赖于`ssm-service`模块,该模块集成了所有的依赖,为什么这么说,可以什么理解:
ssm-web依赖于ssm-service。
ssm-service 继承了父级的pom,同时还依赖ssm-dao模块。
ssm-dao模块依赖于ssm-pojo。
父级pom依赖ssm-common。
SSM框架的整合
通过上面搭建maven好的maven多模块项目的骨架,现在就可以开始ssm项目的整合了,我的开发环境和所用的三大框架的版本如下:
开发环境是:
IntelliJ IDEA 2017.1
JDK 1.8.0_45
Tomcat 7
Maven 3.3.9
MySQL 5.7.16
三大框架版本:
Spring 4.1.7.RELEASE
Spring MVC 4.1.7.RELEASE
MyBatis 3.3.0
核心配置文件:
Spring 与 mybatis 的整合
所有的ssm整合配置项都是在ssm-web这个子模块下面进行配置,先来看一下ssm-web模块的目录结构:
建立jdbc.properties数据库属性文件
jdbc.url=jdbc:mysql://localhost:3306/ssm-demo?useUnicode=true&characterEncoding=utf8
jdbc.username=root
jdbc.password=root
因为我们这边用的是阿里巴巴的德鲁伊数据库连接池,并不需要配置jdbc.driver,如果你用的是c3p0或者dbcp数据库连接池,是要配置jdbc.driver。
创建spring-mybatis.xml核心配置文件
该配置文件也是spring整合mybatis的核心配置文件,事务管理,数据源,自动扫描都是在这里配置,具体的详情,可以看配置文件里面的注释。
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-3.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.1.xsd">
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
创建mybatis-config.xml分页插件配置文件
mybatis分页插件PaheHelper是一个非常好用的分页插件,也可以通过配置文件的形式整合到mybatis中,具体怎么使用可以参考我以前写的文章:mybatis 分页插件PageHelper使用及总结。
http://www.leeyom.top/2016/12/05/tech-mybatis-pagehelper/
具体的配置如下:
/p>
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
创建Log4j日志
为了方便查看控制台打印的日志,需要配置log4j日志配置文件:
#定义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=${catalina.home}/logs/ssm.log
#定义文件最大大小
log4j.appender.File.MaxFileSize=10MB
#输出所以日志,如果换成DEBUG表示输出DEBUG以上级别日志
log4j.appender.File.Threshold=ALL
log4j.appender.File.layout=org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern=[%p] [%d{yyyy-MM-dd HH:mm:ss}][%c]%m%n
测试spring与mybatis的整合情况
创建测试表t_user,表结构如下:
DROP TABLE IF EXISTS `t_user`;
CREATE TABLE `t_user` (
`u_id` int(100) NOT AUTO_INCREMENT,
`u_name` varchar(100) DEFAULT ,
`u_password` varchar(100) DEFAULT ,
PRIMARY KEY (`u_id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;
SET FOREIGN_KEY_CHECKS = 1;
再往该表中随便插入两条条数据:
INSERT INTO `t_user` VALUES ('1', 'leeyom', 'root'), ('2', '小明', 'admin');
利用mybatis-generator生成UserMapper.java、User.java、UserMapper.xml等相关的文件。文件是生成了,但是得放到对的位置,UserMapper.java放到ssm-dao模块下面,因为该层主要跟数据库进行交互,所以,dao层的接口文件就是放在该模块下面。User.java放到ssm-pojo模块下面,该模块主要存放实体类的bean,而UserMapper.xml文件则放在ssm-web模块的resources资源目录下面的mapper文件夹下面,放在此模块下面的原因是,该映射文件将打包一起部署到web服务器上面,如果放到ssm-dao模块,ssm-dao的打包方式是jar,到时候会出现引用到不该数据库映射文件。
最后我们还需要在ssm-service模块创建接口类UserService.java
package com.leeyom.service.user;
import com.leeyom.pojo.User;
public interface UserService {
public User getUserById(Integer userId);
}
接口的实现类UserServiceImpl.java
package com.leeyom.service.user.impl;
import com.leeyom.dao.user.UserMapper;
import com.leeyom.pojo.User;
import com.leeyom.service.user.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service("userService")
public class UserServiceImpl implements UserService {
@Autowired
UserMapper userMapper;
@Override
public User getUserById(Integer userId) {
return userMapper.selectByPrimaryKey(userId);
}
}
整个的目录如下:
下面进行测试,在ssm-web模块的的test/java目录下面,新建测试类TestMybatis.java
import com.leeyom.pojo.User;
import com.leeyom.service.user.UserService;
import org.junit.Before;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class TestMybatis {
private ApplicationContext ac = ;
private UserService userService = ;
@Before
public void before {
ac = new ClassPathXmlApplicationContext("classpath:spring/spring-mybatis.xml");
userService = (UserService) ac.getBean("userService");
}
@Test
public void testMybtis {
User user = userService.getUserById(1);
System.out.println(user.getuName + "------>" + user.getuPassword);
}
}
如果打印信息如下,说明是spring与mybatis整合成功
那其实现在就有个问题,为什么ssm-service模块可以调用到ssm-dao模块呢?这就是我们之前说的,模块之间的依赖的关系,因为ssm-service的pom文件中有依赖到ssm-dao模块,所以在ssm-service模块可以调用到ssm-dao中的类,这也就验证了我们之前的各模块的依赖关系图。
整合Spring mvc
spring 与 mybatis已经整合完毕,接下来Spring mvc的整合。
创建spring-mvc.xml配置文件
该配置文件的存放路径依旧是ssm-web模块的资源文件夹resources/spring下面,主要的内容如下:
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
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.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
配置ssm-web模块下面的web.xml文件
千万别忘记配置web.xml文件,否则的话,在实际的生产测试环境下,之前的整合都白费了,将不起作用,具体内容如下:
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">
Archetype Created Web Application
contextConfigLocation
classpath:spring/spring-mybatis.xml
encodingFilter
org.springframework.web.filter.CharacterEncodingFilter
true
encoding
UTF-8
encodingFilter
/*
org.springframework.web.context.ContextLoaderListener
org.springframework.web.util.IntrospectorCleanupListener
SpringMVC
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:spring/spring-mvc.xml
1
true
SpringMVC
/
/index.jsp
在ssm-web模块的java文件夹下面创建UserHandler.java测试handler类
@Controller
public class UserHandler {
@Autowired
UserService userService;
@RequestMapping(value = "/getUserById