ca.uhn.fhir.rest.client.api

Interface IRestfulClient

All Known Subinterfaces:

IBasicClient, IGenericClient

public interface IRestfulClient

Method Summary

Modifier and Type	Method and Description
<T extends IBaseResource> T	fetchResourceFromUrl(Class<T> theResourceType, String theUrl) Retrieve the contents at the given URL and parse them as a resource.
EncodingEnum	getEncoding() Returns the encoding that will be used on requests.
FhirContext	getFhirContext() Returns the FHIR context associated with this client
IHttpClient	getHttpClient() Do not call this method in client code.
List<IClientInterceptor>	getInterceptors() Returns the client interceptors that have been registered with this client
String	getServerBase() Base URL for the server, with no trailing "/"
void	registerInterceptor(IClientInterceptor theInterceptor) Register a new interceptor for this client.
void	setEncoding(EncodingEnum theEncoding) Specifies that the client should use the given encoding to do its queries.
void	setPrettyPrint(Boolean thePrettyPrint) Specifies that the client should request that the server respond with "pretty printing" enabled.
void	setSummary(SummaryEnum theSummary) If not set to null, specifies a value for the _summary parameter to be applied globally on this client.
void	unregisterInterceptor(IClientInterceptor theInterceptor) Remove an intercaptor that was previously registered using registerInterceptor(IClientInterceptor)

Method Detail

fetchResourceFromUrl

<T extends IBaseResource> T fetchResourceFromUrl(Class<T> theResourceType,
                                                 String theUrl)

Retrieve the contents at the given URL and parse them as a resource. This method could be used as a low level implementation of a read/vread/search operation.

Parameters:

theResourceType - The resource type to parse

theUrl - The URL to load

Returns:

The parsed resource

getEncoding

EncodingEnum getEncoding()

Returns the encoding that will be used on requests. Default is null, which means the client will not explicitly request an encoding. (This is standard behaviour according to the FHIR specification)

getFhirContext

FhirContext getFhirContext()

Returns the FHIR context associated with this client

getHttpClient

IHttpClient getHttpClient()

Do not call this method in client code. It is a part of the internal HAPI API and is subject to change!

getInterceptors

List<IClientInterceptor> getInterceptors()

Returns the client interceptors that have been registered with this client

getServerBase

String getServerBase()

Base URL for the server, with no trailing "/"

registerInterceptor

void registerInterceptor(IClientInterceptor theInterceptor)

Register a new interceptor for this client. An interceptor can be used to add additional logging, or add security headers, or pre-process responses, etc.

setEncoding

void setEncoding(EncodingEnum theEncoding)

Specifies that the client should use the given encoding to do its queries. This means that the client will append the "_format" param to GET methods (read/search/etc), and will add an appropriate header for write methods.

Parameters:

theEncoding - The encoding to use in the request, or null not specify an encoding (which generally implies the use of XML). The default is null.

setPrettyPrint

void setPrettyPrint(Boolean thePrettyPrint)

Specifies that the client should request that the server respond with "pretty printing" enabled. Note that this is a non-standard parameter, not all servers will support it.

Parameters:

thePrettyPrint - The pretty print flag to use in the request (default is false)

setSummary

void setSummary(SummaryEnum theSummary)

If not set to null, specifies a value for the _summary parameter to be applied globally on this client.

unregisterInterceptor

void unregisterInterceptor(IClientInterceptor theInterceptor)

Remove an intercaptor that was previously registered using registerInterceptor(IClientInterceptor)