Package org.apache.http

Interface ConnectionReuseStrategy

All Known Implementing Classes:
DefaultConnectionReuseStrategy, NoConnectionReuseStrategy
public interface ConnectionReuseStrategy
Interface for deciding whether a connection should be kept alive.
Since:
4.0
Version:
$Revision: 496070 $
Author:
Oleg Kalnichevski

  • Method Summary

    Modifier and Type Method Description
    boolean keepAlive​(HttpResponse response, HttpContext context)
    Decides whether a connection can be kept open after a request.

  • Method Details

    • keepAlive

      boolean keepAlive​(HttpResponse response, HttpContext context)
      Decides whether a connection can be kept open after a request. If this method returns false, the caller MUST close the connection to correctly implement the HTTP protocol. If it returns true, the caller SHOULD attempt to keep the connection open for reuse with another request.
      One can use the HTTP context to retrieve additional objects that may be relevant for the keep-alive strategy: the actual HTTP connection, the original HTTP request, target host if known, number of times the connection has been reused already and so on.
      If the connection is already closed, false is returned. The stale connection check MUST NOT be triggered by a connection reuse strategy.
      Parameters:
      response - The last response received over that connection.
      context - the context in which the connection is being used.
      Returns:
      true if the connection is allowed to be reused, or false if it MUST NOT be reused