Class RestPutClientSugar

    • Constructor Detail

      • RestPutClientSugar

        public RestPutClientSugar()
    • Method Detail

      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.data.Scheme aScheme,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aUrl)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aLocator,
                                                  org.refcodes.net.FormFields aQueryFields)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aLocator,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aLocator,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aLocator,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aUrl,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aUrl,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aUrl,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException,
                                                  java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  int aPort,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.FormFields aQueryFields,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(java.lang.String aProtocol,
                                                  java.lang.String aHost,
                                                  java.lang.String aPath,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields,
                                                  java.lang.Object aRequest)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.net.Url aUrl)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aUrl - The Url from which to take the URL specific data.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • buildPut

        public static RestRequestBuilder buildPut​(org.refcodes.net.Url aUrl,
                                                  org.refcodes.net.RequestHeaderFields aHeaderFields)
                                           throws org.refcodes.net.HttpResponseException
        Parameters:
        aUrl - The Url from which to take the URL specific data.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestRequestBuilder which is used to prepare and synchronously issue the request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(org.refcodes.data.Scheme aScheme,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(org.refcodes.data.Scheme aScheme,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aScheme - The Scheme (e.g. HTTP or HTTPS) to be used for the destination URL.
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aUrl)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aLocator,
                                         org.refcodes.net.FormFields aQueryFields)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aLocator,
                                         org.refcodes.net.FormFields aQueryFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aLocator,
                                              org.refcodes.net.FormFields aQueryFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
                                       throws java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
        Throws:
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aLocator,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aLocator,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aLocator,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
                                       throws java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
        Throws:
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aLocator,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
                                       throws java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
        Throws:
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aLocator,
                                              org.refcodes.net.FormFields aQueryFields,
                                              RestResponseObserver aResponseObserver)
                                       throws java.net.MalformedURLException
        Parameters:
        aLocator - The targeted locator, usually the part of the URL till (excluding) the query fields and the fragment.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
        Throws:
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aUrl,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aUrl,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
                                       throws java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aResponseObserver - The listener processing a response targeted at this RestCallerBuilder.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestCallerBuilder which is used by your request.
        Throws:
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aUrl,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aUrl,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aUrl,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
                                       throws java.net.MalformedURLException
        Parameters:
        aUrl - The targeted URL locating the addressed resource.
        aResponseObserver - The listener processing a response targeted at this RestCallerBuilder.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestCallerBuilder which is used by your request.
        Throws:
        java.net.MalformedURLException - in case the provided URL is considered being malformed.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         int aPort,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              int aPort,
                                              java.lang.String aPath,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPort - The port to be used when connecting to the host.
        aPath - The path on the host to which the base destination URL is to point to.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.FormFields aQueryFields,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.FormFields aQueryFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aQueryFields - The Query-Fields to be used for the HTTP Query-String.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestResponse doPut​(java.lang.String aProtocol,
                                         java.lang.String aHost,
                                         java.lang.String aPath,
                                         org.refcodes.net.RequestHeaderFields aHeaderFields,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              java.lang.Object aRequest,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              org.refcodes.net.RequestHeaderFields aHeaderFields,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aHeaderFields - The HTTP-Header's fields to be used for the request.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestCallerBuilder doPut​(java.lang.String aProtocol,
                                              java.lang.String aHost,
                                              java.lang.String aPath,
                                              RestResponseObserver aResponseObserver)
        Parameters:
        aProtocol - The protocol (e.g. HTTP or HTTPS) including the specific part (such as "//" for "http://") to be used for the destination URL: For HTTP, provide "http://", for HTTPS, provide "https://".
        aHost - The host to which the destination URL is to point to.
        aPath - The path on the host to which the base destination URL is to point to.
        aResponseObserver - The listener processing a response targeted at this RestCaller.
        Returns:
        The RestCallerBuilder which is used by your request.
      • doPut

        public static RestResponse doPut​(org.refcodes.net.Url aUrl,
                                         java.lang.Object aRequest)
                                  throws org.refcodes.net.HttpResponseException,
                                         java.net.MalformedURLException
        Parameters:
        aUrl - The Url from which to take the URL specific data.
        aRequest - The body to be sent with the request (e.g. when doing a HttpMethod.PUT request.
        Returns:
        The RestResponse as of your request.
        Throws:
        org.refcodes.net.HttpResponseException - thrown in case of some unexpected response.
        java.net.MalformedURLException - in case the provided URL is considered being malformed.