Package org.eclipse.jetty.http2.client

Class HTTP2Client

  • All Implemented Interfaces:
    Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle
    @ManagedObject
public class HTTP2Client
extends ContainerLifeCycle

    HTTP2Client provides an asynchronous, non-blocking implementation to send HTTP/2 frames to a server.

    Typical usage:

     // Create and start HTTP2Client.
 HTTP2Client client = new HTTP2Client();
 SslContextFactory sslContextFactory = new SslContextFactory();
 client.addBean(sslContextFactory);
 client.start();

 // Connect to host.
 String host = "webtide.com";
 int port = 443;

 FuturePromise<Session> sessionPromise = new FuturePromise<>();
 client.connect(sslContextFactory, new InetSocketAddress(host, port), new ServerSessionListener.Adapter(), sessionPromise);

 // Obtain the client Session object.
 Session session = sessionPromise.get(5, TimeUnit.SECONDS);

 // Prepare the HTTP request headers.
 HttpFields requestFields = new HttpFields();
 requestFields.put("User-Agent", client.getClass().getName() + "/" + Jetty.VERSION);
 // Prepare the HTTP request object.
 MetaData.Request request = new MetaData.Request("PUT", new HttpURI("https://" + host + ":" + port + "/"), HttpVersion.HTTP_2, requestFields);
 // Create the HTTP/2 HEADERS frame representing the HTTP request.
 HeadersFrame headersFrame = new HeadersFrame(request, null, false);

 // Prepare the listener to receive the HTTP response frames.
 Stream.Listener responseListener = new new Stream.Listener.Adapter()
 {
      @Override
      public void onHeaders(Stream stream, HeadersFrame frame)
      {
          System.err.println(frame);
      }

      @Override
      public void onData(Stream stream, DataFrame frame, Callback callback)
      {
          System.err.println(frame);
          callback.succeeded();
      }
 };

 // Send the HEADERS frame to create a stream.
 FuturePromise<Stream> streamPromise = new FuturePromise<>();
 session.newStream(headersFrame, streamPromise, responseListener);
 Stream stream = streamPromise.get(5, TimeUnit.SECONDS);

 // Use the Stream object to send request content, if any, using a DATA frame.
 ByteBuffer content = ...;
 DataFrame requestContent = new DataFrame(stream.getId(), content, true);
 stream.data(requestContent, Callback.Adapter.INSTANCE);

 // When done, stop the client.
 client.stop();

    • Constructor Detail

      • HTTP2Client

        public HTTP2Client()

    • Method Detail

      • doStart

        protected void doStart()
                throws java.lang.Exception
        Description copied from class: ContainerLifeCycle
        Starts the managed lifecycle beans in the order they were added.
        Overrides:
        doStart in class ContainerLifeCycle
        Throws:
        java.lang.Exception

      • getExecutor

        public java.util.concurrent.Executor getExecutor()

      • setExecutor

        public void setExecutor​(java.util.concurrent.Executor executor)

      • getScheduler

        public Scheduler getScheduler()

      • setScheduler

        public void setScheduler​(Scheduler scheduler)

      • setByteBufferPool

        public void setByteBufferPool​(ByteBufferPool bufferPool)

      • setClientConnectionFactory

        public void setClientConnectionFactory​(ClientConnectionFactory connectionFactory)

      • setFlowControlStrategyFactory

        public void setFlowControlStrategyFactory​(FlowControlStrategy.Factory flowControlStrategyFactory)

      • getSelectors

        @ManagedAttribute("The number of selectors")
public int getSelectors()

      • setSelectors

        public void setSelectors​(int selectors)

      • getIdleTimeout

        @ManagedAttribute("The idle timeout in milliseconds")
public long getIdleTimeout()

      • setIdleTimeout

        public void setIdleTimeout​(long idleTimeout)

      • getStreamIdleTimeout

        @ManagedAttribute("The stream idle timeout in milliseconds")
public long getStreamIdleTimeout()

      • setStreamIdleTimeout

        public void setStreamIdleTimeout​(long streamIdleTimeout)

      • getConnectTimeout

        @ManagedAttribute("The connect timeout in milliseconds")
public long getConnectTimeout()

      • setConnectTimeout

        public void setConnectTimeout​(long connectTimeout)

      • isConnectBlocking

        @ManagedAttribute("Whether the connect() operation is blocking")
public boolean isConnectBlocking()

      • setConnectBlocking

        public void setConnectBlocking​(boolean connectBlocking)

      • getBindAddress

        public java.net.SocketAddress getBindAddress()

      • setBindAddress

        public void setBindAddress​(java.net.SocketAddress bindAddress)

      • isTCPNoDelay

        public boolean isTCPNoDelay()

      • setTCPNoDelay

        public void setTCPNoDelay​(boolean tcpNoDelay)

      • getInputBufferSize

        @ManagedAttribute("The size of the buffer used to read from the network")
public int getInputBufferSize()

      • setInputBufferSize

        public void setInputBufferSize​(int inputBufferSize)

      • getProtocols

        @ManagedAttribute("The ALPN protocol list")
public java.util.List<java.lang.String> getProtocols()

      • setProtocols

        public void setProtocols​(java.util.List<java.lang.String> protocols)

      • getInitialSessionRecvWindow

        @ManagedAttribute("The initial size of session\'s flow control receive window")
public int getInitialSessionRecvWindow()

      • setInitialSessionRecvWindow

        public void setInitialSessionRecvWindow​(int initialSessionRecvWindow)

      • getInitialStreamRecvWindow

        @ManagedAttribute("The initial size of stream\'s flow control receive window")
public int getInitialStreamRecvWindow()

      • setInitialStreamRecvWindow

        public void setInitialStreamRecvWindow​(int initialStreamRecvWindow)

      • getMaxFrameLength

        @Deprecated
@ManagedAttribute("The max frame length in bytes")
public int getMaxFrameLength()
        Deprecated.

      • setMaxFrameLength

        @Deprecated
public void setMaxFrameLength​(int maxFrameLength)
        Deprecated.

      • getMaxFrameSize

        @ManagedAttribute("The max frame size in bytes")
public int getMaxFrameSize()

      • setMaxFrameSize

        public void setMaxFrameSize​(int maxFrameSize)

      • getMaxConcurrentPushedStreams

        @ManagedAttribute("The max number of concurrent pushed streams")
public int getMaxConcurrentPushedStreams()

      • setMaxConcurrentPushedStreams

        public void setMaxConcurrentPushedStreams​(int maxConcurrentPushedStreams)

      • getMaxSettingsKeys

        @ManagedAttribute("The max number of keys in all SETTINGS frames")
public int getMaxSettingsKeys()

      • setMaxSettingsKeys

        public void setMaxSettingsKeys​(int maxSettingsKeys)

      • getMaxEncoderTableCapacity

        @ManagedAttribute("The HPACK encoder dynamic table maximum capacity")
public int getMaxEncoderTableCapacity()

      • setMaxEncoderTableCapacity

        public void setMaxEncoderTableCapacity​(int maxEncoderTableCapacity)

        Sets the limit for the encoder HPACK dynamic table capacity.

        Setting this value to 0 disables the use of the dynamic table.

        Parameters:
        maxEncoderTableCapacity - The HPACK encoder dynamic table maximum capacity

      • getMaxDecoderTableCapacity

        @ManagedAttribute("The HPACK decoder dynamic table maximum capacity")
public int getMaxDecoderTableCapacity()

      • setMaxDecoderTableCapacity

        public void setMaxDecoderTableCapacity​(int maxDecoderTableCapacity)

      • getMaxDynamicTableSize

        @Deprecated
@ManagedAttribute("The HPACK dynamic table maximum size")
public int getMaxDynamicTableSize()
        Deprecated.

      • setMaxDynamicTableSize

        @Deprecated
public void setMaxDynamicTableSize​(int maxDynamicTableSize)
        Deprecated.

      • getMaxHeaderBlockFragment

        @ManagedAttribute("The max size of header block fragments")
public int getMaxHeaderBlockFragment()

      • setMaxHeaderBlockFragment

        public void setMaxHeaderBlockFragment​(int maxHeaderBlockFragment)

      • getMaxResponseHeadersSize

        @ManagedAttribute("The max size of response headers")
public int getMaxResponseHeadersSize()

      • setMaxResponseHeadersSize

        public void setMaxResponseHeadersSize​(int maxResponseHeadersSize)

      • configure

        protected void configure​(java.nio.channels.SocketChannel channel)
                  throws java.io.IOException
        Throws:
        java.io.IOException