Vert.x核心模块 HTTP客户端推送 （九【4】）

客户端推送

服务器推送是HTTP/2的一个新特性，此特性使得可以在单一客户端请求中可以并行发出多个响应。推送处理器可以被设置到请求上用来接收服务器推送的请求/响应。

HttpClientRequest request =client.get("/index.html", response -> {

  //Process index.html response

});

 // Set a push handler to be aware of anyresource pushed by the server

request.pushHandler(pushedRequest -> {

   // Aresource is pushed for this request

 System.out.println("Server pushed " + pushedRequest.path());

   // Setan handler for the response

 pushedRequest.handler(pushedResponse -> {

   System.out.println("The response for the pushed request");

  });

});

 // End the request

request.end();

如果客户不想再接收推送的请求，客户端可以重置流：

request.pushHandler(pushedRequest -> {

  if(pushedRequest.path().equals("/main.js")) {

   pushedRequest.reset();

  } else{

    //Handle it

  }

});

接收定制的HTTP/2帧

HTTP/2是HTTP请求/响应模型中的一多帧的帧协义。协议支持其他帧的发送与接收。为了接收定制帧，可以在请求上使用定制帧处理器（customFrameHandler），当每次定制帧到达时，此处理器将会被调用。例子如下：

response.customFrameHandler(frame -> {

  System.out.println("Received a frame type=" + frame.type() +

      " payload" +frame.payload().toString());

});

客户端启用压缩

http客户端一起支持的还有HTTP压缩。这表示客户端让远程Http服务器知道此客户端支持压缩，并能处理压缩的响应体。一个http服务器可以自由选择是用支持的压缩算法进行压缩，还是不压缩的方式发回响应体。所以这仅是一个http服务器忽视或使用的提示。为了告知http服务器客户端支持哪种压缩，客户端提供一个支持的压缩算法值作为Accept-Encoding头的值。多个压缩算法被支持的情况，Vert.x将会添加下列头：

Accept-Encoding: gzip, deflate

服务器将选择其中之一。你可以检查服务器是否通过查看响应中的Content-Encoding头压缩了响应体，并发回。

如果响应体通过gzip压缩，响应体将包含下列头：

Content-Encoding: gzip

在创建客户端时设置setTryUseCompression选项启用压缩。默认压缩是禁用的。

HTTP/1.x池化和长连接

Http长连接允许多个请求使用一个连接，在向同一个服务器发送多个请求，这样连接使用就会更有效。对于HTTP/1.x版本，http客户端支持池化连接在请求间重用连接。为了池化，使用setKeepAlive进行请求客户端设置。默认值为true.当KeepAlive启用。Vert.x将会在每个发送的请求中添加Connection:Keep-Alive头。当KeepAlive禁用时，Vert.x在每个发送的请求中添加Connection:Close头，通知服务器在完成响应后连接将会被关闭。对于每个服务器的的连池池的最大连接数通过调用setMaxPoolSize进行设置。在启用池化创建请求时，如果池中的连接数小于最大连接数设置时，Vert.x会创建一个新的连接，否则会将请求添加到等待队列。活动连接不会被客户端自动关闭。为了关闭活动连接，可以关系客户端实例。作为另一种关闭活动连接的选择是用setIdleTimeout设置空闲超时时间,在超时时间内，任何不被使用的连接都会被关闭。请注意空闲时间的单位是秒而不毫秒。

 HTTP/1.1管道内嵌

客户端也支持在同一个连接上进行请求内嵌。请求内嵌意思在前一个请求的响应返回前，s可以发送另外请求。管道内嵌不适用于所有请求。为了启用管道内嵌，可以使用setPipelining进行启用。默认pipe-lining是禁用的。在启用客道内嵌后，发送一个请求将不必待前一个响应返回。单一连接上管道内嵌的请求数能过setPipeliningLimit时行限制。这个选项定义了在等待响应时发送http请求的最大数目。这个限制确保了在同一服务器的所有连接上的http请求分布的公平性。

 HTTP/2多路复用

HTTP/2主张对一个服务器使用单一连接，默认的http客户端对每个服务器使用单一连接，同一服务器的所有流是多路复用同一个连接。如需要多个连接或者使用池化时，会用到setHttp2MaxPoolSize方法。在每个连接上限制复用流的数量是必须的，同时使用池代替单一连接，这种情况可以用setHttp2MultiplexingLimit。

HttpClientOptions clientOptions = newHttpClientOptions().

   setHttp2MultiplexingLimit(10).

   setHttp2MaxPoolSize(3);

 // Uses up to 3 connections and up to 10 streamsper connection

HttpClient client =vertx.createHttpClient(clientOptions);

单个连接的复用限制设置在客户端上，用于限制每个连接上流也的数量。如果使用SETTINGS_MAX_CONCURRENT_STREAMS 配置设成较低限制，有效值甚至更低。HTTP/2连接不会被客户端自动关闭。为了关闭连接，必须调用客户端实例上的close方法。另一方法是用setIdleTimeout方法设置超时时间-一些在超时时间内不用的连接都将被关闭。请注意超时时间单位是秒而不是毫秒。

 HTTP连接

HttpConnection提供了处理HTTP连接事件，生命周期和设置的API。HTTP/2完整实现了HttpConnection的API。HTTP/1.x部分实现了HttpConnection的API:仅是关闭操作，关闭处理器，异常处理器被实现。此协议不提供其他操作的语义。

 服务器选项

connection方法反回一个服务器上的请求连接：

HttpConnection connection =request.connection();

在服务器上注册连接处理器获取进行连接时的通知

HttpServer server =vertx.createHttpServer(http2Options);

 server.connectionHandler(connection -> {

 System.out.println("A client connected");

});

 客户端连接

connection方法返回一个客户端连接：

HttpConnection connection =request.connection();

可以在请求上设置连接处理器获取连接通知

request.connectionHandler(connection -> {

 System.out.println("Connected to the server");

});

 连接设置

HTTP/2使用Http2Settiongs数据对象进行配置。每个端点必须遵守连接另一端发送的配置。在连接建立时，客户端与服务器交换初始设置。使用setInitialSettiongs进行初始设置客户端和服务器。连接建立后，可以在任何时候进行设置:

connection.updateSettings(newHttp2Settings().setMaxConcurrentStreams(100));

在远程端应该确认收到设置更新，可以设置回调确认收到通知：

connection.updateSettings(newHttp2Settings().setMaxConcurrentStreams(100), ar -> {

  if(ar.succeeded()) {

   System.out.println("The settings update has been acknowledged");

  }

});

相反 remoteSettingsHandler在收到远程设置时被调用并获得通知：

connection.remoteSettingsHandler(settings ->{

 System.out.println("Received new settings");

});

注释：这仅适用于HTTP/2协议

 连接心跳

HTTP/2连接ping在判断连接来回耗时，检查连接有效性上是有用的：ping发送PIBG帧到远程点。

Buffer data = Buffer.buffer();

for (byte i = 0;i < 8;i++) {

 data.appendByte(i);

}

connection.ping(data, pong -> {

 System.out.println("Remote side replied");

});

在一个PING帧收到之后，Vert.x会自动发送一个确认，使用一个处理器可以处理收到ping的通知：

connection.pingHandler(ping -> {

 System.out.println("Got pinged by remote side");

});

处理器会适时被通知，无论确认都会被发回。此特性是针对HTTP/2协义进行的实现。

注意：仅适用于HTTP/2协议。

 连接关闭和停止

 调用shutdown方法将会发送GOAWAY帧到连接的远程端。请求对方停止创建流：客户端将会停止新建请求并且服务器将停止推送响应。在GOAWAY帖发送之后，连接等待一些时间（默认30秒）直到当前所有流关闭然后关闭连接：
connection.shutdown();

在所有流关闭后，shutdownHandler通知还没有关闭的连接。也有只发送GOAWAY帧的可能，与shutdown的主要区别是，GOAWAY仅告知连接的远程端停止创建新的流还没有流关闭的计划：

connection.goAway(0);

相反，在收到GOAWAY帧时也能被通知：

connection.goAwayHandler(goAway -> {

 System.out.println("Received a go away frame");

});

shutdownHandler在当前流关闭和连接关闭时会被调用：

connection.goAway(0);

connection.shutdownHandler(v -> {

   // Allstreams are closed, close the connection

 connection.close();

});

也适用于在收到GOAWAY帧时。

注意：仅适用于HTTP/2协议

 连接关闭

连接的close方法半闭连接：

·          close方法半闭HTTP/1.x的socket

·          HTTP/2立既关闭，在连接关闭前，GOAWAY帧仍将会发送

在连接被关闭时调用closeHandler。