课程导学
我们都知道MongoDB是一款非常出色的非关系型文档数据库，你肯定会想问MongoDB这么强，我们该怎么用或者有啥运用场景呢？
MongoDB的应用场景非常多，无论是数据存储还是日志存储越来越多的公司在使用MongoDB，而我们今天也在SpringBoot基础上使用MongoDB实现一个简易版本的物流订单管理系统。
在使用前，你自己的电脑上要有IDEA编译器来创建项目，还要拥有MongoDB数据库和Studio 3T(MongoDB可视化数据库管理工具，下载地址https://studio3t.com/)。
案例分析
1.1 案例分析
我想，大部分人都应该有着购物的经历，当商品下单时就会出现一个物流单号，接下来几天内的物流信息会根据这个单号更新。
然后接下来的几天可能会到达不同地点，进行更新，你可能会好奇这样一个功能是如何实现，本案例就通过SpringBoot+MongoDB实现一个简易版本的物流订单系统。当然具体实现商用肯定要考虑很多细节也很复杂，本案例更侧重于功能实现和MongoDB使用。
1.2 核心思路拆解
一个订单数据是如何产生和更新的呢？首先一个订单数据由下单时产生，然后该订单经历各个物流点更新物流信息和订单状态，最后在用户取件之后订单状态更新后数据基本就不再更新了。
下单模块：我想大部分人看过寄快递下单流程或者自己下过单，核心就是一个表单页面填写寄件人姓名、地址、手机等信息和收件人姓名、地址、手机等信息。所以在这里具体实现也是填写寄件人和收件人信息储存。
物流模块 ：一个订单下单后可能经历若干物流地点，最终才能到达目的地被签收。而就各个物流点来看，各个物流点的管理人员对该物流订单添加一些物流信息，例如到达地址、订单目前状态、联系方式等等。而本案例在添加物流信息的实现上也通过一个表单添加该订单的物流信息，通过物流订单的id进行联立。
实现这种数据应该如何存储？如果使用关系型数据库，就单订单物流信息存储可能至少需要使用两张表来实现，一张订单(order)信息表存储订单一些固定栏位信息，一张物流(Logistics)信息表储存动态的物流变化，通过订单id实现两张表的关联。
按照E-R图设计数据库，按照我们简洁的设计方式，其数据其中一部分的数据是这样的：
物流表中的order_id外键引用order表中的id字段进行关联。在查询订单数据的时候需要关联查询。物流订单系统确实可以使用关系数据库去实现，但是数据量过大可能会有性能瓶颈需要优化，如果采用MongoDB不仅可以提高效率，还可以使得流程变得更加简单。
订单的特点是随着递送过程，订单数据需要随时更新路径。数据结构上需要可以灵活应对，这点非常符合MongoDB的document文档模型，并且MongoDB支持GIS功能，非常适用于MongoDB来支撑物流业务(这里简易版本就不使用该功能了)。而物流行业里订单比较独立，跨订单的操作很少，创建、更新(追加)的操作会较多，物流业务模型上与MongoDB非常的匹配。本课程就是使用MongoDB实现一个物流订单系统的小例子。
1.3 案例涉及知识点
SpringBoot
相信你对SpringBoot很熟悉，由于Spring的发展、微服务的发展使得SpringBoot越来越流行，已经成为JavaWeb开发的主流框架。
SpringBoot是由Pivotal团队提供的全新框架，其设计目的是用来简化新Spring应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置，从而使开发人员不再需要定义样板化的配置。通过这种方式，SpringBoot在蓬勃发展的快速应用开发领域(rapid application development)成为领导者。
简而言之，SpringBoot是当前web开发主流，其简化了Spring的配置让开发者能够更容易上手Web项目的开发。且MongdoDB能够快速与SpringBoot整合，在项目中能够快速便捷操作MongoDB；
MongoDB
MongoDB是一个基于分布式文件存储的数据库。由C++语言编写。旨在为web应用提供可扩展的高性能数据存储解决方案。MongoDB是一个介于关系型数据库和非关系型数据库之间的产品，是非关系型数据库当中功能最丰富，最像关系型数据库的。它支持的数据结构非常松散，是类似JSON的BSON格式，因此可以存储比较复杂的数据类型。MongoDB最大的特点是它支持的查询语言非常强大，其语法有点类似于面向对象的查询语言，几乎可以实现类似关系数据库单表查询的绝大部分功能，而且还支持对数据建立索引。
本案例就是基于SpringBoot和MongoDB实现一个物流订单系统的小案例，实际的物流场景需要考虑的问题肯定很多也比较复杂，这是实现一个简易版本的物流订单系统主要为了MongoDB的使用和学习。
1.4案例实现步骤
分析完案例以及了解案例设计的知识点后，就可以一步一步开始动手实现本案例，本案例要实现的就是订单创建、订单信息更新、查询、删除的一个小型完整的物流订单管理系统。而在具体实现上按照以下步骤：
- 预备工作:创建数据库和项目
- 订单添加
- 订单更新
- 订单查询
- 订单删除
整个案例实现火热运行的环境如下：
- 操作系统：Windows10
- JDK版本：JDK8
- 编译器：IDEA
- MongoDB版本：4.4.0
- MongoDB可视化管理工具：Studio 3T
实现步骤
第一步 预备工作
1.1 创建MongoDB数据库
打开Studio 3T数据库管理工具，连接本地MongoDB数据库之后，创建名为test的数据库，在test数据库中创建名为order的集合：
1.2 创建SpringBoot项目
首先，打开IDEA创建项目，选择创建SpringBoot项目：
然后在选择Gruop和Aritifact的时候分别填写com和mongodemo，Java Version选择8版本。
在勾选模块时候，这里勾选Spring web、MongoDB依赖模块，选择合适位置创建项目，项目就可以成功创建：
创建项目之后，需要做一些前置工作预备。
1.3 创建Java相关文件
创建完项目，我们需要做一些预备工作用来完成缓存。我们首先要在项目中的application.properties中添加配置连接到数据库，配置规则为：spring.data.mongodb.uri=mongodb://地址:端口/数据库名，本案例使用本地的MongoDB数据库，默认端口为27017，而使用的MongoDB具体数据库名称为test，那么就可以按照以下进行配置：
spring.data.mongodb.uri=mongodb://localhost:27017/test
这样在项目中就可以连接到本地的MongoDB的test数据库并访问。
其次在项目中com.mongodb目录下分别创建controller，service，pojo文件夹，在controller文件夹下创建orderController类，为负责url和逻辑的控制器：
package com.mongodemo.controller;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class orderController {
private static Logger logger= LoggerFactory.getLogger(orderController.class);
}
其中：
- @RestController就声明该类为一个控制器，并且每个接口返回一个JSON字符串给前端。
- Logger对象用于打印日志。在web项目中我们更倾向于使用log打印日志而不在控制台直接输出。
orderController创建完毕后，在service 文件夹下创建orderService.java类，里面先编写以下内容：
package com.mongodemo.service;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.stereotype.Service;
@Service
public class orderService {
private static Logger logger= LoggerFactory.getLogger(orderService.class);
@Autowired
MongoTemplate mongoTemplate;
}
其中：
- @Service 表示该类为一个service(事务处理)，可以被注入到其他对象中(Spring帮你管理)。
- @Autowired表示要注入对象的意思，下面紧接着被注入的对象。而MongoTemplate 就是已经封装好一个对象，一个在Spring中操作MongoDB的对象。
service创建完成，我们需要在pojo中创建logistics类和order类，分别表示具体物流信息和订单信息。其中logistics类如下，各个字段的含义请看注释：
package com.mongodemo.pojo;
import java.util.Date;
public class logistics {
private int orderId;//订单id
private String operation;//操作
private String operator;//操作员
@JsonFormat(pattern = "yyyy-MM-dd HH:mm",timezone = "GMT+8")
private Date operationTime;//操作时间
private String address;//地址
private String details;//备注细节
public logistics(){}
public logistics(int orderId,String operation, String operator, Date operationTime, String address, String details) {
this.orderId = orderId;
this.operation=operation;
this.operator = operator;
this.operationTime = operationTime;
this.address = address;
this.details = details;
}
public int getOrderId() {
return orderId;
}
public void setOrderId(int orderId) {
this.orderId = orderId;
}
public String getOperator() {
return operator;
}
public void setOperator(String operator) {
this.operator = operator;
}
public Date getOperationTime() {
return operationTime;
}
public void setOperationTime(Date operationTime) {
this.operationTime = operationTime;
}
public String getAdress() {
return address;
}
public void setAdress(String address) {
this.address = address;
}
public String getDetails() {
return details;
}
public void setDetails(String details) {
this.details = details;
}
public String getOperation() {
return operation;
}
public void setOperation(String operation) {
this.operation = operation;
}
}
order类的内容如下：
package com.mongodemo.pojo;
import java.util.Date;
import java.util.List;
public class order {
private int id;//订单id
private String status;//状态
@JsonFormat(pattern = "yyyy-MM-dd HH:mm",timezone = "GMT+8")
private Date orderTime;//下单时间
private String shipper;//发货人
private String shippingAdress;//发货地址
private long shipperPhone;//发货人手机
@JsonFormat(pattern = "yyyy-MM-dd HH:mm",timezone = "GMT+8")
private Date shipTime;//发货时间
private String recevier;//接收人
private String recevierAddress;//接收地址
private long receviePhone;//接收人号码
private Listlogistics;//物流信息
public order(int id, String status, Date orderTime, String shipper, String shippingAdress, long shipperPhone, Date shipTime, String recevier, String recevierAddress, long receviePhone, List logistics) {
this.id = id;
this.status = status;
this.orderTime = orderTime;
this.shipper = shipper;
this.shippingAdress = shippingAdress;
this.shipperPhone = shipperPhone;
this.shipTime = shipTime;
this.recevier = recevier;
this.recevierAddress = recevierAddress;
this.receviePhone = receviePhone;
this.logistics = logistics;
}
//省略get set方法，自己补全
}
其中 @JsonFormat(pattern = “yyyy-MM-dd HH:mm”,timezone = “GMT+8”)为时间类的json输出格式，供前端使用。
1.4 创建html相关文件
在static文件夹下创建index.html,addlogistics.html,addorder.html.ordermanage.html.
进入layui官网下载layui的js和css文件。解压后核心文件放到static下。到JQuery官网下载jquery-3.5.1.min.js文件，在static下创建js文件夹并把JQuery的js文件放进去，最终前端的页面会是这样的：
其中index.html文件为后台管理的主要ui页面，每个小功能的页面只需要编写对应页面即可。在index.html中编写以下内容：
打开页面后可以看到后台管理的初步页面：
左侧三个菜单分别对应创建的ordermanage.html，addorder.html，addlogistics.html三个页面。至此预备工作已经完成了，下面只需要完成具体的操作。本课程会着重讲解后端和MongoDB的部分，前端知识会简单介绍，需要深入理解还要自己多多研究。
第二步 订单添加
下单我想谁都会，每次等待物流信息的时候是不是有一种满满的期待和喜悦感呢！
咱们今天带你动手体验这份小喜悦，完成案例后想下多少单下多少单。
2.1 后端部分
首先，在orderService编写addorder函数，用来向MongoDB中添加订单。具体代码如下：
//创建订单，传来order对象
public void addorder(order order)
{
mongoTemplate.insert(order,"order");
}
上面的代码中：
插入的语句为 mongoTemplate.insert(order,"order")，第一个参数为插入的文档记录，第二个参数"order"为连接的MongoDB对应数据库下的集合(Collections)。
在orderController中编写addorder()接口，用来处理前端的请求添加订单。具体代码为：
@Autowired
orderService orderService;
@PostMapping("addorder")
public String addorder(order order)
{
order.setStatus("发货中");
order.setOrderTime(new Date());
order.setShipTime(new Date());
orderService.addorder(order);
return "添加成功";
}
上面代码中：
- @Autowired注解用来注入对象，下面的 orderService orderService就是被注入的对象，注入之后不需要手动创建对象可以直接使用(Spring帮你管理)
- @PostMapping(“addorder”) 意为声明一个post请求方式的接口，接口地址为addorder。
- public String addorder(order order)函数名随意，函数的参数可以是对应成表单的各个字段然后创建一个order对象，但这里直接创建一个order对象而前端表单传递对应名称值将直接赋值(省的再次赋值)。
- 这里为了简单实现，下单日期和发货日期都为系统当前时间，且订单状态初始默认为发货中。
2.2 前端部分
有了后端部分的支持，前端我们在addorder.html中编写以下内容，主要是一个表单向服务端发送数据和请求：
Title
写完后启动程序访问localhost:8080点击订单添加，然后在表单中填写对应内容
当然为了测试你可以再写一单，添加之后你会发现MongoDB中成功添加了订单数据，这样下单这一步就大功告成啦！
第三步 订单更新(追加订单)
创建完订单之后，无数配送公司和人员便开始配送物流，而我们在查询的时候，物流状态信息也能够时不时的刷新，具体物流信息也能得到追加。
3.1 后端部分
在后端的处理上，我们先写service，再写controller，在orderService中编写addLogisticsAndUpdateStatus()函数，主要实现更新订单的状态和订单的物流情况。具体代码为：
//更新物流
public void addLogisticsAndUpdateStatus(logistics logistics)
{
String status=logistics.getOperation();
Query query = new Query(Criteria.where("_id").is(logistics.getOrderId()));
Update update = new Update();
update.set("status", status);//更新状态
update.push("logistics",logistics);
mongoTemplate.upsert(query, update, order.class);
}
其中：
- jQuery对象来辅助我们根据条件查询待更新数据，这里的意思就是查询数据的条件为：MongoDB中_id字段为具体物流对应的订单id。
- Update对象用来设置更新的字段和数据，其set()方法用来直接更新对应字段的值，而push()方法用来向对应数组中追加数值。因为订单状态需要直接更新使用set()方法，而物流信息是由多个物流数据组成，所以需要使用push()追加到记录的后面。
- mongoTemplate.upsert(query, update, order.class)用来实现更新操作的提交，如果MongoDB中不存在该数据那么就插入到MongoDB中。
编写完orderService，在orderController中编写一个名为updateorder的接口，用来处理更新的请求和参数并执行更新的操作，具体代码为：
@PostMapping("updateorder")
public String updateorder(logistics logistics)
{
logistics.setOperationTime(new Date());
orderService.addLogisticsAndUpdateStatus(logistics);
return "添加成功";
}
同样接口类型为post类型，接收部分参数然后将物流操作时间设置为当前时间，调用orderService的addLogisticsAndUpdateStatus()方法执行更新的操作。这样后端部分就完成了。
3.2 前端部分
有了后端部分的支持，前端我们在addlogistics.html中编写以下内容，主要是一个表单向服务端发送数据和更新请求：
Title
这样，前端部分编写完成，执行程序访问localhost:8080,点击添加物流，根据1001的订单号添加物流信息。
添加之后查看MongoDB中订单状态得到更新且物流数据得到更新(追加)：
第四步 订单查询
订单的添加和修改都完成了，非常重要的查询当然不能少，不仅不能少，还要特色的展示，这里查询通过一个订单号查询对应订单的状态和物流。
4.1 后端部分
首先在orderservice中编写getOrderById()函数，用来根据订单id查询该条订单记录。具体代码为：
//通过id查询物流
public order getOrderById(int id)
{
Query query = new Query(Criteria.where("_id").is(id));
order order=mongoTemplate.findOne(query, order.class);
return order;
}
其中：
- Query对象来辅助我们实现条件查询待更新数据，这里的意思就是查询条件同样为：MongoDB中_id字段为传进来id的该条记录。
- 查询一条记录语句为：mongoTemplate.findOne(query, order.class)，第一个参数为查询的条件，第二个参数为查询结果转成Java对象的类型，它帮你自动处理。
- 如果查询多条记录即可用findAll()方法，返回的类型为List的集合类型。
写完service然后在orderController中编写getorderbyid接口用来处理用户请求和参数并调用orderService的getOrderById()方法给前端返回该order对象序列化成的json字符串。具体代码为：
@GetMapping("getorderbyid")
public order getOrderById(int id)
{
order order=orderService.getOrderById(id);
return order;
}
这样，后端部分就完成，仅需要前端渲染数据即可。
4.2 前端部分：
后端设计完成之后，需要前端来实现，在这里使用Ajax来实现交互，前端页面点击按钮JavaScript携带参数发送请求，后端查询MongoDB后返回结果给前端渲染， 而在渲染方面为了更像物流订单系统，我们使用layui的 时间轴组件，将各个物流订单数据直观性展示。
前端在ordermanage.html中编写以下内容：
Title 订单管理
其中Ajax将返回的值通过组装渲染，将带填充数据区域先设置id属性，然后用JavaScript把数据渲染到该部分，核心的思路在 search() 函数中。
启动程序，访问localhost:8080,点击订单管理，查询订单号为1001的物流情况。
利用上述添加物流信息，多添加该订单的物流信息，模拟多一些流程。查询的结果为：
第五步 订单删除
作为管理人员，可能偶尔会遇到特殊情况需要删除订单，而这种操作需求也是很有必要的，在这里实现根据id删除订单。我们在删除订单时候，一般先查询订单的一些数据和结果，然后根据查询的id删除对应的记录。
5.1 后端模块
首先在orderService中编写deleteOrderById()函数，用来根据id删除,编写getAllorder()函数，用来查询所有订单。
//根据id删除记录
public boolean deleteOrderById(int id)
{
Query query = new Query(Criteria.where("_id").is(id));
mongoTemplate.remove(query,order.class,"order");
return true;
}
//查询所有订单
public ListgetAllorder()
{
Listlist=mongoTemplate.findAll(order.class,"order");
return list;
}
其中：
- 删除的语句为 mongoTemplate.remove(query,order.class,“order”);第一个参数为待删除记录的定位条件，第二个参数为待删除数据的Java类型，第三个参数为待删除数据所在集合名称。
- 查询所有记录语句为：mongoTemplate.findAll(order.class,“order”);第一个参数为查询结果转成Java对象的类型，它帮你自动处理。第二个参数为待查询的集合。
写完service，接着在orderController中编写deletebyid接口和getallorder接口，分别用来接收处理删除订单的请求和获取所有订单的请求。
@GetMapping("deletebyid")
public String deleteById(int id)
{
orderService.deleteOrderById(id);
return "成功";
}
@GetMapping("getallorders")
public Map getAllOrder()
{
Mapmap=new HashMap<>();
List list=orderService.getAllorder();
map.put("code","0");
map.put("count",list.size());
map.put("data",list);
return map;
}
其中，getallorder接口返回一个Maplocalhost:8080/getallorders你会看到以下格式：
5.2 前端部分
我们将前端部分同样写在ordermanage.html中。在这个页面实现查询订单和管理的功能。
首先在body的div中添加表格属性，用来表示一个表格：
在body域下侧添加编辑栏的代码，是表格附属的一个编辑对象，删除的按钮就在这里。
最后，在最底层script域添加表格渲染的代码和Ajax发送请求的代码：
layui.use('table', function(){
var table = layui.table;//高版本建议把括号去掉，有的低版本，需要加()
table.render({
elem: '#ordertable'
,url: 'getallorders' //数据接口
,page: false //开启分页
,toolbar: '#toolbarDemo'
,cols: [[ //表头
{field: 'id', title: 'id', sort: true, fixed: 'left',width:80}
,{field: 'orderTime', title: '下单时间',sort:true,width:80}
,{field: 'recevierAddress', title: '收货地址'}
,{field: 'recevier', title: '收货人' ,edit:'text'}
,{field: 'receviePhone', title: '收货人手机' }
,{field: 'shippingAdress', title: '发货地址'}
,{field: 'shipper', title: '发货人'}
,{field: 'shipperPhone', title: '发货人手机'}
,{field: 'status', title: '物流状态'}
,{fixed: 'right', title:'操作', toolbar: '#barDemo', width:150}
]]
});
//头工具栏事件
//监听单元格编辑
table.on('tool(ordertable)', function(obj){
var data = obj.data;
console.log(obj)
if(obj.event === 'del'){
layer.confirm('真的删除行么', function(index){
$.ajax({
url:'deletebyid',
data: {
'id':data.id,
},
method:'GET',
traditional: true,
success:function (msg) {
layer.msg(msg);
obj.del();
},
error:function (msg) {
layer.msg(msg)
}
});
layer.close(index);
});
} else if(obj.event === 'edit'){
layer.msg(JSON.stringify("您可以直接单击单元格进行编辑"))
}
});
});
其中：
table.render为layui语法，配置数据url和格式，对应各个字段数据名称和含义，数据即可渲染。而表格最右侧删除需要对应删除的url，点击删除后访问后端的deletebyid接口，将这一行数据的id发送到后端，后端的orderController接收到该请求会调用orderService的方法删除MongoDB中对应的数据。
具体添加的位置为：
启动程序，访问localhost:8080，点击订单管理，看到查询的物流订单咱们删除id为1001:
再查看页面和MongoDB数据库，你会发现id为1001的记录被成功删除：
结语
到此，MongoDB的实战小项目——一个物流订单系统就完成啦，我想优秀的你肯定已经能够使用MongoDB “操作一顿猛如虎”！
回顾本节课程，首先是从宏观介绍了MongoDB这个非关系型数据库特点以及场景，从场景中选取一个比较适合的案例作为本课程案例—实现一个物流订单系统，紧接着带你简单分析物流订单案例逻辑以及在关系数据库和MongoDB中的不同处理方式，最后创建Springboot整合MongoDB的项目实现一个简易版本的物流订单系统！
当然，本节只是带你入门MongoDB，讲了一些比较基础的内容和简单的使用，如果需要深入学习使用MongoDB，还需要多从官网文档以及其他书籍和文章更深入学习MongoDB，它是当前非常热门的一种基于文档的非关系型数据库，是一种必须掌握的技术点，望你走的更远！下课！
到此这篇关于SpringBoot+MongoDB实现物流订单系统的代码的文章就介绍到这了,更多相关SpringBoot+MongoDB物流订单系统内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！