Interface HttpClient

  • All Known Implementing Classes:
    DefaultHttpClient

    public interface HttpClient
    A simple interface for executing HTTP requests.
    • Method Summary

      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and Type Method Description
      default Response<java.util.Map> delete​(java.lang.String url, java.util.List<Parameter> parameters, java.util.Map<java.lang.String,​java.lang.String> additionalHeaders)
      <B> Response<B> delete​(java.lang.String url, java.util.List<Parameter> parameters, java.util.Map<java.lang.String,​java.lang.String> additionalHeaders, java.lang.Class<B> clazz)
      Perform DELETE operation against an endpoint.
      <B> Response<B> get​(java.lang.String url, java.util.List<Parameter> parameters, java.util.Map<java.lang.String,​java.lang.String> additionalHeaders, java.lang.Class<B> clazz)
      Perform GET operation against an endpoint.
      default void modifyConnection​(java.net.HttpURLConnection httpUrlConnection)
      Override this method if you could like to extend DefaultHttpClient and perform customer HTTP operations before URLConnection.connect() is called on the instance of the passed in connection.
      <R,​B>
      Response<B>
      post​(java.lang.String url, R request, java.util.List<Parameter> parameters, java.util.Map<java.lang.String,​java.lang.String> additionalHeaders, java.lang.Class<B> clazz)
      Perform POST operation against an endpoint.
      <R,​B>
      Response<B>
      put​(java.lang.String url, R request, java.util.List<Parameter> parameters, java.util.Map<java.lang.String,​java.lang.String> additionalHeaders, java.lang.Class<B> clazz)
      Perform PUT operation against an endpoint.
    • Method Detail

      • get

        <B> Response<B> get​(java.lang.String url,
                            java.util.List<Parameter> parameters,
                            java.util.Map<java.lang.String,​java.lang.String> additionalHeaders,
                            java.lang.Class<B> clazz)
        Perform GET operation against an endpoint.
        Type Parameters:
        B - The response body type.
        Parameters:
        url - The URL on which to perform the operation.
        parameters - An arbitrary number of parameters to add to the URL.
        additionalHeaders - Additional headers for the request.
        clazz - The class for the Response's body.
        Returns:
        The results of the query.
      • post

        <R,​B> Response<B> post​(java.lang.String url,
                                     R request,
                                     java.util.List<Parameter> parameters,
                                     java.util.Map<java.lang.String,​java.lang.String> additionalHeaders,
                                     java.lang.Class<B> clazz)
        Perform POST operation against an endpoint.
        Type Parameters:
        R - The Request type.
        B - The Response body type.
        Parameters:
        url - The URL on which to perform the operation.
        request - The element to be serialized into the request body.
        parameters - An arbitrary number of parameters to add to the URL.
        additionalHeaders - Additional headers for the request.
        clazz - The class for the Response's body.
        Returns:
        The results of the query.
      • put

        <R,​B> Response<B> put​(java.lang.String url,
                                    R request,
                                    java.util.List<Parameter> parameters,
                                    java.util.Map<java.lang.String,​java.lang.String> additionalHeaders,
                                    java.lang.Class<B> clazz)
        Perform PUT operation against an endpoint.
        Type Parameters:
        R - The Request type.
        B - The Response body type.
        Parameters:
        url - The URL on which to perform the operation.
        request - The element to be serialized into the request body.
        parameters - An arbitrary number of parameters to add to the URL.
        additionalHeaders - Additional headers for the request.
        clazz - The class for the Response's body.
        Returns:
        The results of the query.
      • delete

        <B> Response<B> delete​(java.lang.String url,
                               java.util.List<Parameter> parameters,
                               java.util.Map<java.lang.String,​java.lang.String> additionalHeaders,
                               java.lang.Class<B> clazz)
        Perform DELETE operation against an endpoint.
        Type Parameters:
        B - The Response body type.
        Parameters:
        url - The URL on which to perform the operation.
        parameters - An arbitrary number of parameters to add to the URL.
        additionalHeaders - Additional headers for the request.
        clazz - The class for the Response's body.
        Returns:
        The results of the query.
      • modifyConnection

        default void modifyConnection​(java.net.HttpURLConnection httpUrlConnection)
        Override this method if you could like to extend DefaultHttpClient and perform customer HTTP operations before URLConnection.connect() is called on the instance of the passed in connection.
        Parameters:
        httpUrlConnection - The URL connection to modify.