HAPI FHIR miscellaneous coding tricks

Russell Bateman
February 2024
last update: 02/08/2024 23:50:36




I finally got around to composing some beginning notes on HAPI FHIR data structures and how to use them. I am also scraping together some tricks I use to boilerplate their use, reduce complexity, save vertical space, etc.

Also, these notes go a very long way to connect HAPI FHIR (Java) coding to what you're used to seeing in formal HL7FHIR standard documentation.

Often at first, it puzzled me as whether to use a value, a coding, the display or the text. There is not a great number of good examples or sample code for HAPI FHIR. I have tried to gather the antidote for that in my various HAPI FHIR notes on this site.


CodeableConcept, how it works and tricks in using it...

Let's examine HAPI FHIR CodeableConcept. I'm going to use the instance consumed by FHIR Condition to explore this. At the link just here, scroll down to field clinicalStatus for the context of this illustration.

Creating clinicalStatus from scratch...

...for a Condition using subfields text or coding: 

view source
print?
01.import java.util.ArrayList;
02.import java.util.List;
03. 
04.import org.hl7.fhir.r4.model.CodeableConcept;
05.import org.hl7.fhir.r4.model.Coding;
06.import org.hl7.fhir.r4.model.Condition;
07.import com.windofkeltia.fhir.FhirCode;
08. 
09.Condition condition = new Condition();
10. 
11.condition.setClinicalStatus( new CodeableConcept().setCoding( FhirCode.addCode( "active" ) ) );
12. 
13.condition.setClinicalStatus( new CodeableConcept().setText( "The subject is currently experiencing the condition" ) );

Extracting clinicalStatus from an existing...

...Condition's text or coding subfields: 

view source
print?
01.fhirPath = "Condition.clinicalStatus";    // hmmm... this isn't exactly right
02. 
03.// Model-level stuff
04.// Imagine we're passed a Condition and need to dig out the important thing:
05.if( condition.hasClinicalStatus() )
06.{
07.  String          text           = null;
08.  String          code           = null;
09.  CodeableConcept clinicalStatus = condition.getClinicalStatus();
10. 
11.  if( clinicalStatus.hasCoding() )        // prioritize what's in the Coding
12.  {
13.    Coding coding = clinicalStatus.getCodingFirstRep();
14.    coding.getCode();
15.  }
16.  else if( clinicalStatus.hasText() )     // accept text only if that's all there is
17.  {
18.    text = clinicalStatus.getText();
19.  }
20. 
21.  // surfacing the results to the View-level:
22.  if( !StringUtilities.isEmpty( code ) )
23.    ...
24.  else if( !StringUtilities.isEmpty( text ) )
25.    ...
26.}

FhirCode.java:

Here's a method I use to build an obligatory list that only needs one element and keep it on one line in the caller. 

view source
print?
01./**
02. * Helper (static) method to add the passed-in code to a Coding
03. * for a list of codings in creating a CodeableConcept. This
04. * facilitates writing code such as:
05. *
06. * CodeableConcept codeableConcept = new CodeableConcept().setCoding( addCode( "active" ) );
07. *
08. * @param code the exact code as a string.
09. * @return the list that a method such as in the sample code above might take.
10. */
11.public static List< Coding > addCode( final String code )
12.{
13.  Coding         coding = new Coding();      coding.setCode( code );
14.  List< Coding > list   = new ArrayList<>(); list.add( coding );
15.  return list;
16.}