express-java-tools

快递业务api封装

License

License

Categories

Categories

Java Languages
GroupId

GroupId

club.mrxiao
ArtifactId

ArtifactId

express-java-tools
Last Version

Last Version

1.0.2
Release Date

Release Date

Type

Type

pom
Description

Description

express-java-tools
快递业务api封装
Project URL

Project URL

https://github.com/mr-xiaoyu/express-java-tools
Source Code Management

Source Code Management

https://github.com/mr-xiaoyu/express-java-tools

Download express-java-tools

How to add to project

<!-- https://jarcasting.com/artifacts/club.mrxiao/express-java-tools/ -->
<dependency>
    <groupId>club.mrxiao</groupId>
    <artifactId>express-java-tools</artifactId>
    <version>1.0.2</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/club.mrxiao/express-java-tools/
implementation 'club.mrxiao:express-java-tools:1.0.2'
// https://jarcasting.com/artifacts/club.mrxiao/express-java-tools/
implementation ("club.mrxiao:express-java-tools:1.0.2")
'club.mrxiao:express-java-tools:pom:1.0.2'
<dependency org="club.mrxiao" name="express-java-tools" rev="1.0.2">
  <artifact name="express-java-tools" type="pom" />
</dependency>
@Grapes(
@Grab(group='club.mrxiao', module='express-java-tools', version='1.0.2')
)
libraryDependencies += "club.mrxiao" % "express-java-tools" % "1.0.2"
[club.mrxiao/express-java-tools "1.0.2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

  • express-java-sf
  • express-java-jdl
  • express-java-common
  • express-java-spring-boot-starters

京东物流、顺丰物流api java封装

封装京东物流、顺丰物流api

主要实现了以下功能:

【1】快递下单

【2】取消下单

【3】快递轨迹查询

【4】获取打印数据


Maven 引用方式

<dependency>
  <groupId>club.mrxiao</groupId>
  <artifactId>(不同模块参考下文)</artifactId>
  <version>1.0.2</version>
</dependency>
  • 京东物流:express-java-jdl
  • 顺丰物流:express-java-sf

调用示例(顺丰)

    import club.mrxiao.common.error.ExpressErrorException;
    import club.mrxiao.sf.api.SfService;
    import club.mrxiao.sf.bean.order.*;
    import club.mrxiao.sf.test.ApiTestModule;
    import club.mrxiao.sf.util.json.SfGsonBuilder;
    import cn.hutool.core.util.IdUtil;
    import cn.hutool.log.Log;
    import cn.hutool.log.LogFactory;
    import com.google.inject.Inject;
    import org.testng.annotations.Guice;
    import org.testng.annotations.Test;
    
    import java.util.ArrayList;
    import java.util.List;
    
    @Guice(modules = ApiTestModule.class)
    public class SfOrderServiceImplTest {
    
        private final Log log = LogFactory.get(this.getClass().getName());
    
        @Inject
        private SfService sfService;
    
        @Test
        public void createOrder() throws ExpressErrorException {
    
            ContactInfo sender = new ContactInfo();
            sender.setContactType(1);
            sender.setContact("**");
            sender.setTel("***********");
            sender.setCountry("CN");
            sender.setProvince("北京市");
            sender.setCity("朝阳区");
            sender.setCounty("朝阳区");
            sender.setAddress("西坝河北里***********");
    
            ContactInfo receiver = new ContactInfo();
            receiver.setContactType(2);
            receiver.setContact("**");
            receiver.setTel("***********");
            receiver.setCountry("CN");
            receiver.setProvince("北京市");
            receiver.setCity("朝阳区");
            receiver.setCounty("朝阳区");
            receiver.setAddress("西坝河中里***********");
    
            List<ContactInfo> contactInfoList = new ArrayList<>();
            contactInfoList.add(sender);
            contactInfoList.add(receiver);
    
    
            CargoDetail cargoDetail = new CargoDetail();
            cargoDetail.setName("文件");
            cargoDetail.setCount(1);
    
            List<CargoDetail> cargoDetails = new ArrayList<>();
            cargoDetails.add(cargoDetail);
    
            CreateOrderRequest request = CreateOrderRequest.builder()
                    .language("zh-CN")
                    .orderId(IdUtil.simpleUUID())
                    .payMethod(2)
                    .remark("测试订单")
                    .contactInfoList(contactInfoList)
                    .cargoDetails(cargoDetails)
                    .build();
    
            CreateOrderResponse response = sfService.getSfOrderService().createOrder(request);
    
            log.info("【response】:\n {}", SfGsonBuilder.create().toJson(response));
    
        }
    
    
        @Test
        public void orderResp() throws ExpressErrorException {
            OrderRespRequest request = OrderRespRequest.builder()
                    .language("zh-CN")
                    .orderId("e48740c6a46d41bebdb21099be5cb946")
                    .build();
            OrderRespResponse response = sfService.getSfOrderService().orderResp(request);
            log.info("【response】:\n {}", SfGsonBuilder.create().toJson(response));
        }
    
        @Test
        public void updateOrder() throws ExpressErrorException {
            UpdateOrderRequest request = UpdateOrderRequest.builder()
                    .orderId("655f2e6ab9234b5ea327cf06e23642e6")
                    .dealType(2)
                    .build();
            UpdateOrderResponse response = sfService.getSfOrderService().updateOrder(request);
            log.info("【response】:\n {}", SfGsonBuilder.create().toJson(response));
        }
    }

Versions

Version
1.0.2
1.0.1
1.0.0