Package org.hl7.fhir.dstu3.utils.client

Class FHIRToolingClient

java.lang.Object

org.hl7.fhir.utilities.FHIRBaseToolingClient

org.hl7.fhir.dstu3.utils.client.FHIRToolingClient

public class FHIRToolingClient
extends org.hl7.fhir.utilities.FHIRBaseToolingClient

Very Simple RESTful client. This is purely for use in the standalone tools jar packages. It doesn't support many features, only what the tools need.

To use, initialize class and set base service URI as follows:

 FHIRSimpleClient fhirClient = new FHIRSimpleClient();
 fhirClient.initialize("http://my.fhir.domain/myServiceRoot");
 

Default Accept and Content-Type headers are application/fhir+xml and application/fhir+json.

These can be changed by invoking the following setter functions:

 setPreferredResourceFormat()
 setPreferredFeedFormat()
 

TODO Review all sad paths.

Author:

Claude Nanjo

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DATE_FORMAT
static final String	DATETIME_FORMAT
static final String	hostKey
static final String	portKey

Fields inherited from class org.hl7.fhir.utilities.FHIRBaseToolingClient

timeoutEntry, timeoutExpand, timeoutLong, timeoutNormal, timeoutOperation, versionInMimeTypes

Constructor Summary

Constructors

Constructor	Description
FHIRToolingClient(String baseServiceUrl, String userAgent)

Method Summary

Modifier and Type	Method	Description
ValueSet	expandValueset(ValueSet source, Parameters expParams)
Bundle	fetchFeed(String url)
org.hl7.fhir.utilities.FhirPublication	getActualVersion()
String	getAddress()
EnumSet<org.hl7.fhir.utilities.FhirPublication>	getAllowedVersions()
<T extends Resource> T	getCanonical(Class<T> resourceClass, String canonicalURL)
CapabilityStatement	getCapabilitiesStatement()
CapabilityStatement	getCapabilitiesStatementQuick()
Client	getClient()
org.hl7.fhir.utilities.ToolingClientLogger	getLogger()
int	getMaximumRecordCount()
String	getPreferredResourceFormat()
int	getRetryCount()
String	getServerVersion()
Parameters	getTerminologyCapabilities()
long	getTimeout()
protected void	handleException(String message, Exception e)	Helper method to prevent nesting of previously thrown EFhirClientExceptions.
void	initialize(String baseServiceUrl)
ConceptMap	initializeClosure(String name)
protected boolean	isJson(String format)	Helper method to determine whether desired resource representation is Json or XML.
Parameters	lookupCode(Map<String,String> params)
Parameters	lookupCode(Parameters p)
<T extends Resource> Parameters	operateType(Class<T> resourceClass, String name, Parameters params)
<T extends Resource> T	read(Class<T> resourceClass, String id)
Bundle	search(String type, String criteria)
void	setAllowedVersions(EnumSet<org.hl7.fhir.utilities.FhirPublication> versions)
void	setClient(Client client)
void	setClientHeaders(Iterable<org.hl7.fhir.utilities.http.HTTPHeader> headers)
void	setLogger(org.hl7.fhir.utilities.ToolingClientLogger logger)
void	setMaximumRecordCount(int maxResultSetSize)
void	setPreferredResourceFormat(ResourceFormat resourceFormat)
void	setRetryCount(int retryCount)
void	setTimeout(long timeout)
EnumSet<org.hl7.fhir.utilities.FhirPublication>	supportableVersions()
Bundle	transaction(Bundle batch)
Parameters	transform(Parameters p)
<T extends Resource> T	update(Class<T> resourceClass, T resource, String id)
Resource	update(Resource resource)
ConceptMap	updateClosure(String name, Coding coding)
<T extends Resource> OperationOutcome	validate(Class<T> resourceClass, T resource, String id)
<T extends Resource> T	vread(Class<T> resourceClass, String id, String version)

Methods inherited from class org.hl7.fhir.utilities.FHIRBaseToolingClient

getTimeoutEntry, getTimeoutExpand, getTimeoutLong, getTimeoutNormal, getTimeoutOperation, isVersionInMimeTypes, setTimeoutEntry, setTimeoutExpand, setTimeoutFactor, setTimeoutLong, setTimeoutNormal, setTimeoutOperation, setVersionInMimeTypes, withVer

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DATETIME_FORMAT

public static final String DATETIME_FORMAT

See Also:

• Constant Field Values

DATE_FORMAT

public static final String DATE_FORMAT

See Also:

• Constant Field Values

hostKey

public static final String hostKey

See Also:

• Constant Field Values

portKey

public static final String portKey

See Also:

• Constant Field Values

Constructor Details

FHIRToolingClient

public FHIRToolingClient(String baseServiceUrl,
 String userAgent)
                  throws URISyntaxException

Throws:

URISyntaxException

Method Details

initialize

public void initialize(String baseServiceUrl)
                throws URISyntaxException

Throws:

URISyntaxException

getClient

public Client getClient()

supportableVersions

public EnumSet<org.hl7.fhir.utilities.FhirPublication> supportableVersions()

setAllowedVersions

public void setAllowedVersions(EnumSet<org.hl7.fhir.utilities.FhirPublication> versions)

getAllowedVersions

public EnumSet<org.hl7.fhir.utilities.FhirPublication> getAllowedVersions()

getActualVersion

public org.hl7.fhir.utilities.FhirPublication getActualVersion()

setClient

public void setClient(Client client)

getPreferredResourceFormat

public String getPreferredResourceFormat()

setPreferredResourceFormat

public void setPreferredResourceFormat(ResourceFormat resourceFormat)

getMaximumRecordCount

public int getMaximumRecordCount()

setMaximumRecordCount

public void setMaximumRecordCount(int maxResultSetSize)

getTerminologyCapabilities

public Parameters getTerminologyCapabilities()

getCapabilitiesStatement

public CapabilityStatement getCapabilitiesStatement()

getCapabilitiesStatementQuick

public CapabilityStatement getCapabilitiesStatementQuick()
                                                  throws EFhirClientException

Throws:

EFhirClientException

read

public <T extends Resource> T read(Class<T> resourceClass,
 String id)

vread

public <T extends Resource> T vread(Class<T> resourceClass,
 String id,
 String version)

getCanonical

public <T extends Resource> T getCanonical(Class<T> resourceClass,
 String canonicalURL)

update

public Resource update(Resource resource)

update

public <T extends Resource> T update(Class<T> resourceClass,
 T resource,
 String id)

operateType

public <T extends Resource> Parameters operateType(Class<T> resourceClass,
 String name,
 Parameters params)

transaction

public Bundle transaction(Bundle batch)

validate

public <T extends Resource> OperationOutcome validate(Class<T> resourceClass,
 T resource,
 String id)

handleException

protected void handleException(String message,
 Exception e)
                        throws EFhirClientException

Helper method to prevent nesting of previously thrown EFhirClientExceptions. If the e param is an instance of EFhirClientException, it will be rethrown. Otherwise, a new EFhirClientException will be thrown with e as the cause.

Parameters:

message - The EFhirClientException message.

e - The exception

Throws:

EFhirClientException - EFhirClientException representing the exception.

isJson

protected boolean isJson(String format)

Helper method to determine whether desired resource representation is Json or XML.

Parameters:

format - the format

Returns:

true if the format is JSON, false otherwise

fetchFeed

public Bundle fetchFeed(String url)

lookupCode

public Parameters lookupCode(Map<String,String> params)

lookupCode

public Parameters lookupCode(Parameters p)

transform

public Parameters transform(Parameters p)

expandValueset

public ValueSet expandValueset(ValueSet source,
 Parameters expParams)

getAddress

public String getAddress()

initializeClosure

public ConceptMap initializeClosure(String name)

updateClosure

public ConceptMap updateClosure(String name,
 Coding coding)

getTimeout

public long getTimeout()

setTimeout

public void setTimeout(long timeout)

getLogger

public org.hl7.fhir.utilities.ToolingClientLogger getLogger()

setLogger

public void setLogger(org.hl7.fhir.utilities.ToolingClientLogger logger)

getRetryCount

public int getRetryCount()

setRetryCount

public void setRetryCount(int retryCount)

setClientHeaders

public void setClientHeaders(Iterable<org.hl7.fhir.utilities.http.HTTPHeader> headers)

getServerVersion

public String getServerVersion()

search

public Bundle search(String type,
 String criteria)