hutool优雅实现发送请求以及响应解析

背景

    平常的开发中经常会遇到调用三方接口的需求,实现方法可以说五花八门，考虑项目规范以及便于维护,最好使用统一的请求发送工具,hutool中的HttpUtil就是一个不错的选择.对常见的get、post请求都已经进行了完整封装。下面结合具体的业务请求说一下如何使用，看一下请求发送是否够香够顺滑！
    首先贴一下hutool的官方依赖以及官方文档:

            <dependency>
                <groupId>cn.hutool</groupId>
                <artifactId>hutool-all</artifactId>
                <version>5.2.4</version>
            </dependency>

    官方文档地址:hutool官方链接

get请求

    微信公众平台中的接口基本上都需要权限认证，接口中都需要传递access_token,所以获取access_token就是第一步操作.下面官方给出的获取方式:

好,下面就说明如何发送请求以及如何进行解析:
    使用到的请求方式:HttpUtil.get("请求链接")
    字符串拼接方式:StrUtil.format("拼接字符串模板", "参数1", "参数2");写法要比直接用+拼接更加优雅,另外日志打印也可以使用此方式!
    响应参数解析方式:

JSONObject resultJsonObject = JSONUtil.parseObj("响应信息");
String "响应信息values"= responseJsonObject.getStr("响应信息key");

业务实现:

// 获取微信公众平台的accessToken
 public String getWxgAccessToken() {
        String appid="公众号appid信息";
        String wxgSecret="公众号秘钥信息";
        // 拼接请求链接
        String requestUrl = StrUtil.format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={}&secret={}", appid, wxgSecret);
        // 发送请求
        String returnMsg = HttpUtil.get(requestUrl);
        JSONObject responseJsonObject = JSONUtil.parseObj(returnMsg);
        if(ObjectUtil.isNull(responseJsonObject)) throw new Exception("响应异常:获取信息为空!");
        String accessToken = responseJsonObject.getStr("access_token");
        return accessToken;
    }

Post请求

    微信公众号中的服务号是支持给用户发送消息信息,现在有消息发送接口,官方文档如下:


    此需求中要求发送post请求,请求参数上要有access_token,其余请求信息放到请求体中,具体的实现方式如下(偷懒直接把官方组装的格式复制了一下):

	// 发送模板消息
    public void sendWxgTemplateMessage() {

        // 组装消息内容
        String touser="";  // 接收者openId
        String templateId=""; // 模板id
        String url="";       // 跳转路径(小程序之外)
        String appid="";  // 小程序appid
        String pagepath="";  // 小程序跳转路径
        String client_msg_id="";  // 防重入id
        String first="岗位申请成功!";  // 副标题
        String keyword1="";  // 关键词1
        String remark="祝你面试成功!";  // 备注
        String value="销售精英";  // 信息
        String color="";  // 颜色
        String messageStr="{\n" +
                "           \"touser\":"+touser+",\n" +
                "           \"template_id\":"+templateId+",\n" +
                "           \"url\":"+url+",  \n" +
                "           \"miniprogram\":{\n" +
                "             \"appid\":"+appid+",\n" +
                "             \"pagepath\":"+pagepath+"\n" +
                "           },\n" +
                "           \"client_msg_id\":\"MSG_000001\",\n" +
                "           \"data\":{\n" +
                "                   \"first\": {\n" +
                "                       \"value\":"+first+",\n" +
                "                       \"color\":\"#173177\"\n" +
                "                   },\n" +
                "                   \"keyword1\":{\n" +
                "                       \"value\":"+value+",\n" +
                "                       \"color\":\"#173177\"\n" +
                "                   },\n" +
                "                   \"keyword2\": {\n" +
                "                       \"value\":\"39.8元\",\n" +
                "                       \"color\":\"#173177\"\n" +
                "                   },\n" +
                "                   \"keyword3\": {\n" +
                "                       \"value\":\"2014年9月22日\",\n" +
                "                       \"color\":\"#173177\"\n" +
                "                   },\n" +
                "                   \"remark\":{\n" +
                "                       \"value\":"+remark+",\n" +
                "                       \"color\":\"#173177\"\n" +
                "                   }\n" +
                "           }\n" +
                "       }";

        // 发送消息
        String accessToken="accessToken";
        // 发送请求
        String returnMsg = HttpUtil.post(StrUtil.format("https://api.weixin.qq.com/cgi-bin/message/template/send?access_token={}", accessToken), messageStr);
        // 请求参数解析
        JSONObject jsonObject = JSONUtil.parseObj(returnMsg);
        // 获取errmsg,判断消息发送是否成功
        String errmsg = jsonObject.getStr("errmsg");
        if(!StrUtil.equals("ok",errmsg)) throw new Exception("消息发送失败!");
    }

    以上是常见请求hutool的调用方式,平常项目开发中如果没有特殊要求还是使用封装好的工具类最好,可以避免重复"造轮子",也便于项目维护.看到这里如果对你有帮助,欢迎点赞或评论!