Package com.github.alexdlaird.http

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)
      See delete(String, List, Map).
      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)
      See delete(String, List, Map, Class).
      <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.
      default <B> Response<B> get​(java.lang.String url, java.lang.Class<B> clazz)
      See get(String, List, Map, Class).
      <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.
      default <R,​B>
      Response<B>      		 post​(java.lang.String url, R request, java.lang.Class<B> clazz)
      See post(String, Object, List, Map, Class).
      <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.
      default <R,​B>
      Response<B>      		 put​(java.lang.String url, R request, java.lang.Class<B> clazz)
      See put(String, Object, List, Map, Class).
      <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.