org.hl7.fhir.dstu3.hapi.validation

Class HapiWorkerContext

java.lang.Object

org.hl7.fhir.dstu3.hapi.validation.HapiWorkerContext

All Implemented Interfaces:

IWorkerContext, ValueSetExpander, ValueSetExpanderFactory

public final class HapiWorkerContext
extends Object
implements IWorkerContext, ValueSetExpander, ValueSetExpanderFactory

Nested Class Summary

Nested classes/interfaces inherited from interface org.hl7.fhir.dstu3.context.IWorkerContext

IWorkerContext.ILoggingService, IWorkerContext.ValidationResult

Nested classes/interfaces inherited from interface org.hl7.fhir.dstu3.terminologies.ValueSetExpander

ValueSetExpander.ETooCostly, ValueSetExpander.TerminologyServiceErrorClass, ValueSetExpander.ValueSetExpansionOutcome

Constructor Summary

Constructors

Constructor and Description
HapiWorkerContext(FhirContext theCtx, IValidationSupport theValidationSupport)

Method Summary

Modifier and Type	Method and Description
List<MetadataResource>	allConformanceResources()
List<StructureDefinition>	allStructures()
ValueSetExpander.ValueSetExpansionOutcome	expand(ValueSet theSource, ExpansionProfile theProfile)
ValueSet.ValueSetExpansionComponent	expandVS(ValueSet.ConceptSetComponent theInc, boolean theHeiarchical) Value set expanion inside the internal expansion engine - used for references to supported system (see "supportsSystem") for which there is no value set.
ValueSetExpander.ValueSetExpansionOutcome	expandVS(ValueSet theSource, boolean theCacheOk, boolean theHeiarchical) ValueSet Expansion - see $expand
CodeSystem	fetchCodeSystem(String theSystem) Find the code system definition for the nominated system uri.
<T extends Resource> T	fetchResource(Class<T> theClass, String theUri) Find an identified resource.
<T extends Resource> T	fetchResourceWithException(Class<T> theClass_, String theUri)
List<ConceptMap>	findMapsForSource(String theUrl) find concept maps for a source
String	getAbbreviation(String theName) returns the recommended tla for the type
ValueSetExpander	getExpander()
ExpansionProfile	getExpansionProfile()
INarrativeGenerator	getNarrativeGenerator(String thePrefix, String theBasePath) Get a generator that can generate narrative for the instance
IParser	getParser(ParserType theType) Get a parser to read/write instances.
IParser	getParser(String theType) Get a parser to read/write instances.
List<String>	getResourceNames()
List<String>	getTypeNames()
String	getVersion() Get the versions of the definitions loaded in context
boolean	hasCache()
<T extends Resource> boolean	hasResource(Class<T> theClass_, String theUri) find whether a resource is available.
boolean	isNoTerminologyServer()
IParser	newJsonParser() Get a JSON parser
IResourceValidator	newValidator() Get a validator that can check whether a resource is valid
IParser	newXmlParser() Get an XML parser
String	oid2Uri(String theCode)
void	setExpansionProfile(ExpansionProfile theExpProfile)
void	setLogger(IWorkerContext.ILoggingService theLogger)
boolean	supportsSystem(String theSystem) True if the underlying terminology service provider will do expansion and code validation for the terminology.
Set<String>	typeTails()
IWorkerContext.ValidationResult	validateCode(CodeableConcept theCode, ValueSet theVs)
IWorkerContext.ValidationResult	validateCode(Coding theCode, ValueSet theVs)
IWorkerContext.ValidationResult	validateCode(String theSystem, String theCode, String theDisplay) Validation of a code - consult the terminology service to see whether it is known.
IWorkerContext.ValidationResult	validateCode(String theSystem, String theCode, String theDisplay, ValueSet.ConceptSetComponent theVsi) Validation of a code - consult the terminology service to see whether it is known.
IWorkerContext.ValidationResult	validateCode(String theSystem, String theCode, String theDisplay, ValueSet theVs) Validation of a code - consult the terminology service to see whether it is known.

Methods inherited from class java.lang.Object

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

Constructor Detail

HapiWorkerContext

public HapiWorkerContext(FhirContext theCtx,
                         IValidationSupport theValidationSupport)

Method Detail

allStructures

public List<StructureDefinition> allStructures()

Specified by:

allStructures in interface IWorkerContext

fetchCodeSystem

public CodeSystem fetchCodeSystem(String theSystem)

Description copied from interface: IWorkerContext

Find the code system definition for the nominated system uri. return null if there isn't one (then the tool might try supportsSystem)

Specified by:

fetchCodeSystem in interface IWorkerContext

Returns:

fetchResource

public <T extends Resource> T fetchResource(Class<T> theClass,
                                            String theUri)

Description copied from interface: IWorkerContext

Find an identified resource. The most common use of this is to access the the standard conformance resources that are part of the standard - structure definitions, value sets, concept maps, etc. Also, the narrative generator uses this, and may access any kind of resource The URI is called speculatively for things that might exist, so not finding a matching resouce, return null, not an error The URI can have one of 3 formats: - a full URL e.g. http://acme.org/fhir/ValueSet/[id] - a relative URL e.g. ValueSet/[id] - a logical id e.g. [id] It's an error if the second form doesn't agree with class_. It's an error if class_ is null for the last form

Specified by:

fetchResource in interface IWorkerContext

Returns:

findMapsForSource

public List<ConceptMap> findMapsForSource(String theUrl)

Description copied from interface: IWorkerContext

find concept maps for a source

Specified by:

findMapsForSource in interface IWorkerContext

Returns:

getAbbreviation

public String getAbbreviation(String theName)

Description copied from interface: IWorkerContext

returns the recommended tla for the type

Specified by:

getAbbreviation in interface IWorkerContext

Returns:

getExpander

public ValueSetExpander getExpander()

Specified by:

getExpander in interface ValueSetExpanderFactory

getNarrativeGenerator

public INarrativeGenerator getNarrativeGenerator(String thePrefix,
                                                 String theBasePath)

Description copied from interface: IWorkerContext

Get a generator that can generate narrative for the instance

Specified by:

getNarrativeGenerator in interface IWorkerContext

Returns:

a prepared generator

getParser

public IParser getParser(ParserType theType)

Description copied from interface: IWorkerContext

Get a parser to read/write instances. Use the defined type (will be extended as further types are added, though the only currently anticipate type is RDF) XML/JSON - the standard renderers XHTML - render the narrative only (generate it if necessary)

Specified by:

getParser in interface IWorkerContext

Returns:

getParser

public IParser getParser(String theType)

Description copied from interface: IWorkerContext

Get a parser to read/write instances. Determine the type from the stated type. Supported value for type: - the recommended MIME types - variants of application/xml and application/json - _format values xml, json

Specified by:

getParser in interface IWorkerContext

Returns:

getResourceNames

public List<String> getResourceNames()

Specified by:

getResourceNames in interface IWorkerContext

hasResource

public <T extends Resource> boolean hasResource(Class<T> theClass_,
                                                String theUri)

Description copied from interface: IWorkerContext

find whether a resource is available. Implementations of the interface can assume that if hasResource ruturns true, the resource will usually be fetched subsequently

Specified by:

hasResource in interface IWorkerContext

Returns:

newJsonParser

public IParser newJsonParser()

Description copied from interface: IWorkerContext

Get a JSON parser

Specified by:

newJsonParser in interface IWorkerContext

Returns:

newValidator

public IResourceValidator newValidator()

Description copied from interface: IWorkerContext

Get a validator that can check whether a resource is valid

Specified by:

newValidator in interface IWorkerContext

Returns:

a prepared generator

newXmlParser

public IParser newXmlParser()

Description copied from interface: IWorkerContext

Get an XML parser

Specified by:

newXmlParser in interface IWorkerContext

Returns:

oid2Uri

public String oid2Uri(String theCode)

Specified by:

oid2Uri in interface IWorkerContext

supportsSystem

public boolean supportsSystem(String theSystem)

Description copied from interface: IWorkerContext

True if the underlying terminology service provider will do expansion and code validation for the terminology. Corresponds to the extension http://hl7.org/fhir/StructureDefinition/capabilitystatement-supported-system in the Conformance resource

Specified by:

supportsSystem in interface IWorkerContext

Returns:

typeTails

public Set<String> typeTails()

Specified by:

typeTails in interface IWorkerContext

validateCode

public IWorkerContext.ValidationResult validateCode(CodeableConcept theCode,
                                                    ValueSet theVs)

Specified by:

validateCode in interface IWorkerContext

validateCode

public IWorkerContext.ValidationResult validateCode(Coding theCode,
                                                    ValueSet theVs)

Specified by:

validateCode in interface IWorkerContext

validateCode

public IWorkerContext.ValidationResult validateCode(String theSystem,
                                                    String theCode,
                                                    String theDisplay)

Description copied from interface: IWorkerContext

Validation of a code - consult the terminology service to see whether it is known. If known, return a description of it note: always return a result, with either an error or a code description corresponds to 2 terminology service calls: $validate-code and $lookup

Specified by:

validateCode in interface IWorkerContext

Returns:

validateCode

public IWorkerContext.ValidationResult validateCode(String theSystem,
                                                    String theCode,
                                                    String theDisplay,
                                                    ValueSet.ConceptSetComponent theVsi)

Description copied from interface: IWorkerContext

Validation of a code - consult the terminology service to see whether it is known. If known, return a description of it Also, check whether it's in the provided value set fragment (for supported systems with no value set definition) note: always return a result, with either an error or a code description, or both (e.g. known code, but not in the value set) corresponds to 2 terminology service calls: $validate-code and $lookup

Specified by:

validateCode in interface IWorkerContext

Returns:

validateCode

public IWorkerContext.ValidationResult validateCode(String theSystem,
                                                    String theCode,
                                                    String theDisplay,
                                                    ValueSet theVs)

Description copied from interface: IWorkerContext

Validation of a code - consult the terminology service to see whether it is known. If known, return a description of it Also, check whether it's in the provided value set note: always return a result, with either an error or a code description, or both (e.g. known code, but not in the value set) corresponds to 2 terminology service calls: $validate-code and $lookup

Specified by:

validateCode in interface IWorkerContext

Returns:

allConformanceResources

public List<MetadataResource> allConformanceResources()

Specified by:

allConformanceResources in interface IWorkerContext

hasCache

public boolean hasCache()

Specified by:

hasCache in interface IWorkerContext

expand

public ValueSetExpander.ValueSetExpansionOutcome expand(ValueSet theSource,
                                                        ExpansionProfile theProfile)

Specified by:

expand in interface ValueSetExpander

Parameters:

theSource - the value set definition to expand

theProfile - a profile affecting the outcome. If you don't supply a profile, the default internal expansion profile will be used.

Returns:

getExpansionProfile

public ExpansionProfile getExpansionProfile()

Specified by:

getExpansionProfile in interface IWorkerContext

setExpansionProfile

public void setExpansionProfile(ExpansionProfile theExpProfile)

Specified by:

setExpansionProfile in interface IWorkerContext

expandVS

public ValueSetExpander.ValueSetExpansionOutcome expandVS(ValueSet theSource,
                                                          boolean theCacheOk,
                                                          boolean theHeiarchical)

Description copied from interface: IWorkerContext

ValueSet Expansion - see $expand

Specified by:

expandVS in interface IWorkerContext

Returns:

expandVS

public ValueSet.ValueSetExpansionComponent expandVS(ValueSet.ConceptSetComponent theInc,
                                                    boolean theHeiarchical)
                                             throws TerminologyServiceException

Description copied from interface: IWorkerContext

Value set expanion inside the internal expansion engine - used for references to supported system (see "supportsSystem") for which there is no value set.

Specified by:

expandVS in interface IWorkerContext

Returns:

Throws:

TerminologyServiceException

setLogger

public void setLogger(IWorkerContext.ILoggingService theLogger)

Specified by:

setLogger in interface IWorkerContext

getVersion

public String getVersion()

Description copied from interface: IWorkerContext

Get the versions of the definitions loaded in context

Specified by:

getVersion in interface IWorkerContext

Returns:

isNoTerminologyServer

public boolean isNoTerminologyServer()

Specified by:

isNoTerminologyServer in interface IWorkerContext

fetchResourceWithException

public <T extends Resource> T fetchResourceWithException(Class<T> theClass_,
                                                         String theUri)
                                                  throws FHIRException

Specified by:

fetchResourceWithException in interface IWorkerContext

Throws:

FHIRException

getTypeNames

public List<String> getTypeNames()

Specified by:

getTypeNames in interface IWorkerContext