Spring Boot / Spring MVC 入门实践（四）：需求记录网站的实现

浅浅的花香味﹌ 2022-07-13 14:14 107阅读 0赞

目录[(?)][Link 1][\[+\]][Link 1]

## 声明 ##

本系列文章系本人原创，欢迎转载，转载请注明出处。

本系列文章通过具体的例子，介绍如何通过[spring][] Boot来帮助简化Spring MVC开发Web Application的过程，旨在通过具体的实践，使读者能够入门利用Spring Boot开发Web Application。

对于文章中贴出的代码，本人均在本地[测试][Link 2]过，如果大家对代码有疑问，欢迎在评论区指出。如果大家发现了文章中描述不对的地方，也欢迎指出，以便大家共同进步。

## 一、需求记录网站的实现 ##

项目的源代码可以从GitHub上获取（由于GitHub上的这个项目是在本系列文章之前写的，可能会与本系列文章中的代码不完全一致，但是项目框架与用到的技术是类似的，所以在这里提供链接以供读者参考）：   
[https://github.com/linux-subscribe/simplerequirementtracker.git][https_github.com_linux-subscribe_simplerequirementtracker.git]

我们这个演示项目中，需求是按模块化分的，比如下面这个例子：   
![模块化需求的示例图][20161027212836747]   
如图，一个购物网站的建设可能包含前台和后台，而前台又可能包含页面布局和色彩样式。这样一层层下去就会得到一个树型结构，这整个树形结构就是我们一个完整的需求。   
这个树形结构中的每一个节点对应为一个[Java][]类 : Module, 在Module类中，我们定义了如下成员变量：

//树形结构中每个节点的唯一标识
        private String id;
        //父节点的id
        private String parentModuleId;
        //所有子节点id的list
        private List<String> subModuleIdList;
        private String name;
        private String description;
        private String status;
        //每个模块都有可能包含需求文档，所以我们在Module类里面加了这个attachmentPathList，来存储该模块所有文档的地址
        private List<String> attachmentPathList;
        //省略了一些常见的实现起来很简单的get/set/add/remove/equals/hashcode等方法，详情请下载项目代码。
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12
        
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12

接下来我们来看一下怎样把Module对象持久化到[数据库][Link 3]中。数据库我们使用[MongoDB][]。

和前面的章节中讲到的[MySQL][Link 3]一样，我们把MongoDB的配置存在src/main/resources/application.properties里面。（这里我们不深入讨论MongoDB的安装及配置，有兴趣的读者可以自行搜索资料安装配置，然后将下面的语句根据自己的环境作适当修改后添加到该文件中）：   
spring.data.mongodb.uri=mongodb://dba:dba@127.0.0.1:27017/srt

接下来是数据库操作的实现类：

@Repository
    public class SimpleModuleRepository implements IModuleRepository{ 
    
        @Autowired
        private MongoTemplate mongo;
    
        @Override
        public void updateModule(Module module) {
            mongo.findAndModify(Query.query(Criteria.where("id").is(module.getId())), 
                    Update.update("name", module.getName())
                        .set("description", module.getDescription())
                        .set("status", module.getStatus())
                        .set("parentModuleId", module.getParentModuleId())
                        .set("subModuleIdList", module.getSubModuleIdList())
                        .set("attachmentPathList", module.getAttachmentPathList()), 
                    Module.class);
        }
        //添加一个Module对象
        @Override
        public void addModule(Module module) {
            mongo.insert(module);   
        }
        //查找所有Module对象
        @Override
        public List<Module> getAllModules(){
            return mongo.findAll(Module.class);
        }
        //根据moduleId查找Module对象
        @Override
        public Module getModuleByModuleId(String moduleId) {
            return mongo.findById(moduleId, Module.class);
        }
        //根据moduleId删除Module对象
        @Override
        public void removeModuleByModuleId(String moduleId) {
            mongo.findAndRemove(Query.query(Criteria.where("id").is(moduleId)), Module.class);
        }
    
    }
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12
         13
         14
         15
         16
         17
         18
         19
         20
         21
         22
         23
         24
         25
         26
         27
         28
         29
         30
         31
         32
         33
         34
         35
         36
         37
         38
         39
        
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12
         13
         14
         15
         16
         17
         18
         19
         20
         21
         22
         23
         24
         25
         26
         27
         28
         29
         30
         31
         32
         33
         34
         35
         36
         37
         38
         39

可以看到，通过Spring提供的MongoTemplate，常见的增删改查操作可以很方便的完成，有兴趣的读者可以拿这个Java类和我们在之前的章节中用来向MySQL中存User信息的Java类做比较，便可看出这个类是多么的简单。   
至此，所有与MongoDB交互所要做的配置及代码便完成了。

在该网站中，用户可以通过点击“＋”来添加一个需求模块，点击“－”来删除一个需求模块，并且可以向服务器上传某个需求模块的文档，这些也是通过Spring实现的（前台使用[AngularJS][]实现的，这里不做深入探讨）。我们以添加一个需求模块为例来简要说明：

@Controller
    public class AddModuleController {
    
    
        @Autowired
        private IModuleRepository moduleRepository;
    
        @RequestMapping(value="addModule", method=RequestMethod.POST)
        //注意这里的@ResponseBody和@RequestBody
        public @ResponseBody ModuleWrapper addModule(@RequestBody Module module){
            moduleRepository.addModule(module);
            if(module.getParentModuleId()!=null && (!module.getParentModuleId().isEmpty())){
                Module parentModule=moduleRepository.getModuleByModuleId(module.getParentModuleId());
                parentModule.addSubModuleId(module.getId());
                moduleRepository.updateModule(parentModule);
            }
            return new ModuleWrapper(module);
        }
    }
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12
         13
         14
         15
         16
         17
         18
         19
        
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12
         13
         14
         15
         16
         17
         18
         19

这就是处理添加一个需求模块请求的代码，非常简单。当服务器接收到”addModule”的POST请求的时候（如：[http://localhost:8080/addModule][http_localhost_8080_addModule]，根据环境的不同URL可能会有所不同），便会执行这里的addModule方法。

这里的(@RequestBody Module module)，表示Spring会将这次请求的请求体(Request Body)转换成Java的Module对象，就是方法中的module局部变量。下面是笔者在调试时候截取的addModule请求：

{"parentModuleId":"58120062d4c6e124cb2058f3","name":"testName","description":"testDescription.","status":"testStatus"}
       
        
         1
        
       
        
         1

可以看到，请求体（Request Body）是json格式的，Spring就是把这段json转化成我们的Module对象的。

同理，@ResponseBody指出该方法的返回值作为服务器响应的响应体（Response Body），为了方便大家更好的理解，下面是笔者调试时候截取的响应：

{
        "module": { "id": "58120afcd4c6e124cb2058f7", "parentModuleId": "58120062d4c6e124cb2058f3", "subModuleIdList": null, "name": "testName", "description": "testDescription.", "status": "testStatus", "attachmentPathList": null },
        "subModuleWrapperList": null,
        "name": "testName",
        "id": "58120afcd4c6e124cb2058f7",
        "description": "testDescription.",
        "parentModuleId": "58120062d4c6e124cb2058f3",
        "subModuleIdList": null,
        "attachmentPathList": null,
        "status": "testStatus" }
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12
         13
         14
         15
         16
         17
         18
         19
        
       
        
         1
         2
         3
         4
         5
         6
         7
         8
         9
         10
         11
         12
         13
         14
         15
         16
         17
         18
         19

可以看到，响应体（Response Body）也是json格式的，我们的js脚本会在接收到这段json后进行处理，并最终将最新的信息展示在浏览器上。

## 二、总结 ##

至此，本系列所有文章便全部完结了。可以看出，Spring Boot在一定程度上减轻了开发人员的工作量，尤其是减轻了以前冗长的配置和样板式代码。由于笔者水平有限，可能有些地方讲的不是很到位，大家可以下载源码亲自调试看看，有问题的话欢迎大家在评论区指出，大家可以一起讨论一起进步。

欢迎关注我的[微信][Link 4]公众号来获取各种IT学习视频哦

![Center][]

[Link 1]: http://blog.csdn.net/import_java_any/article/details/52950705#
[spring]: http://lib.csdn.net/base/javaee
[Link 2]: http://lib.csdn.net/base/softwaretest
[https_github.com_linux-subscribe_simplerequirementtracker.git]: https://github.com/linux-subscribe/simplerequirementtracker.git
[20161027212836747]: /images/20220713/ef9d9e2d7dc94ed895f6537753f23a47.png
[Java]: http://lib.csdn.net/base/javase
[Link 3]: http://lib.csdn.net/base/mysql
[MongoDB]: http://lib.csdn.net/base/mongodb
[AngularJS]: http://lib.csdn.net/base/angularjs
[http_localhost_8080_addModule]: http://localhost:8080/addModule
[Link 4]: http://lib.csdn.net/base/wechat
[Center]: /images/20220713/064c57a42729470cb9a59cbb5e925c71.png