当前位置：首页 > news >正文

SpringBoot整合API接口做快递智能识别

news 2025/5/2 0:34:14

第一步阿里云订阅快递服务

第二步整合springBoot将接口调通

原有的代码

改造后的代码

第三步对接前端进行渲染效果

后台

controller

servie

serviceImpl

前台

template部分

script部分

style部分

最终效果

第一步阿里云订阅快递服务

登录以后点击云市场找到对应的接口

找到一个免费的点击进去

点击免费使用

购买后点击这个买家控制台去看详情

点击进去api接口中

复制java代码到你的项目中，其他的也可以看一下成功的响应和失败的响应等

这个address代表入参参数

第二步整合springBoot将接口调通

原有的代码

  public static void main(String[] args) {String host = "https://kzaddress2.market.alicloudapi.com";String path = "/api/address/parse";String method = "POST";String appcode = "你自己的AppCode";Map<String, String> headers = new HashMap<String, String>();//最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105headers.put("Authorization", "APPCODE " + appcode);//根据API的要求，定义相对应的Content-Typeheaders.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");Map<String, String> querys = new HashMap<String, String>();Map<String, String> bodys = new HashMap<String, String>();bodys.put("address", "赵王17267365647秀洲区王江泾镇南元丰大道82282700");try {/*** 重要提示如下:* HttpUtils请从* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java* 下载** 相应的依赖请参照* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml*/HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);System.out.println(response.toString());//获取response的body//System.out.println(EntityUtils.toString(response.getEntity()));} catch (Exception e) {e.printStackTrace();}}

改造后的代码

将代码拆分，先拆分一个config有助于管理，读取配置文件，这样可以提高代码的可读性，也可以方便后期的管理

package com.macro.mall.portal.config;import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;/*** @Author：xsp* @Description:* @name：ApiConfig* @Date：2024/10/22 22:29*/
@Data
@Component
@ConfigurationProperties(prefix = "api")
public class ApiConfig {private String host;private String path;private String method;private String appcode;
}

在这里面我们需要改一下appcode吗

api:host: https://kzaddress2.market.alicloudapi.compath: /api/address/parsemethod: POSTappcode: 你的appcode码

回到买家控制台找到你的appcode码改一下

然后工具类改成这样交给spring容器管理，用的时候直接注入就行了

package com.macro.mall.portal.util;import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONObject;
import com.macro.mall.model.UmsMemberReceiveAddress;
import com.macro.mall.portal.config.ApiConfig;
import org.apache.http.HttpResponse;
import org.apache.http.util.EntityUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;import java.util.HashMap;
import java.util.Map;/*** @Author：xsp* @Description:* @name：AddreInfoUtils* @Date：2024/10/22 22:26*/
@Component
public class AddressInfoUtils {@Autowiredprivate ApiConfig apiConfig;public UmsMemberReceiveAddress getAddressInfo(String address){UmsMemberReceiveAddress umsMemberReceiveAddress = new UmsMemberReceiveAddress();String host = apiConfig.getHost();String path = apiConfig.getPath();String method = apiConfig.getMethod();String appcode = apiConfig.getAppcode();Map<String, String> headers = new HashMap<String, String>();//最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105headers.put("Authorization", "APPCODE " + appcode);//根据API的要求，定义相对应的Content-Typeheaders.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");Map<String, String> querys = new HashMap<String, String>();Map<String, String> bodys = new HashMap<String, String>();bodys.put("address", address);try {HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);System.out.println(response.toString());String s = EntityUtils.toString(response.getEntity());JSONObject jsonObject = JSON.parseObject(s);Integer code = jsonObject.getInteger("code");if(code==200){JSONObject data = jsonObject.getJSONObject("data");if(data!=null){umsMemberReceiveAddress.setDetailAddress(data.getString("detail"));umsMemberReceiveAddress.setCity(data.getString("city"));umsMemberReceiveAddress.setProvince(data.getString("province"));umsMemberReceiveAddress.setRegion(data.getString("area"));umsMemberReceiveAddress.setPostCode(data.getString("zipCode"));umsMemberReceiveAddress.setName(data.getString("name"));umsMemberReceiveAddress.setPhoneNumber(data.getString("mobile"));return umsMemberReceiveAddress;}}} catch (Exception e) {e.printStackTrace();}return null;}}

在这里我也是封装一个对象用于接收返回的快递智能识别信息

package com.macro.mall.model;import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;import java.io.Serializable;
@Data
public class UmsMemberReceiveAddress implements Serializable {private Long id;private Long memberId;@Schema(title = "收货人名称")private String name;private String phoneNumber;@Schema(title = "是否为默认")private Integer defaultStatus;@Schema(title = "邮政编码")private String postCode;@Schema(title = "省份/直辖市")private String province;@Schema(title = "城市")private String city;@Schema(title = "区")private String region;@Schema(title = "详细地址(街道)")private String detailAddress;}

接下来开始测试了

 @Autowiredprivate AddressInfoUtils addressInfoUtils;@Operation(summary = "根据地址获取快递信息")@GetMapping(value = "/getAddressInfo")public UmsMemberReceiveAddress getAddressInfo() {UmsMemberReceiveAddress addressInfo=addressInfoUtils.getAddressInfo("赵王17267365647秀洲区王江泾镇南元丰大道82282700");return addressInfo;}

这样就表示成功了