init

sl-express-ms-track-service/src/main/java/com/sl/TrackApplication.java

@@ -0,0 +1,15 @@
+package com.sl;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.cloud.openfeign.EnableFeignClients;
+
+@EnableFeignClients
+@SpringBootApplication
+public class TrackApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(TrackApplication.class, args);
+    }
+
+}

sl-express-ms-track-service/src/main/java/com/sl/ms/track/controller/TrackController.java

@@ -0,0 +1,84 @@
+package com.sl.ms.track.controller;
+
+import com.sl.ms.track.domain.dto.TrackDTO;
+import com.sl.ms.track.entity.TrackEntity;
+import com.sl.ms.track.service.TrackService;
+import com.sl.ms.track.util.TrackEntityUtil;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiImplicitParams;
+import io.swagger.annotations.ApiOperation;
+import org.springframework.web.bind.annotation.*;
+
+import javax.annotation.Resource;
+import java.util.List;
+
+@RestController
+@Api(tags = "轨迹管理")
+@RequestMapping("track")
+public class TrackController {
+
+    @Resource
+    private TrackService trackService;
+
+    @PostMapping
+    @ApiOperation(value = "创建轨迹", notes = "创建轨迹，会完成路线规划")
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "transportOrderId", value = "运单号", required = true)
+    })
+    public boolean create(@RequestParam("transportOrderId") String transportOrderId) {
+        return this.trackService.create(transportOrderId);
+    }
+
+    @PutMapping("complete")
+    @ApiOperation(value = "完成轨迹", notes = " 完成轨迹，修改为完成状态")
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "transportOrderIds", value = "运单号列表", required = true)
+    })
+    public boolean complete(@RequestParam("transportOrderIds") List<String> transportOrderIds) {
+        return this.trackService.complete(transportOrderIds);
+    }
+
+    /**
+     * 通过运单号查询轨迹
+     *
+     * @param transportOrderId 运单号
+     * @return 轨迹数据
+     */
+    @GetMapping("{transportOrderId}")
+    @ApiOperation(value = "查询轨迹", notes = "通过运单号查询轨迹")
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "transportOrderId", value = "运单号", required = true)
+    })
+    public TrackDTO queryByTransportOrderId(@PathVariable("transportOrderId") String transportOrderId) {
+        TrackEntity trackEntity = this.trackService.queryByTransportOrderId(transportOrderId);
+        return TrackEntityUtil.toDTO(trackEntity);
+    }
+
+    @PutMapping("upload/truck")
+    @ApiOperation(value = "车辆上报位置", notes = "车辆上报位置")
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "transportTaskId", value = "运输任务id", required = true),
+            @ApiImplicitParam(name = "lng", value = "经度", required = true),
+            @ApiImplicitParam(name = "lat", value = "纬度", required = true),
+    })
+    public boolean uploadFromTruck(@RequestParam("transportTaskId") Long transportTaskId,
+                                   @RequestParam("lng") double lng,
+                                   @RequestParam("lat") double lat) {
+        return this.trackService.uploadFromTruck(transportTaskId, lng, lat);
+    }
+
+    @PutMapping("upload/courier")
+    @ApiOperation(value = "快递员上报位置", notes = "快递员上报位置")
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "transportOrderIds", value = "运单号列表", required = true),
+            @ApiImplicitParam(name = "lng", value = "经度", required = true),
+            @ApiImplicitParam(name = "lat", value = "纬度", required = true),
+    })
+    public boolean uploadFromCourier(@RequestParam("transportOrderIds") List<String> transportOrderIds,
+                                     @RequestParam("lng") double lng,
+                                     @RequestParam("lat") double lat) {
+        return this.trackService.uploadFromCourier(transportOrderIds, lng, lat);
+    }
+
+}

sl-express-ms-track-service/src/main/java/com/sl/ms/track/entity/TrackEntity.java

@@ -0,0 +1,69 @@
+package com.sl.ms.track.entity;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.sl.ms.track.domain.enums.TrackStatusEnum;
+import com.sl.ms.track.domain.enums.TrackTypeEnum;
+import lombok.Data;
+import org.bson.types.ObjectId;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.mongodb.core.geo.GeoJsonLineString;
+import org.springframework.data.mongodb.core.geo.GeoJsonPoint;
+import org.springframework.data.mongodb.core.index.Indexed;
+import org.springframework.data.mongodb.core.mapping.Document;
+
+/**
+ * 轨迹数据
+ *
+ * @author zzj
+ * @version 1.0
+ */
+@Data
+@Document("sl_track")
+public class TrackEntity {
+
+    @Id
+    @JsonIgnore
+    private ObjectId id;
+
+    /**
+     * 运单id
+     */
+    @Indexed
+    private String transportOrderId;
+
+    /**
+     * 规划的轨迹坐标点线（通过地图服务商规划出来的轨迹点）
+     */
+    private GeoJsonLineString planGeoJsonLine;
+
+    /**
+     * 距离，单位：米
+     */
+    private Double distance;
+
+    /**
+     * 最新的位置坐标，x：经度，y：纬度
+     */
+    private GeoJsonPoint lastPoint;
+
+    /**
+     * 状态
+     */
+    private TrackStatusEnum status;
+
+    /**
+     * 类型
+     */
+    private TrackTypeEnum type;
+
+    /**
+     * 创建时间
+     */
+    private Long created;
+
+    /**
+     * 更新时间
+     */
+    private Long updated;
+
+}

sl-express-ms-track-service/src/main/java/com/sl/ms/track/enums/TrackExceptionEnum.java

@@ -0,0 +1,50 @@
+package com.sl.ms.track.enums;
+
+import cn.hutool.core.util.EnumUtil;
+import com.sl.transport.common.enums.BaseExceptionEnum;
+
+/**
+ * 异常枚举
+ *
+ * @author zzj
+ * @version 1.0
+ */
+public enum TrackExceptionEnum implements BaseExceptionEnum {
+
+    TRACK_ALREADY_EXISTS(1001, "轨迹已经存在");
+
+    private Integer code;
+    private Integer status;
+    private String value;
+
+    TrackExceptionEnum(Integer code, String value) {
+        this.code = code;
+        this.value = value;
+        this.status = 500;
+    }
+
+    TrackExceptionEnum(Integer code, Integer status, String value) {
+        this.code = code;
+        this.value = value;
+        this.status = status;
+    }
+
+    @Override
+    public Integer getCode() {
+        return this.code;
+    }
+
+    @Override
+    public String getValue() {
+        return this.value;
+    }
+
+    @Override
+    public Integer getStatus() {
+        return this.status;
+    }
+
+    public static TrackExceptionEnum codeOf(Integer code) {
+        return EnumUtil.getBy(TrackExceptionEnum::getCode, code);
+    }
+}

sl-express-ms-track-service/src/main/java/com/sl/ms/track/mq/MQListener.java

@@ -0,0 +1,57 @@
+package com.sl.ms.track.mq;
+
+import com.sl.ms.track.service.TrackService;
+import com.sl.transport.common.constant.Constants;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.amqp.core.ExchangeTypes;
+import org.springframework.amqp.rabbit.annotation.Exchange;
+import org.springframework.amqp.rabbit.annotation.Queue;
+import org.springframework.amqp.rabbit.annotation.QueueBinding;
+import org.springframework.amqp.rabbit.annotation.RabbitListener;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.Resource;
+
+/**
+ * 消息处理
+ *
+ * @author zzj
+ * @version 1.0
+ */
+@Slf4j
+@Component
+public class MQListener {
+
+    @Resource
+    private TrackService trackService;
+
+    /**
+     * 创建运单后创建轨迹
+     *
+     * @param msg 消息
+     */
+    @RabbitListener(bindings = @QueueBinding(
+            value = @Queue(name = Constants.MQ.Queues.TRACK_TRANSPORT_ORDER_CREATED),
+            exchange = @Exchange(name = Constants.MQ.Exchanges.TRANSPORT_ORDER_DELAYED, type = ExchangeTypes.TOPIC, delayed = Constants.MQ.DELAYED),
+            key = Constants.MQ.RoutingKeys.TRANSPORT_ORDER_CREATE
+    ))
+    public void listenTransportOrderCreatedMsg(String msg) {
+        log.info("接收到新增运单的消息 ({})-> {}", Constants.MQ.Queues.TRACK_TRANSPORT_ORDER_CREATED, msg);
+        //TODO 实战完成
+    }
+
+    /**
+     * 运单签收后完成轨迹
+     *
+     * @param msg 消息
+     */
+    @RabbitListener(bindings = @QueueBinding(
+            value = @Queue(name = Constants.MQ.Queues.TRACK_TRANSPORT_ORDER_UPDATE_STATUS),
+            exchange = @Exchange(name = Constants.MQ.Exchanges.TRANSPORT_ORDER_DELAYED, type = ExchangeTypes.TOPIC, delayed = Constants.MQ.DELAYED),
+            key = Constants.MQ.RoutingKeys.TRANSPORT_ORDER_UPDATE_STATUS_PREFIX + "RECEIVED"
+    ))
+    public void listenTransportOrderUpdateStatusMsg(String msg) {
+        log.info("接收到更新运单状态的消息 ({})-> {}", Constants.MQ.Queues.TRACK_TRANSPORT_ORDER_UPDATE_STATUS, msg);
+        //TODO 实战完成
+    }
+}

sl-express-ms-track-service/src/main/java/com/sl/ms/track/service/TrackService.java

@@ -0,0 +1,60 @@
+package com.sl.ms.track.service;
+
+import com.sl.ms.track.entity.TrackEntity;
+
+import java.util.List;
+
+/**
+ * 轨迹服务
+ *
+ * @author zzj
+ * @version 1.0
+ */
+public interface TrackService {
+
+
+    /**
+     * 创建轨迹，会完成路线规划
+     *
+     * @param transportOrderId 运单号
+     * @return 是否成功
+     */
+    boolean create(String transportOrderId);
+
+    /**
+     * 完成轨迹，修改为完成状态
+     *
+     * @param transportOrderIds 运单号列表
+     * @return 是否成功
+     */
+    boolean complete(List<String> transportOrderIds);
+
+    /**
+     * 通过运单号查询轨迹
+     *
+     * @param transportOrderId 运单号
+     * @return 轨迹数据
+     */
+    TrackEntity queryByTransportOrderId(String transportOrderId);
+
+    /**
+     * 车辆上报位置
+     *
+     * @param transportTaskId 运输任务id
+     * @param lng             经度
+     * @param lat             纬度
+     * @return 是否成功
+     */
+    boolean uploadFromTruck(Long transportTaskId, double lng, double lat);
+
+    /**
+     * 快递员上报位置
+     *
+     * @param transportOrderIds 运单号列表
+     * @param lng               经度
+     * @param lat               纬度
+     * @return 是否成功
+     */
+    boolean uploadFromCourier(List<String> transportOrderIds, double lng, double lat);
+
+}

sl-express-ms-track-service/src/main/java/com/sl/ms/track/util/TrackEntityUtil.java

@@ -0,0 +1,41 @@
+package com.sl.ms.track.util;
+
+import cn.hutool.core.bean.BeanUtil;
+import cn.hutool.core.bean.copier.CopyOptions;
+import com.sl.ms.track.domain.dto.MarkerPointDTO;
+import com.sl.ms.track.domain.dto.TrackDTO;
+import com.sl.ms.track.entity.TrackEntity;
+import com.sl.transport.common.util.ObjectUtil;
+import org.springframework.data.mongodb.core.geo.GeoJsonLineString;
+import org.springframework.data.mongodb.core.geo.GeoJsonPoint;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * @author zzj
+ * @version 1.0
+ */
+public class TrackEntityUtil {
+
+    public static TrackDTO toDTO(TrackEntity trackEntity) {
+        CopyOptions copyOptions = CopyOptions.create().setIgnoreProperties("planGeoJsonLine", "lastPoint").ignoreNullValue();
+        TrackDTO trackDTO = BeanUtil.toBean(trackEntity, TrackDTO.class, copyOptions);
+        //转化轨迹点
+        GeoJsonLineString planGeoJsonLine = trackEntity.getPlanGeoJsonLine();
+        if (ObjectUtil.isAllNotEmpty(planGeoJsonLine, planGeoJsonLine.getCoordinates())) {
+            List<MarkerPointDTO> coordinateList = planGeoJsonLine.getCoordinates().stream()
+                    .map(point -> new MarkerPointDTO(point.getX(), point.getY()))
+                    .collect(Collectors.toList());
+            trackDTO.setPointList(coordinateList);
+        }
+
+        //转化最新位置坐标
+        if (ObjectUtil.isNotEmpty(trackEntity.getLastPoint())) {
+            GeoJsonPoint point = trackEntity.getLastPoint();
+            trackDTO.setLastPoint(new MarkerPointDTO(point.getX(), point.getY()));
+        }
+        return trackDTO;
+    }
+
+}

sl-express-ms-track-service/src/main/resources/banner.txt

@@ -0,0 +1,7 @@
+
+       _                                                     ${spring.application.name} ${application.version}
+  ___ | |         ___ __  __ _ __   _ __  ___  ___  ___      Port: ${server.port}
+ / __|| | _____  / _ \\ \/ /| '_ \ | '__|/ _ \/ __|/ __|     Pid: ${pid}  Profile(s): ${AnsiColor.GREEN}${spring.profiles.active}${AnsiColor.DEFAULT}
+ \__ \| ||_____||  __/ >  < | |_) || |  |  __/\__ \\__ \
+ |___/|_|        \___|/_/\_\| .__/ |_|   \___||___/|___/     https://sl-express.itheima.net/
+                            |_|

sl-express-ms-track-service/src/main/resources/bootstrap-local.yml

@@ -0,0 +1,28 @@
+server:
+  port: 18097
+  tomcat:
+    uri-encoding: UTF-8
+    threads:
+      max: 1000
+      min-spare: 30
+spring:
+  cloud:
+    nacos:
+      username: nacos
+      password: nacos
+      server-addr: 192.168.150.101:8848
+      discovery:
+        namespace: ecae68ba-7b43-4473-a980-4ddeb6157bdc
+        ip: 192.168.150.1
+      config:
+        namespace: ecae68ba-7b43-4473-a980-4ddeb6157bdc
+        shared-configs: #共享配置
+          - data-id: shared-spring-mongodb.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-eaglemap.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-rabbitmq.yml
+            group: SHARED_GROUP
+            refresh: false

sl-express-ms-track-service/src/main/resources/bootstrap-prod.yml

@@ -0,0 +1,27 @@
+server:
+  port: 18097
+  tomcat:
+    uri-encoding: UTF-8
+    threads:
+      max: 1000
+      min-spare: 30
+spring:
+  cloud:
+    nacos:
+      username: nacos
+      password: vO5/dZ9,iL
+      server-addr: nacos-service.yjy-public-slwl-java-prod.svc.cluster.local:8848
+      discovery:
+        namespace: 92312ba8-1119-440f-81af-c29618df303b
+      config:
+        namespace: 92312ba8-1119-440f-81af-c29618df303b
+        shared-configs: #共享配置
+          - data-id: shared-spring-mongodb.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-eaglemap.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-rabbitmq.yml
+            group: SHARED_GROUP
+            refresh: false

sl-express-ms-track-service/src/main/resources/bootstrap-stu.yml

@@ -0,0 +1,27 @@
+server:
+  port: 18097
+  tomcat:
+    uri-encoding: UTF-8
+    threads:
+      max: 1000
+      min-spare: 30
+spring:
+  cloud:
+    nacos:
+      username: nacos
+      password: nacos
+      server-addr: 192.168.150.101:8848
+      discovery:
+        namespace: ecae68ba-7b43-4473-a980-4ddeb6157bdc
+      config:
+        namespace: ecae68ba-7b43-4473-a980-4ddeb6157bdc
+        shared-configs: #共享配置
+          - data-id: shared-spring-mongodb.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-eaglemap.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-rabbitmq.yml
+            group: SHARED_GROUP
+            refresh: false

sl-express-ms-track-service/src/main/resources/bootstrap-test.yml

@@ -0,0 +1,27 @@
+server:
+  port: 18097
+  tomcat:
+    uri-encoding: UTF-8
+    threads:
+      max: 1000
+      min-spare: 30
+spring:
+  cloud:
+    nacos:
+      username: nacos
+      password: nacos
+      server-addr: nacos-service.yjy-public-slwl-java.svc.cluster.local:8848
+      discovery:
+        namespace: 92312ba8-1119-440f-81af-c29618df303b
+      config:
+        namespace: 92312ba8-1119-440f-81af-c29618df303b
+        shared-configs: #共享配置
+          - data-id: shared-spring-mongodb.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-eaglemap.yml
+            group: SHARED_GROUP
+            refresh: false
+          - data-id: shared-spring-rabbitmq.yml
+            group: SHARED_GROUP
+            refresh: false

sl-express-ms-track-service/src/main/resources/bootstrap.yml

@@ -0,0 +1,25 @@
+application:
+  version: v1.0
+logging:
+  config: classpath:logback-spring.xml
+spring:
+  main:
+    allow-circular-references: true #允许bean循环依赖
+  application:
+    name: sl-express-ms-track
+  profiles:
+    active: local
+  mvc:
+    pathmatch:
+      #解决异常：swagger Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
+      #因为Springfox使用的路径匹配是基于AntPathMatcher的，而Spring Boot 2.6.X使用的是PathPatternMatcher
+      matching-strategy: ant_path_matcher
+sl:
+  swagger:
+    package-path: com.sl.ms.track.controller
+    title: 神领物流 - 车辆轨迹微服务接口文档
+    description: 提供查询车辆轨迹、上报坐标位置等相关服务。
+    contact-name: 传智教育·研究院
+    contact-url: http://www.itcast.cn/
+    contact-email: yjy@itcast.cn
+    version: ${application.version}

sl-express-ms-track-service/src/main/resources/logback-spring.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--scan: 当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true。-->
+<!--scanPeriod: 设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。当scan为true时，此属性生效。默认的时间间隔为1分钟。-->
+<!--debug: 当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。-->
+<configuration debug="false" scan="false" scanPeriod="60 seconds">
+    <springProperty scope="context" name="appName" source="spring.application.name"/>
+    <!--文件名-->
+    <property name="logback.appname" value="${appName}"/>
+    <!--文件位置-->
+    <property name="logback.logdir" value="/data/logs"/>
+
+    <!-- 定义控制台输出 -->
+    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
+        <layout class="ch.qos.logback.classic.PatternLayout">
+            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} - [%thread] - %-5level - %logger{50} - %msg%n</pattern>
+        </layout>
+    </appender>
+
+    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
+            <level>DEBUG</level>
+        </filter>
+        <File>${logback.logdir}/${logback.appname}/${logback.appname}.log</File>
+        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
+            <FileNamePattern>${logback.logdir}/${logback.appname}/${logback.appname}.%d{yyyy-MM-dd}.log.zip</FileNamePattern>
+            <maxHistory>90</maxHistory>
+        </rollingPolicy>
+        <encoder>
+            <charset>UTF-8</charset>
+            <pattern>%d [%thread] %-5level %logger{36} %line - %msg%n</pattern>
+        </encoder>
+    </appender>
+
+    <!--evel:用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF，-->
+    <!--不能设置为INHERITED或者同义词NULL。默认是DEBUG。-->
+    <root level="INFO">
+        <appender-ref ref="stdout"/>
+    </root>
+</configuration>