本项目专栏:
物流项目_Auc23的博客-CSDN博客
建议先看这期:
MongoDB入门之Java的利用-CSDN博客
需求分析
在项目中,会有两个作业范围,分别是机构作业范围和快递员作业范围,这两个作业范围的逻辑是同等的,就是在地图中举行画出范围,就是其作业范围。
实现分析
对于作业范围是一个由多个坐标点构成的多边形,并且必须是闭合的多边形,这个就比较适实用MongoDB来存储。
现在想一个实际需求,用户小王下了订单,如何找到属于该服务范围内的快递员呢?这个就必要利用MongoDB的$geoIntersects查询利用,其原理就是查找小王的位置坐标点与哪个多边形有交叉,这个就是为其服务的快递员。
ServiceScopeEntity
- /**
- * 服务范围实体
- */
- @Data
- @Document("sl_service_scope")
- public class ServiceScopeEntity {
- @Id
- @JsonIgnore
- private ObjectId id;
- /**
- * 业务id,可以是机构或快递员
- */
- @Indexed
- private Long bid;
- /**
- * 类型 {@link com.sl.ms.scope.enums.ServiceTypeEnum}
- */
- @Indexed
- private Integer type;
- /**
- * 多边形范围,是闭合的范围,开始经纬度与结束经纬度必须一样
- * x: 经度,y:纬度
- */
- @GeoSpatialIndexed(type = GeoSpatialIndexType.GEO_2DSPHERE)
- private GeoJsonPolygon polygon;
- private Long created; //创建时间
- private Long updated; //更新时间
- }
复制代码- /**
- * 服务类型枚举
- */
- public enum ServiceTypeEnum {
- ORGAN(1, "机构"),
- COURIER(2, "快递员");
- /**
- * 类型编码
- */
- private final Integer code;
- /**
- * 类型值
- */
- private final String value;
- ServiceTypeEnum(Integer code, String value) {
- this.code = code;
- this.value = value;
- }
- public Integer getCode() {
- return code;
- }
- public String getValue() {
- return value;
- }
- public static ServiceTypeEnum codeOf(Integer code) {
- return EnumUtil.getBy(ServiceTypeEnum::getCode, code);
- }
- }
复制代码 ScopeService
在ScopeService中主要定义了如下方法:
- 新增或更新服务范围
- 根据主键id删除数据
- 根据业务id和范例删除数据
- 根据主键查询数据
- 根据业务id和范例查询数据
- 根据坐标点查询所属的服务对象
- 根据详细地点查询所属的服务对象
- /**
- * 服务范围Service
- */
- public interface ScopeService {
- /**
- * 新增或更新服务范围
- *
- * @param bid 业务id
- * @param type 类型
- * @param polygon 多边形坐标点
- * @return 是否成功
- */
- Boolean saveOrUpdate(Long bid, ServiceTypeEnum type, GeoJsonPolygon polygon);
- /**
- * 根据主键id删除数据
- *
- * @param id 主键
- * @return 是否成功
- */
- Boolean delete(String id);
- /**
- * 根据业务id和类型删除数据
- *
- * @param bid 业务id
- * @param type 类型
- * @return 是否成功
- */
- Boolean delete(Long bid, ServiceTypeEnum type);
- /**
- * 根据主键查询数据
- *
- * @param id 主键
- * @return 服务范围数据
- */
- ServiceScopeEntity queryById(String id);
- /**
- * 根据业务id和类型查询数据
- *
- * @param bid 业务id
- * @param type 类型
- * @return 服务范围数据
- */
- ServiceScopeEntity queryByBidAndType(Long bid, ServiceTypeEnum type);
- /**
- * 根据坐标点查询所属的服务对象
- *
- * @param type 类型
- * @param point 坐标点
- * @return 服务范围数据
- */
- List<ServiceScopeEntity> queryListByPoint(ServiceTypeEnum type, GeoJsonPoint point);
- /**
- * 根据详细地址查询所属的服务对象
- *
- * @param type 类型
- * @param address 详细地址,如:北京市昌平区金燕龙办公楼传智教育总部
- * @return 服务范围数据
- */
- List<ServiceScopeEntity> queryListByPoint(ServiceTypeEnum type, String address);
- }
复制代码 ScopeController
- /**
- * 服务范围
- */
- @Api(tags = "服务范围")
- @RestController
- @RequestMapping("scopes")
- @Validated
- public class ScopeController {
- @Resource
- private ScopeService scopeService;
- /**
- * 新增或更新服务服务范围
- *
- * @return REST标准响应
- */
- @ApiOperation(value = "新增/更新", notes = "新增或更新服务服务范围")
- @PostMapping
- public ResponseEntity<Void> saveScope(@RequestBody ServiceScopeDTO serviceScopeDTO) {
- ServiceScopeEntity serviceScopeEntity = EntityUtils.toEntity(serviceScopeDTO);
- Long bid = serviceScopeEntity.getBid();
- ServiceTypeEnum type = ServiceTypeEnum.codeOf(serviceScopeEntity.getType());
- Boolean result = this.scopeService.saveOrUpdate(bid, type, serviceScopeEntity.getPolygon());
- if (result) {
- return ResponseEntityUtils.ok();
- }
- return ResponseEntityUtils.error();
- }
- /**
- * 删除服务范围
- *
- * @param bid 业务id
- * @param type 类型
- * @return REST标准响应
- */
- @ApiImplicitParams({
- @ApiImplicitParam(name = "bid", value = "业务id,可以是机构或快递员", dataTypeClass = Long.class),
- @ApiImplicitParam(name = "type", value = "类型,1-机构,2-快递员", dataTypeClass = Integer.class)
- })
- @ApiOperation(value = "删除", notes = "删除服务范围")
- @DeleteMapping("{bid}/{type}")
- public ResponseEntity<Void> delete(@NotNull(message = "bid不能为空") @PathVariable("bid") Long bid,
- @NotNull(message = "type不能为空") @PathVariable("type") Integer type) {
- Boolean result = this.scopeService.delete(bid, ServiceTypeEnum.codeOf(type));
- if (result) {
- return ResponseEntityUtils.ok();
- }
- return ResponseEntityUtils.error();
- }
- /**
- * 查询服务范围
- *
- * @param bid 业务id
- * @param type 类型
- * @return 服务范围数据
- */
- @ApiImplicitParams({
- @ApiImplicitParam(name = "bid", value = "业务id,可以是机构或快递员", dataTypeClass = Long.class),
- @ApiImplicitParam(name = "type", value = "类型,1-机构,2-快递员", dataTypeClass = Integer.class)
- })
- @ApiOperation(value = "查询", notes = "查询服务范围")
- @GetMapping("{bid}/{type}")
- public ResponseEntity<ServiceScopeDTO> queryServiceScope(@NotNull(message = "bid不能为空") @PathVariable("bid") Long bid,
- @NotNull(message = "type不能为空") @PathVariable("type") Integer type) {
- ServiceScopeEntity serviceScopeEntity = this.scopeService.queryByBidAndType(bid, ServiceTypeEnum.codeOf(type));
- return ResponseEntityUtils.ok(EntityUtils.toDTO(serviceScopeEntity));
- }
- /**
- * 地址查询服务范围
- *
- * @param type 类型,1-机构,2-快递员
- * @param address 详细地址,如:北京市昌平区金燕龙办公楼传智教育总部
- * @return 服务范围数据列表
- */
- @ApiImplicitParams({
- @ApiImplicitParam(name = "type", value = "类型,1-机构,2-快递员", dataTypeClass = Integer.class),
- @ApiImplicitParam(name = "address", value = "详细地址,如:北京市昌平区金燕龙办公楼传智教育总部", dataTypeClass = String.class)
- })
- @ApiOperation(value = "地址查询服务范围", notes = "地址查询服务范围")
- @GetMapping("address")
- public ResponseEntity<List<ServiceScopeDTO>> queryListByAddress(@NotNull(message = "type不能为空") @RequestParam("type") Integer type,
- @NotNull(message = "address不能为空") @RequestParam("address") String address) {
- List<ServiceScopeEntity> serviceScopeEntityList = this.scopeService.queryListByPoint(ServiceTypeEnum.codeOf(type), address);
- return ResponseEntityUtils.ok(EntityUtils.toDTOList(serviceScopeEntityList));
- }
- /**
- * 位置查询服务范围
- *
- * @param type 类型,1-机构,2-快递员
- * @param longitude 经度
- * @param latitude 纬度
- * @return 服务范围数据列表
- */
- @ApiImplicitParams({
- @ApiImplicitParam(name = "type", value = "类型,1-机构,2-快递员", dataTypeClass = Integer.class),
- @ApiImplicitParam(name = "longitude", value = "经度", dataTypeClass = Double.class),
- @ApiImplicitParam(name = "latitude", value = "纬度", dataTypeClass = Double.class)
- })
- @ApiOperation(value = "位置查询服务范围", notes = "位置查询服务范围")
- @GetMapping("location")
- public ResponseEntity<List<ServiceScopeDTO>> queryListByAddress(@NotNull(message = "type不能为空") @RequestParam("type") Integer type,
- @NotNull(message = "longitude不能为空") @RequestParam("longitude") Double longitude,
- @NotNull(message = "latitude不能为空") @RequestParam("latitude") Double latitude) {
- List<ServiceScopeEntity> serviceScopeEntityList = this.scopeService.queryListByPoint(ServiceTypeEnum.codeOf(type), new GeoJsonPoint(longitude, latitude));
- return ResponseEntityUtils.ok(EntityUtils.toDTOList(serviceScopeEntityList));
- }
- }
复制代码 实现接口
- @Slf4j
- @Service
- public class ScopeServiceImpl implements ScopeService {
- @Resource
- private MongoTemplate mongoTemplate;
- @Resource
- private EagleMapTemplate eagleMapTemplate;
- @Override
- public Boolean saveOrUpdate(Long bid, ServiceTypeEnum type, GeoJsonPolygon polygon) {
- Query query = Query.query(Criteria.where("bid").is(bid).and("type").is(type.getCode())); //构造查询条件
- ServiceScopeEntity serviceScopeEntity = this.mongoTemplate.findOne(query, ServiceScopeEntity.class);
- if (ObjectUtil.isEmpty(serviceScopeEntity)) {
- //新增
- serviceScopeEntity = new ServiceScopeEntity();
- serviceScopeEntity.setBid(bid);
- serviceScopeEntity.setType(type.getCode());
- serviceScopeEntity.setPolygon(polygon);
- serviceScopeEntity.setCreated(System.currentTimeMillis());
- serviceScopeEntity.setUpdated(serviceScopeEntity.getCreated());
- } else {
- //更新
- serviceScopeEntity.setPolygon(polygon);
- serviceScopeEntity.setUpdated(System.currentTimeMillis());
- }
- try {
- this.mongoTemplate.save(serviceScopeEntity);
- return true;
- } catch (Exception e) {
- log.error("新增/更新服务范围数据失败! bid = {}, type = {}, points = {}", bid, type, polygon.getPoints(), e);
- }
- return false;
- }
- @Override
- public Boolean delete(String id) {
- Query query = Query.query(Criteria.where("id").is(new ObjectId(id))); //构造查询条件
- return this.mongoTemplate.remove(query, ServiceScopeEntity.class).getDeletedCount() > 0;
- }
- @Override
- public Boolean delete(Long bid, ServiceTypeEnum type) {
- Query query = Query.query(Criteria.where("bid").is(bid).and("type").is(type.getCode())); //构造查询条件
- return this.mongoTemplate.remove(query, ServiceScopeEntity.class).getDeletedCount() > 0;
- }
- @Override
- public ServiceScopeEntity queryById(String id) {
- return this.mongoTemplate.findById(new ObjectId(id), ServiceScopeEntity.class);
- }
- @Override
- public ServiceScopeEntity queryByBidAndType(Long bid, ServiceTypeEnum type) {
- Query query = Query.query(Criteria.where("bid").is(bid).and("type").is(type.getCode())); //构造查询条件
- return this.mongoTemplate.findOne(query, ServiceScopeEntity.class);
- }
- @Override
- public List<ServiceScopeEntity> queryListByPoint(ServiceTypeEnum type, GeoJsonPoint point) {
- Query query = Query.query(Criteria.where("polygon").intersects(point)
- .and("type").is(type.getCode()));
- return this.mongoTemplate.find(query, ServiceScopeEntity.class);
- }
- @Override
- public List<ServiceScopeEntity> queryListByPoint(ServiceTypeEnum type, String address) {
- //根据详细地址查询坐标
- GeoResult geoResult = this.eagleMapTemplate.opsForBase().geoCode(ProviderEnum.AMAP, address, null);
- Coordinate coordinate = geoResult.getLocation();
- return this.queryListByPoint(type, new GeoJsonPoint(coordinate.getLongitude(), coordinate.getLatitude()));
- }
- }
复制代码 测试
- package com.sl.ms.scope.service;
- import com.sl.ms.scope.entity.ServiceScopeEntity;
- import com.sl.ms.scope.enums.ServiceTypeEnum;
- import org.junit.jupiter.api.Test;
- import org.springframework.boot.test.context.SpringBootTest;
- import org.springframework.data.geo.Point;
- import org.springframework.data.mongodb.core.geo.GeoJsonPoint;
- import org.springframework.data.mongodb.core.geo.GeoJsonPolygon;
- import javax.annotation.Resource;
- import java.util.Arrays;
- import java.util.List;
- @SpringBootTest
- public class ScopeServiceTest {
- @Resource
- private ScopeService scopeService;
- @Test
- void saveOrUpdate() {
- List<Point> pointList = Arrays.asList(new Point(116.340064,40.061245),
- new Point(116.347081,40.061836),
- new Point(116.34751,40.05842),
- new Point(116.342446,40.058092),
- new Point(116.340064,40.061245));
- Boolean result = this.scopeService.saveOrUpdate(2L, ServiceTypeEnum.ORGAN, new GeoJsonPolygon(pointList));
- System.out.println(result);
- }
- @Test
- void testQueryListByPoint() {
- GeoJsonPoint point = new GeoJsonPoint(116.344828,40.05911);
- List<ServiceScopeEntity> serviceScopeEntities = this.scopeService.queryListByPoint(ServiceTypeEnum.ORGAN, point);
- serviceScopeEntities.forEach(serviceScopeEntity -> System.out.println(serviceScopeEntity));
- }
- @Test
- void testQueryListByPoint2() {
- String address = "北京市昌平区金燕龙办公楼";
- List<ServiceScopeEntity> serviceScopeEntities = this.scopeService.queryListByPoint(ServiceTypeEnum.ORGAN, address);
- serviceScopeEntities.forEach(serviceScopeEntity -> System.out.println(serviceScopeEntity));
- }
- }
复制代码
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |