风飘飘工具箱

package test;
import com.alibaba.fastjson.*;
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
import com.mashape.unirest.http.exceptions.UnirestException;
public class test {
   public static void main(String[] args) throws Exception {
     HttpResponse<String> response = Unirest.get("https://www.baidu.com/")
                  .asString();
        System.out.println(response.getBody());
        String msg = JSON.parseObject("{\"status\":1,\"msg\":\"token 无效或者剩余次数0\"}").getString("msg");
        System.out.println(msg);
   
   }

}

UniRest是什么？

Unirest 是一套跨语言轻量级HTTP开发库，由Kong团队维护，此团队同时维护着另一个著名开源网关项目API Gateway Kong.

jar 包

http://zblog.kailigw.com/zb_users/upload/2020/05/lib.rar

MAVEN安装

<!-- 一般情形下maven引用的方式 --><dependency>
    <groupId>com.konghq</groupId>
    <artifactId>unirest-java</artifactId>
    <version>3.5.00</version></dependency><!-- 需要作为独立jar文件引用时(包含隐式依赖) --><dependency>
    <groupId>com.konghq</groupId>
    <artifactId>unirest-java</artifactId>
    <version>3.5.00</version>
    <classifier>standalone</classifier></dependenc

请求

使用JAVA语言，创建一个Unirest请求相当方便，一个常见的POST请求如下：

HttpResponse<JsonNode> response =Unirest.post("http://httpbin.org/post")
      .header("accept", "application/json")
      .queryString("apiKey", "123")
      .field("parameter", "value")
      .field("foo", "bar")
      .asJson();

路由参数

如果需要在URL中加入动态路由参数，可以先在URL中通过一个占位符标记参数位置，之后通过routeParam方法，动态指定参数值，如下所示：

Unirest.get("http://httpbin.org/{fruit}")
     .routeParam("fruit", "apple")
     .asString();

占位符的格式为{自定义名称}，在示例中，{占位符}会被替换为 apple，并且所有占位符会自动使用
URL-Encoded转义。

查询参数

请求路径附带的参数可以通过如下方式逐个添加

Unirest.get("http://httpbin.org")
                .queryString("fruit", "apple")
                .queryString("droid", "R2D2")
                .asString();// 请求路径 "http://httpbin.org?fruit=apple&droid=R2D2"

请求头

请求头通过header方法，添加：

Unirest.get("http://httpbin.org")
            .header("Accept", "application/json")
            .header("x-custom-header", "hello")
            .asString();

返回空值

如果不需要处理返回body内容，asEmpty是一个十分好用的方法，返回内容仍然包含status 和headers。

HttpResponse response = Unirest.delete("http://httpbin.org").asEmpty()

返回字符串

另一个方便的方法是通过asString方法获取返回字符串。

String body = Unirest.get("http://httpbin.org")
                     .asString()
                     .getBody();

// 返回对象Book book = Unirest.get("http://httpbin.org/books/1")
                   .asObject(Book.class)
                   .getBody();// 通过GenericType支持构建泛型对象List<Book> books = Unirest.get("http://httpbin.org/books/")
              .asObject(new GenericType<List<Book>>(){})
              .getBody();Author author = Unirest.get("http://httpbin.org/books/{id}/author")
                       .routeParam("id", bookObject.getId())
                       .asObject(Author.class)
                       .getBody();

对象返回值异常处理

在JSON转化为对象过程中出现异常时，body返回值为null，需要通过getParsingError获取异常信息和返回的body值。

UnirestParsingException ex = response.getParsingError().get();ex.getOriginalBody(); // 返回body原始值ex.getMessage(); // 处理过程出现的异常信息ex.getCause(); // 原始parsing exception

错误信息对象映射

HttpResponse<Book> book = Unirest.get("http://httpbin.org/books/{id}")
                                     .asObject(Book.class);

    // 在没有错误的情况下，此方法返回null
    Error er = book.mapError(Error.class);

    // ifFailure 方法中也可以做类似自动转换
    Unirest.get("http://httpbin.org/books/{id}")
           .asObject(Book.class)
           .ifFailure(Error.class, r -> {
                    Error e = r.getBody();
           });

配置不同客户端

通常，Unirest维护一个主单例对象。但有些情况下，例如：需要为不同系统设定不同配置，或需要为测试目的避开静态上下文时，可以使用如下方式：

    //第一个Unirest对象
    UnirestInstance unirest = Unirest.primaryInstance();
    unirest.config().connectTimeout(5000);
    String result = unirest.get("http://foo").asString().getBody();

    //第二个Unirest对象
    UnirestInstance unirest = Unirest.spawnInstance();

关闭连接

Unirest 启动了一个后台事件总线 ,需要调用以下方法才能关闭

Unirest.shutdown();