Package org.eclipse.jetty.reactive.client

Class ReactiveRequest

  • public class ReactiveRequest
extends java.lang.Object

    A reactive wrapper over Jetty's HttpClient Request.

    A ReactiveRequest can be obtained via a builder:

     // Built with HttpClient and a string URI.
 ReactiveRequest request = ReactiveRequest.newBuilder(httpClient, uri()).build();

 // Built by wrapping a Request.
 Request req = httpClient.newRequest(...);
 ...
 ReactiveRequest request = ReactiveRequest.newBuilder(req).build();

    Once created, a ReactiveRequest can be sent to obtain a Publisher for a ReactiveResponse passing a function that handles the response content:

     Publisher<T> response = request.response((response, content) -> { ... });

    • Constructor Detail

      • ReactiveRequest

        protected ReactiveRequest​(org.eclipse.jetty.client.api.Request request)

    • Method Detail

      • newBuilder

        public static ReactiveRequest.Builder newBuilder​(org.eclipse.jetty.client.HttpClient httpClient,
                                                 java.lang.String uri)
        Parameters:
        httpClient - the HttpClient instance
        uri - the target URI for the request - must be properly encoded already
        Returns:
        a builder for a GET request for the given URI

      • newBuilder

        public static ReactiveRequest.Builder newBuilder​(org.eclipse.jetty.client.api.Request request)
        Parameters:
        request - the request instance
        Returns:
        a builder for the given Request

      • getReactiveResponse

        public ReactiveResponse getReactiveResponse()
        Returns:
        the ReactiveResponse correspondent to this request, or null if the response is not available yet

      • getRequest

        public org.eclipse.jetty.client.api.Request getRequest()
        Returns:
        the wrapped Jetty request

      • response

        public org.reactivestreams.Publisher<ReactiveResponse> response()

        Creates a Publisher that sends the request when a Subscriber requests the response via Subscription.request(long), discarding the response content.

        Returns:
        a Publisher for the response

      • response

        public <T> org.reactivestreams.Publisher<T> response​(java.util.function.BiFunction<ReactiveResponse,​org.reactivestreams.Publisher<ContentChunk>,​org.reactivestreams.Publisher<T>> contentFn)

        Creates a Publisher that sends the request when a Subscriber requests the response via Subscription.request(long), processing the response content with the given function.

        Applications must subscribe (possibly asynchronously) to the response content Publisher, even if it is known that the response has no content, to receive the response success/failure events.

        Type Parameters:
        T - the element type of the processed response content
        Parameters:
        contentFn - the function that processes the response content
        Returns:
        a Publisher for the processed content

      • requestEvents

        public org.reactivestreams.Publisher<ReactiveRequest.Event> requestEvents()
        Returns:
        a Publisher for request events

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object