Class DelegateHTTPClient

Object
DelegateHTTPClient
All Implemented Interfaces:
HTTPClient
Direct Known Subclasses:
LoggingHTTPClient

public class DelegateHTTPClient extends Object implements HTTPClient
  • Field Details

  • Constructor Details

    • DelegateHTTPClient

      public DelegateHTTPClient(HTTPClient delegate)
  • Method Details

    • post

      public HTTPResponse post(URL url, InputStream postContent, String postContentType) throws IOException
      Description copied from interface: HTTPClient
      Executes an HTTP POST request against the provided URL, sending the contents of postContent as the POST method body and setting the Content-Type request header to postContentType if given, and returns the server response.

      If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

      If a connection timeout is set, the http connection will be set to respect that timeout.

      If a read timeout is set, the http connection will be set to respect it.

      Specified by:
      post in interface HTTPClient
      Parameters:
      url - the URL against which to execute the POST request
      postContent - an input stream with the contents of the POST body
      postContentType - the MIME type of the contents sent as the request POST body, can be null
      Returns:
      the HTTPResponse encapsulating the response to the HTTP POST request
      Throws:
      IOException
    • post

      public HTTPResponse post(URL url, InputStream postContent, String postContentType, Map<String,String> headers) throws IOException
      Description copied from interface: HTTPClient
      Executes an HTTP POST request against the provided URL, sending the contents of postContent as the POST method body and setting the Content-Type request header to postContentType if given, and returns the server response.

      If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

      If a connection timeout is set, the http connection will be set to respect that timeout.

      If a read timeout is set, the http connection will be set to respect it.

      header parameter contains additional headers to add to the request.

      Specified by:
      post in interface HTTPClient
      Parameters:
      url - the URL against which to execute the POST request
      postContent - an input stream with the contents of the POST body
      postContentType - the MIME type of the contents sent as the request POST body, can be null
      headers - a list of custom headers to add to the request.
      Returns:
      the HTTPResponse encapsulating the response to the HTTP POST request
      Throws:
      IOException
    • get

      public HTTPResponse get(URL url) throws IOException
      Description copied from interface: HTTPClient
      Executes an HTTP GET request against the provided URL and returns the server response.

      If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

      If a connection timeout is set, the http connection will be set to respect that timeout.

      If a read timeout is set, the http connection will be set to respect it.

      Specified by:
      get in interface HTTPClient
      Parameters:
      url - the URL to retrieve
      Returns:
      an HTTPResponse encapsulating the response to the HTTP GET request
      Throws:
      IOException
    • get

      public HTTPResponse get(URL url, Map<String,String> headers) throws IOException
      Description copied from interface: HTTPClient
      Executes an HTTP GET request against the provided URL and returns the server response.

      If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

      If a connection timeout is set, the http connection will be set to respect that timeout.

      If a read timeout is set, the http connection will be set to respect it.

      header parameter contains additional headers to add to the request.

      Specified by:
      get in interface HTTPClient
      Parameters:
      url - the URL to retrieve
      headers - a list of custom headers to add to the request.
      Returns:
      an HTTPResponse encapsulating the response to the HTTP GET request
      Throws:
      IOException
    • getUser

      public String getUser()
      Specified by:
      getUser in interface HTTPClient
      Returns:
      the HTTP BASIC Authentication user name, or null if not set
    • setUser

      public void setUser(String user)
      Specified by:
      setUser in interface HTTPClient
      Parameters:
      user - the HTTP BASIC Authentication user name
    • getPassword

      public String getPassword()
      Specified by:
      getPassword in interface HTTPClient
      Returns:
      the HTTP BASIC Authentication password, or null if not set
    • setPassword

      public void setPassword(String password)
      Specified by:
      setPassword in interface HTTPClient
      Parameters:
      password - the HTTP BASIC Authentication password
    • getExtraParams

      public Map<String,String> getExtraParams()
      Description copied from interface: HTTPClient
      Optional query parameters.
      Specified by:
      getExtraParams in interface HTTPClient
      Returns:
      querystring ExtraParams, or emptyMap() if not set
    • setExtraParams

      public void setExtraParams(Map<String,String> extraParams)
      Specified by:
      setExtraParams in interface HTTPClient
      Parameters:
      extraParams - the optional querystring ExtraParams to be appended to finalURL
    • getConnectTimeout

      public int getConnectTimeout()
      Specified by:
      getConnectTimeout in interface HTTPClient
      Returns:
      the tcp/ip connect timeout in seconds
    • setConnectTimeout

      public void setConnectTimeout(int connectTimeout)
      Specified by:
      setConnectTimeout in interface HTTPClient
      Parameters:
      connectTimeout - tcp/ip connect timeout in seconds
    • getReadTimeout

      public int getReadTimeout()
      Specified by:
      getReadTimeout in interface HTTPClient
      Returns:
      the socket read timeout in seconds
    • setReadTimeout

      public void setReadTimeout(int readTimeout)
      Specified by:
      setReadTimeout in interface HTTPClient
      Parameters:
      readTimeout - socket read timeout in seconds
    • setTryGzip

      public void setTryGzip(boolean tryGZIP)
      Specified by:
      setTryGzip in interface HTTPClient
    • isTryGzip

      public boolean isTryGzip()
      Specified by:
      isTryGzip in interface HTTPClient
      Returns:
      whether gzip content encoding will be attempted; defaults to false