Package org.forgerock.http.protocol

Class Response

    • Constructor Detail

      • Response

        public Response​(Response response)
         throws IOException
        Creates a defensive copy of the given response message.
        Parameters:
        response - response to be copied
        Throws:
        IOException - when entity cannot be cloned

      • Response

        public Response​(Status status)
        Creates a new response with a default status.
        Parameters:
        status - The status to use for the Reponse.

    • Method Detail

      • newResponsePromise

        public static Promise<Response,​NeverThrowsException> newResponsePromise​(Response response)
        Returns a Promise representing the Response for an asynchronous Request which has already completed. Attempts to get the Response will immediately return without blocking, and any listeners registered against the returned promise will be immediately invoked in the same thread as the caller.
        Parameters:
        response - The Response.
        Returns:
        A Promise representing the Response for an asynchronous Request which has already completed.

      • newResponsePromiseImpl

        public static PromiseImpl<Response,​NeverThrowsException> newResponsePromiseImpl()
        Creates a new pending Promise implementation representing the Response for an asynchronous Request. The returned PromiseImpl must be completed once the Response is received by invoking the handleResult method.
        Returns:
        A new pending Promise implementation representing the Response for an asynchronous Request.

      • getStatus

        public Status getStatus()
        Returns the response status.
        Returns:
        The response status.

      • getCause

        public Exception getCause()
        Returns the (possibly null) cause of this error message (assuming it is a 4xx or a 5xx).
        Returns:
        the (possibly null) cause of this error message (assuming it is a 4xx or a 5xx).

      • setCause

        public Response setCause​(Exception cause)
        Link a 'caused by' exception to this response. That can be used to determine if this error response was triggered by an exception (as opposed to obtained from a remote server). Note: this method does not change the status of this message, neither touch its content. It's up to the caller to ensure consistency (if required in the execution context).
        Parameters:
        cause - Cause of this error response
        Returns:
        This response.

      • setEntity

        public Response setEntity​(Object o)
        Description copied from interface: Message
        Sets the content of the entity to the provided value. Calling this method will close any existing streams associated with the entity. May also set the Content-Length header, overwriting any existing header.

        This method is intended mostly as a convenience method within scripts. The parameter will be handled depending on its type as follows:

        Note: This method does not attempt to encode the entity based-on any codings specified in the Content-Encoding header.

        Parameters:
        o - The object whose value should be stored in the entity.
        Returns:
        This message.

      • setStatus

        public Response setStatus​(Status status)
        Sets the response status code.
        Parameters:
        status - The response status code.
        Returns:
        This response.

      • setVersion

        public Response setVersion​(String version)
        Description copied from interface: Message
        Sets the protocol version. Default: HTTP/1.1.
        Parameters:
        version - The protocol version.
        Returns:
        This message.

      • hasStreamingContent

        public boolean hasStreamingContent()
        Indicates that the response's content has to be considered as a streaming and thus some special treatments may apply on it.
        Returns:
        true if the response's content has to be considered as a streaming content.

      • setStreamingContent

        public Response setStreamingContent​(boolean streamingContent)
        Set that the response's content has to be considered as a streaming and thus some special treatments may apply on it.
        Parameters:
        streamingContent - Is it a streamed content or not ?
        Returns:
        This response.

      • getTrailers

        public Headers getTrailers()
        Returns the trailers, aka trailing headers.
        Returns:
        The trailers.

      • addTrailers

        public Response addTrailers​(Header... trailers)
        Add one or more trailers, aka trailing headers, to the response.
        Parameters:
        trailers - The trailers to add (not null).
        Returns:
        This response.

      • putTrailers

        public Response putTrailers​(Header... trailers)
        Put one or more trailers, aka trailing headers, to the response. This will overwrite any existing trailers values for the names of the trailers provided.
        Parameters:
        trailers - The trailers to put (not null).
        Returns:
        This response.