Package org.hl7.fhir.common.hapi.validation.support

Class RemoteTerminologyServiceValidationSupport

java.lang.Object
org.hl7.fhir.common.hapi.validation.support.BaseValidationSupport
org.hl7.fhir.common.hapi.validation.support.RemoteTerminologyServiceValidationSupport
All Implemented Interfaces:
ca.uhn.fhir.context.support.IValidationSupport
public class RemoteTerminologyServiceValidationSupport extends BaseValidationSupport implements ca.uhn.fhir.context.support.IValidationSupport
This class is an implementation of IValidationSupport that fetches validation codes from a remote FHIR based terminology server. It will invoke the FHIR ValueSet/$validate-code operation in order to validate codes.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static interface 
    RemoteTerminologyServiceValidationSupport.ValidationErrorMessageBuilder
     

    Nested classes/interfaces inherited from interface ca.uhn.fhir.context.support.IValidationSupport

    ca.uhn.fhir.context.support.IValidationSupport.BaseConceptProperty, ca.uhn.fhir.context.support.IValidationSupport.BooleanConceptProperty, ca.uhn.fhir.context.support.IValidationSupport.CodeValidationIssue, ca.uhn.fhir.context.support.IValidationSupport.CodeValidationIssueCode, ca.uhn.fhir.context.support.IValidationSupport.CodeValidationIssueCoding, ca.uhn.fhir.context.support.IValidationSupport.CodeValidationIssueDetails, ca.uhn.fhir.context.support.IValidationSupport.CodeValidationResult, ca.uhn.fhir.context.support.IValidationSupport.CodingConceptProperty, ca.uhn.fhir.context.support.IValidationSupport.ConceptDesignation, ca.uhn.fhir.context.support.IValidationSupport.GroupConceptProperty, ca.uhn.fhir.context.support.IValidationSupport.IssueSeverity, ca.uhn.fhir.context.support.IValidationSupport.LookupCodeResult, ca.uhn.fhir.context.support.IValidationSupport.StringConceptProperty, ca.uhn.fhir.context.support.IValidationSupport.TranslateCodeRequest, ca.uhn.fhir.context.support.IValidationSupport.ValueSetExpansionOutcome

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    ERROR_CODE_UNKNOWN_CODE_IN_CODE_SYSTEM
     
    static final String
    ERROR_CODE_UNKNOWN_CODE_IN_VALUE_SET
     

    Fields inherited from class org.hl7.fhir.common.hapi.validation.support.BaseValidationSupport

    myCtx

    Fields inherited from interface ca.uhn.fhir.context.support.IValidationSupport

    TYPE_BOOLEAN, TYPE_CODING, TYPE_GROUP, TYPE_STRING, URL_PREFIX_VALUE_SET

  • Constructor Summary

    Constructors
    Constructor
    Description
    RemoteTerminologyServiceValidationSupport(ca.uhn.fhir.context.FhirContext theFhirContext)
    Constructor
    RemoteTerminologyServiceValidationSupport(ca.uhn.fhir.context.FhirContext theFhirContext, String theBaseUrl)
    Constructor
    RemoteTerminologyServiceValidationSupport(ca.uhn.fhir.context.FhirContext theFhirContext, String theBaseUrl, ca.uhn.fhir.rest.client.api.IRestfulClientFactory theRestfulClientFactory)
    Constructor

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addClientInterceptor(Object theClientInterceptor)
    Adds an interceptor that will be registered to all clients.
    protected org.hl7.fhir.instance.model.api.IBaseParameters
    buildValidateCodeInputParameters(String theCodeSystem, String theCode, String theDisplay, String theValueSetUrl, org.hl7.fhir.instance.model.api.IBaseResource theValueSet)
     
    static Optional<Collection<ca.uhn.fhir.context.support.IValidationSupport.CodeValidationIssue>>
    createCodeValidationIssues(org.hl7.fhir.instance.model.api.IBaseOperationOutcome theOperationOutcome, ca.uhn.fhir.context.FhirVersionEnum theFhirVersion)
    Creates a list of IValidationSupport.CodeValidationIssue from the issues returned by the $validate-code operation.
    static ca.uhn.fhir.context.support.IValidationSupport.BaseConceptProperty
    createConceptProperty(String theName, org.hl7.fhir.instance.model.api.IBaseDatatype theValue)
     
    org.hl7.fhir.instance.model.api.IBaseResource
    fetchCodeSystem(String theSystem)
     
    org.hl7.fhir.instance.model.api.IBaseResource
    fetchValueSet(String theValueSetUrl)
     
    String
    getBaseUrl()
     
    protected String
    getErrorMessage(String errorCode, Object... theParams)
     
    String
    getName()
     
    protected ca.uhn.fhir.context.support.IValidationSupport.CodeValidationResult
    invokeRemoteValidateCode(String theCodeSystem, String theCode, String theDisplay, String theValueSetUrl, org.hl7.fhir.instance.model.api.IBaseResource theValueSet)
     
    boolean
    isCodeSystemSupported(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, String theSystem)
     
    boolean
    isValueSetSupported(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, String theValueSetUrl)
     
    ca.uhn.fhir.context.support.IValidationSupport.LookupCodeResult
    lookupCode(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, ca.uhn.fhir.context.support.LookupCodeRequest theLookupCodeRequest)
     
    void
    setBaseUrl(String theBaseUrl)
    Sets the FHIR Terminology Server base URL
    ca.uhn.fhir.context.support.TranslateConceptResults
    translateConcept(ca.uhn.fhir.context.support.IValidationSupport.TranslateCodeRequest theRequest)
     
    ca.uhn.fhir.context.support.IValidationSupport.CodeValidationResult
    validateCode(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, ca.uhn.fhir.context.support.ConceptValidationOptions theOptions, String theCodeSystem, String theCode, String theDisplay, String theValueSetUrl)
     
    ca.uhn.fhir.context.support.IValidationSupport.CodeValidationResult
    validateCodeInValueSet(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, ca.uhn.fhir.context.support.ConceptValidationOptions theOptions, String theCodeSystem, String theCode, String theDisplay, org.hl7.fhir.instance.model.api.IBaseResource theValueSet)
     

    Methods inherited from class org.hl7.fhir.common.hapi.validation.support.BaseValidationSupport

    getFhirContext

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface ca.uhn.fhir.context.support.IValidationSupport

    expandValueSet, expandValueSet, fetchAllConformanceResources, fetchAllNonBaseStructureDefinitions, fetchAllSearchParameters, fetchAllStructureDefinitions, fetchBinary, fetchResource, fetchStructureDefinition, generateSnapshot, getFhirContext, invalidateCaches, isCodeableConceptValidationSuccessfulIfNotAllCodingsAreValid, isRemoteTerminologyServiceConfigured, lookupCode, lookupCode

  • Field Details

  • Constructor Details

    • RemoteTerminologyServiceValidationSupport

      public RemoteTerminologyServiceValidationSupport(ca.uhn.fhir.context.FhirContext theFhirContext)
      Constructor
      Parameters:
      theFhirContext - The FhirContext. Will be used to create a FHIR client for remote terminology requests.

    • RemoteTerminologyServiceValidationSupport

      public RemoteTerminologyServiceValidationSupport(ca.uhn.fhir.context.FhirContext theFhirContext, String theBaseUrl)
      Constructor
      Parameters:
      theFhirContext - The FhirContext. Will be used to create a FHIR client for remote terminology requests.
      theBaseUrl - The url used for the remote terminology FHIR client.

    • RemoteTerminologyServiceValidationSupport

      public RemoteTerminologyServiceValidationSupport(ca.uhn.fhir.context.FhirContext theFhirContext, String theBaseUrl, @Nullable ca.uhn.fhir.rest.client.api.IRestfulClientFactory theRestfulClientFactory)
      Constructor
      Parameters:
      theFhirContext - The FhirContext.
      theBaseUrl - The url used for the remote terminology FHIR client.
      theRestfulClientFactory - Used to create the remote terminology FHIR client. If this is not supplied, a client will be created from the FhirContext

  • Method Details

    • getName

      public String getName()
      Specified by:
      getName in interface ca.uhn.fhir.context.support.IValidationSupport

    • validateCode

      public ca.uhn.fhir.context.support.IValidationSupport.CodeValidationResult validateCode(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, ca.uhn.fhir.context.support.ConceptValidationOptions theOptions, String theCodeSystem, String theCode, String theDisplay, String theValueSetUrl)
      Specified by:
      validateCode in interface ca.uhn.fhir.context.support.IValidationSupport

    • validateCodeInValueSet

      public ca.uhn.fhir.context.support.IValidationSupport.CodeValidationResult validateCodeInValueSet(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, ca.uhn.fhir.context.support.ConceptValidationOptions theOptions, String theCodeSystem, String theCode, String theDisplay, @Nonnull org.hl7.fhir.instance.model.api.IBaseResource theValueSet)
      Specified by:
      validateCodeInValueSet in interface ca.uhn.fhir.context.support.IValidationSupport

    • fetchCodeSystem

      public org.hl7.fhir.instance.model.api.IBaseResource fetchCodeSystem(String theSystem)
      Specified by:
      fetchCodeSystem in interface ca.uhn.fhir.context.support.IValidationSupport

    • lookupCode

      public ca.uhn.fhir.context.support.IValidationSupport.LookupCodeResult lookupCode(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, @Nonnull ca.uhn.fhir.context.support.LookupCodeRequest theLookupCodeRequest)
      Specified by:
      lookupCode in interface ca.uhn.fhir.context.support.IValidationSupport

    • getErrorMessage

      protected String getErrorMessage(String errorCode, Object... theParams)

    • createConceptProperty

      public static ca.uhn.fhir.context.support.IValidationSupport.BaseConceptProperty createConceptProperty(String theName, org.hl7.fhir.instance.model.api.IBaseDatatype theValue)

    • fetchValueSet

      public org.hl7.fhir.instance.model.api.IBaseResource fetchValueSet(String theValueSetUrl)
      Specified by:
      fetchValueSet in interface ca.uhn.fhir.context.support.IValidationSupport

    • isCodeSystemSupported

      public boolean isCodeSystemSupported(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, String theSystem)
      Specified by:
      isCodeSystemSupported in interface ca.uhn.fhir.context.support.IValidationSupport

    • isValueSetSupported

      public boolean isValueSetSupported(ca.uhn.fhir.context.support.ValidationSupportContext theValidationSupportContext, String theValueSetUrl)
      Specified by:
      isValueSetSupported in interface ca.uhn.fhir.context.support.IValidationSupport

    • translateConcept

      public ca.uhn.fhir.context.support.TranslateConceptResults translateConcept(ca.uhn.fhir.context.support.IValidationSupport.TranslateCodeRequest theRequest)
      Specified by:
      translateConcept in interface ca.uhn.fhir.context.support.IValidationSupport

    • getBaseUrl

      public String getBaseUrl()

    • invokeRemoteValidateCode

      protected ca.uhn.fhir.context.support.IValidationSupport.CodeValidationResult invokeRemoteValidateCode(String theCodeSystem, String theCode, String theDisplay, String theValueSetUrl, org.hl7.fhir.instance.model.api.IBaseResource theValueSet)

    • createCodeValidationIssues

      public static Optional<Collection<ca.uhn.fhir.context.support.IValidationSupport.CodeValidationIssue>> createCodeValidationIssues(org.hl7.fhir.instance.model.api.IBaseOperationOutcome theOperationOutcome, ca.uhn.fhir.context.FhirVersionEnum theFhirVersion)
      Creates a list of IValidationSupport.CodeValidationIssue from the issues returned by the $validate-code operation. Please note that this method should only be used for Remote Terminology for now as it only translates issues text/message and assumes all other fields. When issues will be supported across all validators in hapi-fhir, a proper generic conversion method should be available and this method will be deleted.
      Parameters:
      theOperationOutcome - the outcome of the $validate-code operation
      theFhirVersion - the FHIR version
      Returns:
      the list of IValidationSupport.CodeValidationIssue

    • buildValidateCodeInputParameters

      protected org.hl7.fhir.instance.model.api.IBaseParameters buildValidateCodeInputParameters(String theCodeSystem, String theCode, String theDisplay, String theValueSetUrl, org.hl7.fhir.instance.model.api.IBaseResource theValueSet)

    • setBaseUrl

      public void setBaseUrl(String theBaseUrl)
      Sets the FHIR Terminology Server base URL
      Parameters:
      theBaseUrl - The base URL, e.g. "..."

    • addClientInterceptor

      public void addClientInterceptor(@Nonnull Object theClientInterceptor)
      Adds an interceptor that will be registered to all clients.

      Note that this method is not thread-safe and should only be called prior to this module being used.

      Parameters:
      theClientInterceptor - The interceptor (must not be null)