ca.uhn.fhir.validation

Class HapiWorkerContext

java.lang.Object

ca.uhn.fhir.validation.HapiWorkerContext

All Implemented Interfaces:

ValueSetExpander, ValueSetExpanderFactory, IWorkerContext

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

Nested Class Summary

Nested classes/interfaces inherited from interface org.hl7.fhir.instance.utils.IWorkerContext

IWorkerContext.ValidationResult

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

ValueSetExpander.ETooCostly, ValueSetExpander.ValueSetExpansionOutcome

Constructor Summary

Constructors

Constructor and Description
HapiWorkerContext(FhirContext theCtx, IValidationSupport theValidationSupport)

Method Summary

Modifier and Type	Method and Description
ValueSetExpander.ValueSetExpansionOutcome	expand(ValueSet theSource)
ValueSet.ValueSetExpansionComponent	expandVS(ValueSet.ConceptSetComponent theInc) 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) ValueSet Expansion - see $expand
ValueSet	fetchCodeSystem(String theSystem) Find a value set for the nominated system uri.
<T extends Resource> T	fetchResource(Class<T> theClass, String theUri) Find an identified resource.
List<ConceptMap>	findMapsForSource(String theUrl) find concept maps for a source
ValueSetExpander	getExpander()
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.
<T extends Resource> boolean	hasResource(Class<T> theClass_, String theUri) find whether a resource is available.
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
boolean	supportsSystem(String theSystem) True if the underlying terminology service provider will do expansion and code validation for the terminology.
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

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

Constructor Detail

HapiWorkerContext

public HapiWorkerContext(FhirContext theCtx,
                         IValidationSupport theValidationSupport)

Method Detail

expandVS

public ValueSet.ValueSetExpansionComponent expandVS(ValueSet.ConceptSetComponent theInc)

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:

fetchCodeSystem

public ValueSet fetchCodeSystem(String theSystem)

Description copied from interface: IWorkerContext

Find a value set 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)
                                     throws EOperationOutcome,
                                            Exception

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:

Throws:

Exception

EOperationOutcome

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:

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()
                                throws Exception

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

Throws:

Exception

newXmlParser

public IParser newXmlParser()

Description copied from interface: IWorkerContext

Get an XML parser

Specified by:

newXmlParser in interface IWorkerContext

Returns:

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/conformance-supported-system in the Conformance resource

Specified by:

supportsSystem in interface IWorkerContext

Returns:

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:

getExpander

public ValueSetExpander getExpander()

Specified by:

getExpander in interface ValueSetExpanderFactory

expand

public ValueSetExpander.ValueSetExpansionOutcome expand(ValueSet theSource)
                                                 throws ValueSetExpander.ETooCostly,
                                                        Exception

Specified by:

expand in interface ValueSetExpander

Throws:

ValueSetExpander.ETooCostly

Exception

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:

expandVS

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

Description copied from interface: IWorkerContext

ValueSet Expansion - see $expand

Specified by:

expandVS in interface IWorkerContext

Returns:

validateCode

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

Specified by:

validateCode in interface IWorkerContext

validateCode

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

Specified by:

validateCode in interface IWorkerContext