搭建SSM项目框架全过程及思考

朱雀 2022-05-23 11:19 247阅读 0赞

## 1.前言 ##

之前都是在现有框架下进行写代码或者总是看一些别人的架构，总会眼高手低。于是打算自己完整的走一遍流程，同时把所遇到的问题，思考的问题记下来，供大家参考。由于是工作年限不高，属于新手，不足之处还请各位大牛指正。

项目选用Spring为基础框架，由于目前项目中采用的是Hibernate（在多表关联查询方面以及复杂的统计计算方面，同时要兼顾性能的时候吃了不少苦头），所以这里采取Mybatis做持久化框架（没实战搭建过），Spring MVC框架。在权限控制方面现有项目中采用的是shiro（为了学习，这里使用spring security）。其他的细节问题会在下面各小节中叙述。

另说明一点的是操作系统是mac。

github项目源码在[https://github.com/sjlian/sjlian][https_github.com_sjlian_sjlian] 欢迎clone并提出意见。

## 2. 创建mvn项目、完善目录结构 ##

首先安装和配置环境，主要包括jdk、mysql、maven等，其他如redis、nginx、ActiveMQ等在初始版本还暂时没上传和使用。这些入门知识不再赘述。

在idea上新建一个mvn项目，然后有一个create from archetype，里面有很多选项，于是有个疑问到底用哪个呢？遂逐一查看名字，看到mvn-archetypr-webapp，听名字就觉得和自己的预期是一样的啊，于是果断选择。期间又试了下其他的各个archetype，发现这这是一个模板，可以根据自己需要选择，也可以默认缺省的。这里附上mvn官方标准化的目录结构如下图：

![1111994-20170713115515431-737369753.png][]

一个好的程序员都善于用命令行的方式解决问题，于是思考怎么用mvn命令行创建项目。最简单的方式就是mvn archetype:generate，这个命令是默认的 archetype，如果需要生成特定模板的项目呢？从maven的Repository里查找arche types发现有几百个，我们平时用的也就那么几个，由于太多就变得很不方便起来，于是搜索资料，查到 [http://maven.40175.n5.nabble.com/archetype-catalog-xml-location-archetype-crawl-versus-archetype-generate-td113741.html][http_maven.40175.n5.nabble.com_archetype-catalog-xml-location-archetype-crawl-versus-archetype-generate-td113741.html]

![1111994-20170713122753931-240847733.png][]

完善目录结构大致如上图（是demo最终版本），这个时候只需要在java目录下新建几个包，进行分层，使项目结构变得清晰。

common主要放置一些通用的非工具类，如exception相关，结果相关，拦截器，servlet，VO类等。

Controller、DAO、model、service顾名思义，分别是控制层、持久层、数据模型层、业务处理层。

util主要存放各种工具类，例如字符串、时间、poi、邮件、ip等

resource主要是配置文件，包括spring相关配置文件、mybatis配置文件、mybatis映射文件、日志配置文件等

web-inf下最重要是web.xml，作为启动需要首先加载的文件，引入其他配置文件、配置listener、servlet、filter、Interceptor等。

其他是和前端相关文件

test是和测试相关。

建好以上目录，开始进入正题。

## 　3. 引入Spring ##

### 　　3.1 web.xml ###

web程序启动会去读取它的配置文件 web.xml，首先需要配置web.xml，添加上spring的监听器、spring mvc的Servlet。

ContextLoaderListener 它实现了ServletContextListener这个接口，在web.xml配置这个监听器，启动容器时，就会默认执行它实现的方法。在ContextLoaderListener中关联了ContextLoader这个类，所以整个加载配置过程由ContextLoader来完成。

RequestContextListener implements ServletRequestListener，监听用户的请求，用于日志系统，不是必需的。

IntrospectorCleanupListener监听器主要用于解决java.beans.Introspector导致的内存泄漏的问题(Quartz,Struts)，如果没有struts和quartz不是必需的。

Spring MVC 以自启动servlet的形式加载，同时引入相关spring/spring-mvc.xml配置文件。文件路径classpath:开头,从classpath加载,否则尝试URL,如果失败,调用 getResourceByPath。

![1111994-20170713135149150-1394475692.png][]

此外，为了防止中文乱码，需要encodingFilter；设置session超时时间、用户自定义Listener、servlet、filter、interceptor等。

### 　　3.2 pom.xml ###

直接把Listener复制到xml中，会发现ide并不识别，是因为相关依赖还没有导入项目中的原因。 在pom.xml中引入spring相关，引入的时候会发现depency有一些属性值，如groupId、artifactId等，对于开源项目来说，这两项是固定的，按照文档导入即可，version是版本号，为了便于升级和管理，建议版本号统一配置。

![1111994-20170713135022165-1559401496.png][]

![1111994-20170713135255462-19399971.png][]

有时候会发现还有scope属性，如junit的scope属性值是test用于test任务时使用；compile(default)编译时使用；provided类似于编译但支持你期待jdk或者容器提供，类似于classpath；runtime在执行时需要使用；system需要外在提供相应得元素。通过systemPath来取得；

有时候会遇到依赖冲突，例如同时导入了A、B包，但是A包又引用了B包，当版本不一致时就会冲突，解决方式是mvn dependency:tree 分析冲突的包，然后在相应的A包中配置<exclusions> 把B包排除在外。

如果想引入本地依赖，1、使用scope system和systemPath指向依赖包；2、mvn install命令进行安装并配置group和artifact，然后直接引入。3、建立pom依赖关系。POM关系主要为依赖，继承，合成，在这个小项目中用不到，且不是重点，故略去。

### 　　3.3 其他配置文件 ###

spring-mvc.xml主要配置如下。

1.开启注解模式就可以使用注解方式@ResponseBody,@RequestMapping等。

2.对于静态的jpg、css等不需要通过mvc。

3.添加前后缀，注意路径。

4.扫描controller的bean，让spring知道哪些是controller（@Controller）。

![1111994-20170713144146087-1893954490.png][]

如果需要对返回值进行json统一化处理，在这里可以引入json处理，如fastJson、jackson等。fastJson轻量级速度快，但是支持有轻微漏洞，jackson灵活性好，但是比较笨重，这里选用的是fastJson，配置如下。

![1111994-20170713144851181-1658207814.png][]

如果需要上传文件，还需要配置文件上传，如下：

![1111994-20170713144954853-1546004378.png][]

web.xml中引入配置文件，该配置文件作为spring基础配置文件，再引入其他文件。

![1111994-20170713145120790-1843320478.png][]

spring.xml中配置如下,这里注入service、引入mybatis、security配置，配置事务管理、开启声明是式事务（@transtraction）。

![1111994-20170713145231368-702933432.png][]

## 　4.引入Mybatis ##

### 　　4.1 文件配置 ###

在spring.xml中引入了spring-mybatis.xml，用于Mybatis和spring的整合配置。同时pom.xml中引入相关依赖。

1.配置数据源，数据库连接池，可以选择的有c3p0、druid、dbcp、HikariCP等，这里选择阿里的开源框架druid,配置如下。url、username等建议写在property文件中。

![1111994-20170713150112931-1107617296.png][]

2. 配置sessionFactory, 引入mybatis全局配置文件、entity使用别名，扫描mapping.xml

3. 配置DAO接口，注入Srping容器中。

![1111994-20170713162717493-1149976814.png][]

4. 配置mybatis-config.xml

![1111994-20170713163128368-374997804.png][]

## 　5. mvc层搭建 ##

### 　　5.1 DAO层 ###

由于mybatis不支持jpa，不能由实体映射数据表，所以需要自己新建数据表和数据实体。

可以使用工具由数据表生成数据实体。

数据实体在model目录下。

映射文件在resources/mapper下，如果设置了自动转换对象关系名，这里不在需要配置对象关系的名称映射，但是需要注意命名的书写，注意namespace一致。

DAO接口文件在dao目录下，DAO实现在mapper的xml中，select/update id和接口中的方法对应即可。在service注入dao的时候会提示无法注入的错误，忽略即可。

### 　　5.2 service层 ###

在service下定义接口，在service/impl/下定义实现，加上@Service注解

### 　　5.3 Controller层 ###

在Controller目录下，可以实现封装好的json数据、string连接、ModelAndView。

## 　6. DEMO完善 ##

### 　　5.1 加入日志系统 ###

log4j,配置log4j.properties。如下

![1111994-20170713170622447-1223112575.png][]

然后可以利用filter做请求参数日志输出。

利用aop做一些其他日志输入。

### 　　5.2 封装统一化返回值 ###

前后端json数据交互，自定义ResponseResult，包括头信息（状态码，错误信息说明，异常），数据信息。

异常通过@ControllerAdvice 捕获到然后封装处理返回给前端，不至于页面报错，或者自定义异常弹窗。

### 　　5.3 工具类准备 ###

各种工具类提取

### 　　5.4 权限控制 ###

使用spring security，目前还是半成品，以后完善。

### 　　5.5 其他处理 ###

![1111994-20170714100557712-508235895.png][]

![1111994-20170714100328134-1628770521.png][]

我有一个微信公众号，经常会分享一些Java技术相关的干货；如果你喜欢我的分享，可以用微信搜索“Java团长”或者“javatuanzhang”关注。

[https_github.com_sjlian_sjlian]: https://github.com/sjlian/sjlian
[1111994-20170713115515431-737369753.png]: /images/20220523/0cc1e828443542b8a6de5f93a2d03876.png
[http_maven.40175.n5.nabble.com_archetype-catalog-xml-location-archetype-crawl-versus-archetype-generate-td113741.html]: http://maven.40175.n5.nabble.com/archetype-catalog-xml-location-archetype-crawl-versus-archetype-generate-td113741.html
[1111994-20170713122753931-240847733.png]: /images/20220523/6028be8d59e14d23914b02820daa7233.png
[1111994-20170713135149150-1394475692.png]: /images/20220523/d78f8d4edf0a4066bb593d10f1d98828.png
[1111994-20170713135022165-1559401496.png]: /images/20220523/cae7b4c0ab244d588f016bf8d6920a3e.png
[1111994-20170713135255462-19399971.png]: /images/20220523/319ef0f37c994068b1ff5a148f400e2a.png
[1111994-20170713144146087-1893954490.png]: /images/20220523/87c67bb03fb74111af9ce2b167dadc38.png
[1111994-20170713144851181-1658207814.png]: /images/20220523/2008d9ff359c4479970c98d071c687cc.png
[1111994-20170713144954853-1546004378.png]: /images/20220523/6afe5f40513845b0ad3df815b5d300d5.png
[1111994-20170713145120790-1843320478.png]: /images/20220523/d16f55b072c8432eb2722fa301c3358a.png
[1111994-20170713145231368-702933432.png]: /images/20220523/5edeb597303740cf91c6358b855b6025.png
[1111994-20170713150112931-1107617296.png]: /images/20220523/6a66d8a493d843058579e363064bf841.png
[1111994-20170713162717493-1149976814.png]: /images/20220523/29ed509319c04401a20185187eb5bcc6.png
[1111994-20170713163128368-374997804.png]: /images/20220523/68b2a62ca6af4e90afc51ff42b23194d.png
[1111994-20170713170622447-1223112575.png]: /images/20220523/f5c018314ea642b59fd730e393d255f2.png
[1111994-20170714100557712-508235895.png]: /images/20220523/5fae1ae4b2ac421eac8442b140ee0ec2.png
[1111994-20170714100328134-1628770521.png]: /images/20220523/1c0544626d054325965a70c1faa440e8.png