vert.x web client发送http https请求

布满荆棘的人生 2022-12-01 14:19 224阅读 0赞

vert.x web client是一个异步的http客户端，可以很容易的发送异步请求，什么是异步呢？简单举例，同步的http请求，如果服务器没有响应就要一直等着.....异步就是还可以干别的。web client还是很好用的而且提供了很多高级功能。

首先引用gradle

dependencies {
     compile 'io.vertx:vertx-web-client:3.9.2'
    }

创建一个web client客户端

WebClient client = WebClient.create(vertx);

如果需要参数可以使用另一个带WebClientOptions的方法，WebClient本身是一个接口，create方法实际是new了一个WebClientBase的实现类。官网例子

//可以设置超时时间，最大重定向数，支持ssl等各种
    WebClientOptions options = new WebClientOptions()
      .setUserAgent("My-App/1.2.3");
    //这里可以用链式的在上面接着 .setKeepAlive(false) 
    options.setKeepAlive(false);
    
    WebClient client = WebClient.create(vertx, options);

创建好client之后，就可以调用get，post，put，delete等一系列各种方法发送请求，如果不指定请求类型可以调用request()方法，这些方法的实现也都在WebClientBase。每种请求有3个重载方法外加一个xxxAbs方法，如get方法有可分别指定port端口号，host域名，requestURI请求URI的三种，getAbs代表使用绝对路径。

官网例子

// 发送一个get请求 参数端口号，域名，uri
    client
      .get(8080, "myserver.mycompany.com", "/some-uri")    
      .send(ar -> {
        if (ar.succeeded()) {
          // 获得response响应
          HttpResponse<Buffer> response = ar.result();
    
          System.out.println("Received response with status code" + response.statusCode());
        } else {
          System.out.println("Something went wrong " + ar.cause().getMessage());
        }
      });

client.get得到的是一个HttpRequest<Buffer>对象，可以理解为一个request，调用send就是发送请求，如果是传json参数就sendJson，此外还有sendForm等各种方法。因为是request，所以在send之前我们还可以设置setQueryParam请求参数addQueryParam和putHeader设置请求头。注意！如果是特殊数据请求content-type要和数据对应设置！！

ar是什么呢？是一个AsyncResult<HttpResponse<T>>，可以理解为异步请求返回的处理结果，AsyncResult接口4个方法，result获取结果，cause获取异常，succeed判断请求是否成功，failed判断请求是否失败。注意这里的succeed并不是只有statusCode是200才会进入，401，404,500，只要请求的服务可以正确响应（服务没有挂掉）都可以走到if中，文档中也说了，默认只有网络级别的错误以失败结尾。

如果知道返回结果是json，可以在获取响应后直接转json。

JsonObject jo = response.bodyAsJsonObject();

Vert.x提供了系列bodyAsXXXX转为相应格式的方法解码非常方便，如bodyAsString , bodyAsJsonArray等等。默认返回是Buffer。所以重点，不知道传数据的格式，用sendBuffer，不知道接收数据类型，也用Buffer接收。

问题来了，那么如何发https请求呢？可以在send之前调用ssl(true)，或者直接用xxxAbs方法发送请求直接传https路径。

先写到这，如有不对欢迎交流。