zl程序教程

您现在的位置是:首页 >  后端

当前栏目

SSM(十) 项目重构-互联网项目的Maven结构

2023-09-27 14:21:20 时间

前言

很久没有更新博客了,之前定下周更逐渐成了月更。怎么感觉像我追过的一部动漫。 这个博文其实很早就想写了。 之前所有的代码都是在一个模块里面进行开发,这和maven的理念是完全不相符的,最近硬是抽了一个时间来对项目的结构进行了一次重构。

互联网项目的maven.jpg

先来看看这次重构之后的目录结构

1.jpg

为什么需要分模块

至于为什么要分模块呢?

我们设想一个这样的场景: 在现在的互联网开发中,会把一个很大的系统拆分成各个子系统用于降低他们之间的耦合度。

在一个子项目中通常都会为API、WEB、Service等模块。 而且当项目够大时,这些通常都不是一个人能完成的工作,需要一个团队来各司其职。

想象一下:当之前所有的项目都在一个模块的时候,A改动了API,需要Deploy代码。而B也改动了service的代码,但并没有完全做完。所以A在提交build的时候就会报错

而且在整个项目足够大的时候,这个build的时间也是很影响效率的。

但让我将各个模块之间分开之后效果就不一样了。我修改了API我就只需要管我的就行,不需要整个项目进行build。

而且当有其他项目需要依赖我这个API的时候也只需要依赖API即可,不用整个项目都依赖过去。

各个模块的作用

来看下这次我所分的模块。

这是整个项目的根节点。 先看一下其中的pom.xml:


groupId com.crossoverJie /groupId        artifactId SSM /artifactId        packaging pom /packaging        version 2.0.0 /version        modules            module SSM-API /module            module SSM-BOOT /module            module SSM-SERVICE /module            module SSM-WEB /module        /modules        properties            project.build.sourceEncoding UTF-8 /project.build.sourceEncoding            spring.version 4.1.4.RELEASE /spring.version            jackson.version 2.5.0 /jackson.version            lucene.version 6.0.1 /lucene.version        /properties        dependencyManagement            dependencies                dependency                    groupId com.crossoverJie /groupId                    artifactId SSM-API /artifactId                    version 2.0.0 /version                /dependency             /dependencies        /dependencyManagement  

我截取了其中比较重点的配置。

由于这是父节点,所以我的packag类型使用的是pom。 其中分别有着四个子模块。

其中重点看下 dependencyManagement 这个标签。 如果使用的是IDEA这个开发工具的话是可以看到如下图:

2.jpg

标红的有一个向下的箭头,点一下就可以进入子模块中相同的依赖。 这样子模块就不需要配置具体的版本了,统一由父模块来进行维护,对之后的版本升级也带来了好处。

SSM-API

接下来看下API这个模块:

通常这个模块都是用于定义外部接口的,以及改接口所依赖的一些DTO类。 一般这个模块都是拿来给其他项目进行依赖,并和本项目进行数据交互的。

SSM-BOOT

BOOT这个模块比较特殊。 可以看到这里没有任何代码,只有一个rpc的配置文件。 通常这个模块是用于给我们内部项目进行依赖的,并不像上面的API模块一样给其他部门或者是项目进行依赖的。

因为在我们的RPC调用的时候,用dubbo来举例,是需要配置所依赖的consumer。

但如果是我们自己内部调用的话我们就可以把需要调用自己的dubbo服务提供者配置在这里,这样的话我们自己调用就只需要依赖这个BOOT就可以进行调用了。

哦对了,BOOT同时还会依赖API,这样才实现了只依赖BOOT就可以调用自己内部的dubbo服务了。 如下所示:


dependencies            dependency                groupId junit /groupId                artifactId junit /artifactId                scope test /scope            /dependency            dependency                groupId com.crossoverJie /groupId                artifactId SSM-API /artifactId            /dependency        /dependencies   SSM-SERVICE

SERVICE模块就比较好理解了。 是处理具体业务逻辑的地方,也是对之前的API的实现。

通常这也是一个web模块,所以我的pom类型是WAR。

SSM-WEB

其实WEB模块和SERVICE模块有点重合了。通常来说这个模块一般在一个对外提供http访问接口的项目中。

这里只是为了展示项目结构,所以也写在了这里。

他的作用和service差不多,都是WAR的类型。

这次没有实现什么特别的功能,只是对一些还没有接触过这种项目结构开发的童鞋能起到一些引导作用。

具体源码还请关注我的github。

项目地址:https://github.com/crossoverJie/SSM.git

个人博客地址:http://crossoverjie.top

GitHub地址:https://github.com/crossoverJie


1.jpg

为什么需要分模块

至于为什么要分模块呢?

我们设想一个这样的场景: 在现在的互联网开发中,会把一个很大的系统拆分成各个子系统用于降低他们之间的耦合度。

在一个子项目中通常都会为API、WEB、Service等模块。 而且当项目够大时,这些通常都不是一个人能完成的工作,需要一个团队来各司其职。

想象一下:当之前所有的项目都在一个模块的时候,A改动了API,需要Deploy代码。而B也改动了service的代码,但并没有完全做完。所以A在提交build的时候就会报错

而且在整个项目足够大的时候,这个build的时间也是很影响效率的。

但让我将各个模块之间分开之后效果就不一样了。我修改了API我就只需要管我的就行,不需要整个项目进行build。

而且当有其他项目需要依赖我这个API的时候也只需要依赖API即可,不用整个项目都依赖过去。

各个模块的作用

来看下这次我所分的模块。

这是整个项目的根节点。 先看一下其中的pom.xml:

 groupId com.crossoverJie /groupId artifactId SSM /artifactId packaging pom /packaging version 2.0.0 /version modules module SSM-API /module module SSM-BOOT /module module SSM-SERVICE /module module SSM-WEB /module /modules properties project.build.sourceEncoding UTF-8 /project.build.sourceEncoding spring.version 4.1.4.RELEASE /spring.version jackson.version 2.5.0 /jackson.version lucene.version 6.0.1 /lucene.version /properties dependencyManagement dependencies dependency groupId com.crossoverJie /groupId artifactId SSM-API /artifactId version 2.0.0 /version /dependency /dependencies /dependencyManagement 

我截取了其中比较重点的配置。

由于这是父节点,所以我的packag类型使用的是pom。 其中分别有着四个子模块。

其中重点看下 dependencyManagement 这个标签。 如果使用的是IDEA这个开发工具的话是可以看到如下图:

2.jpg

标红的有一个向下的箭头,点一下就可以进入子模块中相同的依赖。 这样子模块就不需要配置具体的版本了,统一由父模块来进行维护,对之后的版本升级也带来了好处。

SSM-API

接下来看下API这个模块:

通常这个模块都是用于定义外部接口的,以及改接口所依赖的一些DTO类。 一般这个模块都是拿来给其他项目进行依赖,并和本项目进行数据交互的。

SSM-BOOT

BOOT这个模块比较特殊。 可以看到这里没有任何代码,只有一个rpc的配置文件。 通常这个模块是用于给我们内部项目进行依赖的,并不像上面的API模块一样给其他部门或者是项目进行依赖的。

因为在我们的RPC调用的时候,用dubbo来举例,是需要配置所依赖的consumer。

但如果是我们自己内部调用的话我们就可以把需要调用自己的dubbo服务提供者配置在这里,这样的话我们自己调用就只需要依赖这个BOOT就可以进行调用了。

哦对了,BOOT同时还会依赖API,这样才实现了只依赖BOOT就可以调用自己内部的dubbo服务了。 如下所示:

 dependencies dependency groupId junit /groupId artifactId junit /artifactId scope test /scope /dependency dependency groupId com.crossoverJie /groupId artifactId SSM-API /artifactId /dependency /dependencies 
SSM-SERVICE

SERVICE模块就比较好理解了。 是处理具体业务逻辑的地方,也是对之前的API的实现。

通常这也是一个web模块,所以我的pom类型是WAR。

SSM-WEB

其实WEB模块和SERVICE模块有点重合了。通常来说这个模块一般在一个对外提供http访问接口的项目中。

这里只是为了展示项目结构,所以也写在了这里。

他的作用和service差不多,都是WAR的类型。

这次没有实现什么特别的功能,只是对一些还没有接触过这种项目结构开发的童鞋能起到一些引导作用。


作者:crossoverJie

来源:51CTO


一文搞懂Java项目工程管理神器——Maven 在日常的Java项目开发当中,构建一个通用、合理、统一的项目工程框架,一直是很多程序员头疼的事情。 要解决这个问题,我们就不得不提到Maven这个Java工具了。 本文会详细分享Maven,并在文章内分享代码实例。
Mybatis学习(一):Maven工程部署Mybatis项目 MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程,换句话说就是补了JDBC的坑,让操作数据库变得更方便。