Package org.refcodes.rest

Interface RestRequestBuilder

  • All Superinterfaces:
    org.refcodes.mixin.Dumpable, org.refcodes.net.HeaderFieldsAccessor<org.refcodes.net.RequestHeaderFields>, org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsBuilder<org.refcodes.net.RequestHeaderFields,RestRequestBuilder>, org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsMutator<org.refcodes.net.RequestHeaderFields>, org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsProperty<org.refcodes.net.RequestHeaderFields>, org.refcodes.net.HttpBodyAccessor.HttpBodyProvider<org.refcodes.net.BadRequestException>, org.refcodes.net.HttpClientRequest, org.refcodes.net.HttpMethodAccessor, org.refcodes.net.HttpMethodAccessor.HttpMethodBuilder<RestRequestBuilder>, org.refcodes.net.HttpMethodAccessor.HttpMethodMutator, org.refcodes.net.HttpMethodAccessor.HttpMethodProperty, org.refcodes.net.HttpRequest, org.refcodes.net.HttpRequestBuilder<RestRequestBuilder>, RestRequest, org.refcodes.net.UrlAccessor, org.refcodes.net.UrlAccessor.UrlBuilder, org.refcodes.net.UrlAccessor.UrlMutator
    All Known Implementing Classes:
    RestRequestBuilderImpl
    public interface RestRequestBuilder
extends RestRequest, org.refcodes.net.HttpRequestBuilder<RestRequestBuilder>, org.refcodes.net.HttpMethodAccessor.HttpMethodProperty, org.refcodes.net.HttpMethodAccessor.HttpMethodBuilder<RestRequestBuilder>, org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsBuilder<org.refcodes.net.RequestHeaderFields,RestRequestBuilder>
    An RestRequestBuilder extends an RestCaller with builder functionality and adds lambda support for handling the responses addressed to this RestCaller. The lambda defined as RestResponseObserver acts as the single listener to this RestCaller responsible for handling the responses for which this RestCaller is responsible. The locator to which a RestRequestBuilder targets for is defined by the UrlAccessor.getUrl() property.

    • Nested Class Summary

      • Nested classes/interfaces inherited from interface org.refcodes.net.HeaderFieldsAccessor

        org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsBuilder<T extends org.refcodes.net.HeaderFields<?,?>,B extends org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsBuilder<T,B>>, org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsMutator<T extends org.refcodes.net.HeaderFields<?,?>>, org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsProperty<T extends org.refcodes.net.HeaderFields<?,?>>

      • Nested classes/interfaces inherited from interface org.refcodes.net.HttpMethodAccessor

        org.refcodes.net.HttpMethodAccessor.HttpMethodBuilder<B extends org.refcodes.net.HttpMethodAccessor.HttpMethodBuilder<B>>, org.refcodes.net.HttpMethodAccessor.HttpMethodMutator, org.refcodes.net.HttpMethodAccessor.HttpMethodProperty

      • Nested classes/interfaces inherited from interface org.refcodes.net.UrlAccessor

        org.refcodes.net.UrlAccessor.UrlBuilder, org.refcodes.net.UrlAccessor.UrlMutator, org.refcodes.net.UrlAccessor.UrlProperty

    • Method Summary

      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and Type Method Description
      RestResponse toRestResponse()
      Sends the request and returns synchronously the according RestResponse.
      default RestRequestBuilder withHeaderFields​(org.refcodes.net.RequestHeaderFields aRequestHeaderFields)
      default RestRequestBuilder withHttpMethod​(org.refcodes.net.HttpMethod aHttpMethod)
      default <REQ> RestRequestBuilder withRequest​(REQ aRequest)
      default RestRequestBuilder withUrl​(org.refcodes.net.Url aUrl)

      • Methods inherited from interface org.refcodes.mixin.Dumpable

        toDump, toDump

      • Methods inherited from interface org.refcodes.net.HeaderFieldsAccessor

        getHeaderFields

      • Methods inherited from interface org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsMutator

        setHeaderFields

      • Methods inherited from interface org.refcodes.net.HttpClientRequest

        getRequest, setRequest, toHttpBody

      • Methods inherited from interface org.refcodes.net.HttpMethodAccessor

        getHttpMethod

      • Methods inherited from interface org.refcodes.net.HttpMethodAccessor.HttpMethodMutator

        setHttpMethod

      • Methods inherited from interface org.refcodes.net.HttpRequestBuilder

        withAddToHeaderFields, withAddToHeaderFields, withAddToHeaderFields, withAddToHeaderFields, withAddToHeaderFields, withAddToQueryFields, withAddToQueryFields, withAddToQueryFields

      • Methods inherited from interface org.refcodes.net.UrlAccessor

        getUrl

      • Methods inherited from interface org.refcodes.net.UrlAccessor.UrlMutator

        setUrl

    • Method Detail

      • toRestResponse

        RestResponse toRestResponse()
                     throws org.refcodes.net.HttpResponseException
        Sends the request and returns synchronously the according RestResponse.
        Returns:
        the rest response
        Throws:
        org.refcodes.net.HttpResponseException - the http response exception

      • withUrl

        default RestRequestBuilder withUrl​(org.refcodes.net.Url aUrl)
        Specified by:
        withUrl in interface org.refcodes.net.UrlAccessor.UrlBuilder

      • withHttpMethod

        default RestRequestBuilder withHttpMethod​(org.refcodes.net.HttpMethod aHttpMethod)
        Specified by:
        withHttpMethod in interface org.refcodes.net.HttpMethodAccessor.HttpMethodBuilder<RestRequestBuilder>

      • withRequest

        default <REQ> RestRequestBuilder withRequest​(REQ aRequest)
        Specified by:
        withRequest in interface org.refcodes.net.HttpClientRequest

      • withHeaderFields

        default RestRequestBuilder withHeaderFields​(org.refcodes.net.RequestHeaderFields aRequestHeaderFields)
        Specified by:
        withHeaderFields in interface org.refcodes.net.HeaderFieldsAccessor.HeaderFieldsBuilder<org.refcodes.net.RequestHeaderFields,RestRequestBuilder>