Interface RestfulClient

All Superinterfaces:
org.refcodes.web.BasicAuthCredentialsAccessor, org.refcodes.web.BasicAuthCredentialsAccessor.BasicAuthCredentialsBuilder<RestfulClient>, org.refcodes.web.BasicAuthCredentialsAccessor.BasicAuthCredentialsMutator, org.refcodes.web.BasicAuthCredentialsAccessor.BasicAuthCredentialsProperty, org.refcodes.web.MediaTypeFactoryLookup, org.refcodes.web.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup, org.refcodes.web.OauthTokenAccessor, org.refcodes.web.OauthTokenAccessor.OauthTokenBuilder<RestfulClient>, org.refcodes.web.OauthTokenAccessor.OauthTokenMutator, org.refcodes.web.OauthTokenAccessor.OauthTokenProperty, RestDeleteClient, RestGetClient, RestPostClient, RestPutClient, RestRequestClient, RestRequestHandler, org.refcodes.web.UserAgentAccessor, org.refcodes.web.UserAgentAccessor.UserAgentBuilder<RestfulClient>, org.refcodes.web.UserAgentAccessor.UserAgentMutator, org.refcodes.web.UserAgentAccessor.UserAgentProperty
All Known Subinterfaces:
RestfulHttpClient, RestfulHttpDiscoveryClient<B>
All Known Implementing Classes:
AbstractRestfulClient, AbstractRestfulHttpClientDecorator, AbstractRestfulHttpDiscoveryClientDecorator, HttpRestClient, HttpRestClientSingleton, LoopbackRestClient, LoopbackRestClientSingleton

public interface RestfulClient extends org.refcodes.web.BasicAuthCredentialsAccessor.BasicAuthCredentialsProperty, org.refcodes.web.BasicAuthCredentialsAccessor.BasicAuthCredentialsBuilder<RestfulClient>, org.refcodes.web.OauthTokenAccessor.OauthTokenProperty, org.refcodes.web.OauthTokenAccessor.OauthTokenBuilder<RestfulClient>, RestGetClient, RestPostClient, RestDeleteClient, RestPutClient, org.refcodes.web.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup, org.refcodes.web.UserAgentAccessor.UserAgentProperty, org.refcodes.web.UserAgentAccessor.UserAgentBuilder<RestfulClient>
A client to send requests for communicating with a RESTful server such as the RestfulHttpServer. For marshaling and unmarshaling HTTP bodies you have to register the according MediaTypeFactory instances being capable of handling the according MediaType definitions. Examples for ready to use MediaTypeFactory implementations are
  • JsonMediaTypeFactory,
  • XmlMediaTypeFactory
  • FormMediaTypeFactory
  • TextMediaTypeFactory
Implementations of the RestfulClient interface, such as the HttpRestClient, are initialized with some common MediaTypeFactory instances. You may set an individual User-Agent via UserAgentAccessor.UserAgentMutator.setUserAgent(String), not setting it will result in the default User-Agent to be set as coded into the RestfulClient implementations.