Interface HttpServerConnection

All Superinterfaces:
AutoCloseable, BHttpConnection, Closeable, HttpConnection, ModalCloseable, SocketModalCloseable
All Known Implementing Classes:
DefaultBHttpServerConnection, LoggingBHttpServerConnection

public interface HttpServerConnection extends BHttpConnection
A server-side HTTP connection, which can be used for receiving requests and sending responses.
Since:
4.0
  • Method Details

    • receiveRequestHeader

      ClassicHttpRequest receiveRequestHeader() throws HttpException, IOException
      Receives the request line and all headers available from this connection. The caller should examine the returned request and decide if to receive a request entity as well.
      Returns:
      a new HttpRequest object whose request line and headers are initialized or null if the connection has been closed by the opposite endpoint.
      Throws:
      HttpException - in case of HTTP protocol violation
      IOException - in case of an I/O error
    • receiveRequestEntity

      void receiveRequestEntity(ClassicHttpRequest request) throws HttpException, IOException
      Receives the next request entity available from this connection and attaches it to an existing request.
      Parameters:
      request - the request to attach the entity to.
      Throws:
      HttpException - in case of HTTP protocol violation
      IOException - in case of an I/O error
    • sendResponseHeader

      void sendResponseHeader(ClassicHttpResponse response) throws HttpException, IOException
      Sends the response line and headers of a response over this connection.
      Parameters:
      response - the response whose headers to send.
      Throws:
      HttpException - in case of HTTP protocol violation
      IOException - in case of an I/O error
    • sendResponseEntity

      void sendResponseEntity(ClassicHttpResponse response) throws HttpException, IOException
      Sends the response entity of a response over this connection.
      Parameters:
      response - the response whose entity to send.
      Throws:
      HttpException - in case of HTTP protocol violation
      IOException - in case of an I/O error