龙空技术网

IntelliJ IDEA + Maven 的多模块Spring MVC + Spring + Mybatis项目骨架

程序猿久一 132

前言:

当前小伙伴们对“idea jsp插件”大体比较关切,小伙伴们都想要知道一些“idea jsp插件”的相关资讯。那么小编也在网摘上网罗了一些有关“idea jsp插件””的相关资讯,希望同学们能喜欢,你们一起来学习一下吧!

优质文章,及时送达

我想大多数做 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划分模块。

以上的讲解是参考:

项目结构项目整体目录

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标签段,完整的如下:

<modelVersion>4.0.0</modelVersion>

<groupId>com.leeyom.ssm</groupId>

<artifactId>ssm-common</artifactId>

<version>1.0-SNAPSHOT</version>

<packaging>jar</packaging>

<properties>

<!--编译级别-->

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

<maven.compiler.source>1.8</maven.compiler.source>

<maven.compiler.target>1.8</maven.compiler.target>

<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>

</properties>

完整源码地址在公众号后台回复「多模块」获取。

由于该模块是共有的依赖的,也就是说其他的模块可能会用到,所以需要将他添加到父级pom的dependencies中去。

1. 创建ssm-pojo模块,该模块主要存放实体类,不需要依赖其他的模块,处理方式和ssm-common大致相似。

2. 创建ssm-dao模块,由于该模块需要跟数据库打交道,所以跟数据库相关的依赖,应该放到该模块的pom文件中,同时该模块依赖于ssm-pojo模块进行数据库实体映射,如下所示:

<dependencies>

<!--添加 ssm-pojo module依赖-->

<dependency>

<groupId>com.leeyom.ssm</groupId>

<artifactId>ssm-pojo</artifactId>

<version>1.0-SNAPSHOT</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>${mybatis-spring.version}</version>

</dependency>

<!-- Mysql数据库链接jar包 -->

<dependency>

<groupId>mysql</groupId>

<artifactId>mysql-connector-java</artifactId>

<version>${mysql-connector.version}</version>

<scope>runtime</scope>

</dependency>

<!-- mybatis分页插件 -->

<dependency>

<groupId>com.github.pagehelper</groupId>

<artifactId>pagehelper</artifactId>

<version>${pagehelper.version}</version>

</dependency>

<!--阿里巴巴德鲁伊数据库连接池-->

<dependency>

<groupId>com.alibaba</groupId>

<artifactId>druid</artifactId>

<version>${druid.version}</version>

</dependency>

</dependencies>

3. 创建ssm-service模块,该模块主要用于处理业务逻辑,需要依赖ssm-dao模块和数据库打交道,同时还需要在此处继承父级的依赖,实现事务管理,自动装配等等:

<parent>

<artifactId>ssm</artifactId>

<groupId>com.leeyom.ssm</groupId>

<version>1.0-SNAPSHOT</version>

</parent>

<modelVersion>4.0.0</modelVersion>

<artifactId>ssm-service</artifactId>

<packaging>jar</packaging>

<properties>

<!--编译级别-->

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

<maven.compiler.source>1.8</maven.compiler.source>

<maven.compiler.target>1.8</maven.compiler.target>

<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>

</properties>

<dependencies>

<!--添加 ssm-dao module依赖-->

<dependency>

<groupId>com.leeyom.ssm</groupId>

<artifactId>ssm-dao</artifactId>

<version>1.0-SNAPSHOT</version>

</dependency>

</dependencies>

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的核心配置文件,事务管理,数据源,自动扫描都是在这里配置,具体的详情,可以看配置文件里面的注释。

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns=""

xmlns:xsi=""

xmlns:context=""

xsi:schemaLocation="

">

<!-- 自动扫描 -->

<context:component-scan base-package="com.leeyom"/>

<!-- 引入配置文件 -->

<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">

<property name="location" value="classpath:jdbc.properties"/>

</bean>

<!--使用阿里巴巴的德鲁伊数据源-->

<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">

<!-- 基本属性 url、user、password -->

<property name="url" value="${jdbc.url}"/>

<property name="username" value="${jdbc.username}"/>

<property name="password" value="${jdbc.password}"/>

<!-- 配置初始化大小、最小、最大 -->

<property name="initialSize" value="1"/>

<property name="minIdle" value="1"/>

<property name="maxActive" value="20"/>

<!-- 配置获取连接等待超时的时间 -->

<property name="maxWait" value="60000"/>

<!-- 配置间隔多久才进行一次检测,检测需要关闭的空闲连接,单位是毫秒 -->

<property name="timeBetweenEvictionRunsMillis" value="60000"/>

<!-- 配置一个连接在池中最小生存的时间,单位是毫秒 -->

<property name="minEvictableIdleTimeMillis" value="300000"/>

<property name="validationQuery" value="SELECT 'x'"/>

<property name="testWhileIdle" value="true"/>

<property name="testOnBorrow" value="false"/>

<property name="testOnReturn" value="false"/>

<!-- 打开PSCache,并且指定每个连接上PSCache的大小 -->

<property name="poolPreparedStatements" value="true"/>

<property name="maxPoolPreparedStatementPerConnectionSize" value="20"/>

<!-- 配置监控统计拦截的filters -->

<property name="filters" value="stat"/>

</bean>

<!-- spring和MyBatis整合 -->

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">

<property name="dataSource" ref="dataSource"/>

<!--mybatis分页插件-->

<property name="configLocation" value="classpath:spring/mybatis-config.xml"></property>

<!-- 自动扫描mapping.xml文件 -->

<property name="mapperLocations" value="classpath:mapper/*.xml"></property>

</bean>

<!-- DAO接口所在包名,Spring会自动查找其下的类 -->

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">

<property name="basePackage" value="com.leeyom.dao"/>

<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>

</bean>

<!-- 事务管理 -->

<bean id="transactionManager"

class="org.springframework.jdbc.datasource.DataSourceTransactionManager">

<property name="dataSource" ref="dataSource"/>

</bean>

<tx:annotation-driven />

</beans>

创建mybatis-config.xml分页插件配置文件

mybatis分页插件PaheHelper是一个非常好用的分页插件,也可以通过配置文件的形式整合到mybatis中,具体怎么使用可以参考我以前写的文章:mybatis 分页插件PageHelper使用及总结。

具体的配置如下:

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE configuration

PUBLIC "-//mybatis.org//DTD Config 3.0//EN"

"">

<configuration>

<settings>

<setting name="mapUnderscoreToCamelCase" value="true" />

</settings>

<!-- 配置分页插件 -->

<plugins>

<plugin interceptor="com.github.pagehelper.PageHelper">

<!-- 指定数据库方言 -->

<property name="dialect" value="mysql" />

</plugin>

</plugins>

</configuration>

创建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下面,主要的内容如下:

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns=""

xmlns:xsi=""

xmlns:context=""

xmlns:mvc=""

xsi:schemaLocation=" ">

<!-- 自动装配 -->

<context:component-scan base-package="com.leeyom.controller" use-default-filters="false">

<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>

<context:include-filter type="annotation" expression="org.springframework.web.bind.annotation.ControllerAdvice"/>

</context:component-scan>

<!--视图解析器-->

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

<!--前缀-->

<property name="prefix" value="/WEB-INF/"/>

<!--后缀-->

<property name="suffix" value=".jsp"></property>

</bean>

<!-- 文件上传 -->

<bean id="multipartResolver"

class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

<!-- 默认编码 -->

<property name="defaultEncoding" value="utf-8"/>

<!-- 文件大小最大值 -->

<property name="maxUploadSize" value="10485760000"/>

<!-- 内存中的最大值 -->

<property name="maxInMemorySize" value="40960"/>

</bean>

<!--启用该标签代表 spring mvc 不拦截css、js、jpg等相关的静态资源-->

<mvc:default-servlet-handler/>

<!-- 启用spring mvc 注解 -->

<mvc:annotation-driven></mvc:annotation-driven>

</beans>

配置ssm-web模块下面的web.xml文件

千万别忘记配置web.xml文件,否则的话,在实际的生产测试环境下,之前的整合都白费了,将不起作用,具体内容如下:

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns:xsi=""

xmlns=""

xsi:schemaLocation=" "

version="3.0">

<display-name>Archetype Created Web Application</display-name>

<!-- Spring和mybatis的配置文件 -->

<context-param>

<param-name>contextConfigLocation</param-name>

<param-value>classpath:spring/spring-mybatis.xml</param-value>

</context-param>

<!-- 编码过滤器 -->

<filter>

<filter-name>encodingFilter</filter-name>

<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>

<async-supported>true</async-supported>

<init-param>

<param-name>encoding</param-name>

<param-value>UTF-8</param-value>

</init-param>

</filter>

<filter-mapping>

<filter-name>encodingFilter</filter-name>

<url-pattern>/*</url-pattern>

</filter-mapping>

<!-- Spring监听器 -->

<listener>

<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>

</listener>

<!-- 防止Spring内存溢出监听器 -->

<listener>

<listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>

</listener>

<!-- Spring MVC -->

<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:spring/spring-mvc.xml</param-value>

</init-param>

<load-on-startup>1</load-on-startup>

<async-supported>true</async-supported>

</servlet>

<servlet-mapping>

<servlet-name>SpringMVC</servlet-name>

<url-pattern>/</url-pattern>

</servlet-mapping>

<welcome-file-list>

<welcome-file>/index.jsp</welcome-file>

</welcome-file-list>

</web-app>

在ssm-web模块的java文件夹下面创建UserHandler.java测试handler类

@Controller

public class UserHandler {

@Autowired

UserService userService;

@RequestMapping(value = "/getUserById", method = {RequestMethod.POST, RequestMethod.GET})

public String getUserById(HttpServletRequest request, Model model) {

//参数

Integer userId = StringUtils.not(request.getParameter("userId")) ? Integer.parseInt(request.getParameter("userId")) : 1;

User user = userService.getUserById(userId);

model.addAttribute("user", user);

return "test";

}

}

在ssm-web模块的WEB-INF文件夹下面创建test.jsp页面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

<title>测试spring mvc</title>

</head>

<body>

<h1> hello world! </h1> ${user.uName}

</body>

</html>

经过以上的准备,我们现在就可以编译整个项目,编译的结果如下,就说明编译成功,否则就是编译失败。

通过整个项目的编译,ssm-common,ssm-pojo,ssm-dao,ssm-service分别被达成jar,ssm-web被打包成war,最后我们就是要把war通过tomcat容器跑起来。

访问localhost:8089/ssm-demo/getUserById?userId=1,如果页面出现如下的熟悉界面,恭喜你,三大框架整合成功!!!

总结

到此为止我们Maven的多模块 Spring MVC + Spring + Mybatis 项目的搭建就已经完成,后期就可以在此基础上添加更多的功能。写这篇文章的目的是看到很多的单模块的ssm项目的搭建,却很少看到多模块的ssm项目搭建,所以就在此抛砖迎玉,重新搭建了一番,中间如果有什么不懂的,或者我写的不对的,大家都可以讨论。如果你觉得有用,就帮忙点个star吧!源码地址在公众号 Java后端 后台回复「多模块」获取。

-END-

如果看到这里,说明你喜欢这篇文章,请 转发、点赞。同时 标星(置顶)本公众号可以第一时间接受到博文推送。

1. Nginx 从入门到实践,万字详解!我用一根网线攻击了舍友!3.Spring Boot+Redis 实现接口自动幂等Typora 终于支持图片上传了!

标签: #idea jsp插件