Package org.hl7.fhir.r4.utils.client

Class FHIRToolingClient

java.lang.Object

org.hl7.fhir.r4.utils.client.FHIRToolingClient

public class FHIRToolingClient
extends Object

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 String	DATE_FORMAT
static String	DATETIME_FORMAT
static String	hostKey
static String	portKey

Constructor Summary

Constructors

Constructor	Description
FHIRToolingClient(String baseServiceUrl)
FHIRToolingClient(String baseServiceUrl, String username, String password)

Method Summary

Modifier and Type	Method	Description
void	configureProxy(String proxyHost, int proxyPort)
void	detectProxy()
ValueSet	expandValueset(ValueSet source, Parameters expParams)
ValueSet	expandValueset(ValueSet source, Parameters expParams, Map<String,String> params)
Bundle	fetchFeed(String url)
String	getAddress()
<T extends Resource> T	getCanonical(Class<T> resourceClass, String canonicalURL)
CapabilityStatement	getCapabilitiesStatement()
CapabilityStatement	getCapabilitiesStatementQuick()
org.hl7.fhir.utilities.ToolingClientLogger	getLogger()
int	getMaximumRecordCount()
String	getPassword()
String	getPreferredResourceFormat()
int	getRetryCount()
TerminologyCapabilities	getTerminologyCapabilities()
int	getTimeout()
String	getUsername()
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)
<T extends Resource> Parameters	operateType(Class<T> resourceClass, String name, Parameters params)
<T extends Resource> T	read(Class<T> resourceClass, String id)
void	setLogger(org.hl7.fhir.utilities.ToolingClientLogger logger)
void	setMaximumRecordCount(int maxResultSetSize)
void	setPassword(String password)
void	setPreferredResourceFormat(ResourceFormat resourceFormat)
void	setRetryCount(int retryCount)
void	setTimeout(int timeout)
void	setUsername(String username)
Bundle	transaction(Bundle batch)
<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 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)
                  throws URISyntaxException

Throws:

URISyntaxException

FHIRToolingClient

public FHIRToolingClient(String baseServiceUrl,
 String username,
 String password)
                  throws URISyntaxException

Throws:

URISyntaxException

Method Details

configureProxy

public void configureProxy(String proxyHost,
 int proxyPort)

detectProxy

public void detectProxy()

initialize

public void initialize(String baseServiceUrl)
                throws URISyntaxException

Throws:

URISyntaxException

getPreferredResourceFormat

public String getPreferredResourceFormat()

setPreferredResourceFormat

public void setPreferredResourceFormat(ResourceFormat resourceFormat)

getMaximumRecordCount

public int getMaximumRecordCount()

setMaximumRecordCount

public void setMaximumRecordCount(int maxResultSetSize)

getTerminologyCapabilities

public TerminologyCapabilities 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

Parameters:

e -

Throws:

EFhirClientException

isJson

protected boolean isJson(String format)

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

Parameters:

format -

Returns:

fetchFeed

public Bundle fetchFeed(String url)

expandValueset

public ValueSet expandValueset(ValueSet source,
 Parameters expParams)

lookupCode

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

expandValueset

public ValueSet expandValueset(ValueSet source,
 Parameters expParams,
 Map<String,String> params)

getAddress

public String getAddress()

initializeClosure

public ConceptMap initializeClosure(String name)

updateClosure

public ConceptMap updateClosure(String name,
 Coding coding)

getTimeout

public int getTimeout()

setTimeout

public void setTimeout(int timeout)

getUsername

public String getUsername()

setUsername

public void setUsername(String username)

getPassword

public String getPassword()

setPassword

public void setPassword(String password)

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)