Package org.linuxforhealth.fhir.term.graph.provider

Class GraphTermServiceProvider

java.lang.Object

org.linuxforhealth.fhir.term.spi.AbstractTermServiceProvider

org.linuxforhealth.fhir.term.graph.provider.GraphTermServiceProvider

All Implemented Interfaces:

FHIRTermServiceProvider

public class GraphTermServiceProvider
extends AbstractTermServiceProvider

Graph-based implementation of the FHIRTermServiceProvider interface using FHIRTermGraph

Field Summary

Fields

Modifier and Type	Field	Description
static int	DEFAULT_TIME_LIMIT

Constructor Summary

Constructors

Constructor	Description
GraphTermServiceProvider(org.apache.commons.configuration2.Configuration configuration)
GraphTermServiceProvider(org.apache.commons.configuration2.Configuration configuration, int timeLimit)
GraphTermServiceProvider(FHIRTermGraph graph)
GraphTermServiceProvider(FHIRTermGraph graph, int timeLimit)

Method Summary

Modifier and Type	Method	Description
java.util.Map<Code,java.util.Set<CodeSystem.Concept>>	closure(CodeSystem codeSystem, java.util.Set<Code> codes)	Get a map of sets containing CodeSystem.Concept instances where all structural hierarchies have been flattened
java.util.Set<CodeSystem.Concept>	closure(CodeSystem codeSystem, Code code)	Get a set containing CodeSystem.Concept instances where all structural hierarchies have been flattened.
CodeSystem.Concept	getConcept(CodeSystem codeSystem, Code code)	Get the concept in the provided code system with the specified code.
java.util.Set<CodeSystem.Concept>	getConcepts(CodeSystem codeSystem)	Get a set containing CodeSystem.Concept instances where all structural hierarchies have been flattened.
<R> java.util.Set<R>	getConcepts(CodeSystem codeSystem, java.util.function.Function<CodeSystem.Concept,? extends R> function)	Get a set containing FHIRTermServiceProvider instances mapped from concepts where all structural hierarchies have been flattened.
java.util.Set<CodeSystem.Concept>	getConcepts(CodeSystem codeSystem, java.util.List<ValueSet.Compose.Include.Filter> filters)	Get a set containing CodeSystem.Concept instances where all structural hierarchies have been flattened and filtered by the given set of value set include filters.
<R> java.util.Set<R>	getConcepts(CodeSystem codeSystem, java.util.List<ValueSet.Compose.Include.Filter> filters, java.util.function.Function<CodeSystem.Concept,? extends R> function)	Get a set containing FHIRTermServiceProvider instances mapped from concepts where all structural hierarchies have been flattened and filtered by the given set of value set include filters.
FHIRTermGraph	getGraph()
int	getTimeLimit()
boolean	hasConcept(CodeSystem codeSystem, Code code)	Indicates whether the given code system contains a concept with the specified code.
boolean	hasConcepts(CodeSystem codeSystem, java.util.Set<Code> codes)	Indicates whether the given code system contains a concept for each of the specified codes.
boolean	isSupported(CodeSystem codeSystem)	Indicates whether the given code system is supported.
boolean	subsumes(CodeSystem codeSystem, Code codeA, Code codeB)	Indicates whether the concept for CodeA subsumes the concept for codeB in the passed CodeSystem.

Methods inherited from class org.linuxforhealth.fhir.term.spi.AbstractTermServiceProvider

checkArgument, checkArguments, checkArguments, checkArguments, checkArguments, checkArguments

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_TIME_LIMIT

public static final int DEFAULT_TIME_LIMIT

See Also:

Constant Field Values

Constructor Detail

GraphTermServiceProvider

public GraphTermServiceProvider(org.apache.commons.configuration2.Configuration configuration)

Parameters:

configuration -

GraphTermServiceProvider

public GraphTermServiceProvider(org.apache.commons.configuration2.Configuration configuration,
                                int timeLimit)

Parameters:

configuration -

timeLimit - the default time to wait for queries to complete (in milliseconds)

GraphTermServiceProvider

public GraphTermServiceProvider(FHIRTermGraph graph)

Parameters:

graph -

GraphTermServiceProvider

public GraphTermServiceProvider(FHIRTermGraph graph,
                                int timeLimit)

Parameters:

graph -

timeLimit - the default time to wait for queries to complete (in milliseconds)

Method Detail

closure

public java.util.Set<CodeSystem.Concept> closure(CodeSystem codeSystem,
                                                 Code code)

Description copied from interface: FHIRTermServiceProvider

Get a set containing CodeSystem.Concept instances where all structural hierarchies have been flattened.

Specified by:

closure in interface FHIRTermServiceProvider

Specified by:

closure in class AbstractTermServiceProvider

Parameters:

codeSystem - the code system

code - the root of the hierarchy containing the Concept instances to be flattened

Returns:

flattened set of Concept instances for the given tree

closure

public java.util.Map<Code,java.util.Set<CodeSystem.Concept>> closure(CodeSystem codeSystem,
                                                                           java.util.Set<Code> codes)

Description copied from interface: FHIRTermServiceProvider

Get a map of sets containing CodeSystem.Concept instances where all structural hierarchies have been flattened

Parameters:

codeSystem - the code system

codes - the set of roots of hierarchies containing the Concept instances to be flattened

Returns:

a map containing flattened sets of Concept instances for the given trees

getConcept

public CodeSystem.Concept getConcept(CodeSystem codeSystem,
                                     Code code)

Description copied from interface: FHIRTermServiceProvider

Get the concept in the provided code system with the specified code. Consumers should not expect the returned Concept to contain child concepts, even where such concepts exist in the underlying CodeSystem.

Specified by:

getConcept in interface FHIRTermServiceProvider

Specified by:

getConcept in class AbstractTermServiceProvider

Parameters:

codeSystem - the code system

code - the code

Returns:

the code system concept with the specified code, or null if no such concept exists

getConcepts

public java.util.Set<CodeSystem.Concept> getConcepts(CodeSystem codeSystem)

Description copied from interface: FHIRTermServiceProvider

Get a set containing CodeSystem.Concept instances where all structural hierarchies have been flattened.

Specified by:

getConcepts in interface FHIRTermServiceProvider

Specified by:

getConcepts in class AbstractTermServiceProvider

Parameters:

codeSystem - the code system containing the set of Concept instances to be flattened

Returns:

flattened set of Concept instances for the given code system

getConcepts

public <R> java.util.Set<R> getConcepts(CodeSystem codeSystem,
                                        java.util.function.Function<CodeSystem.Concept,? extends R> function)

Description copied from interface: FHIRTermServiceProvider

Get a set containing FHIRTermServiceProvider instances mapped from concepts where all structural hierarchies have been flattened.

Type Parameters:

R - the element type of the result set

Parameters:

codeSystem - the code system containing the set of Concept instances to be flattened

function - the function to apply to each element of the result set

Returns:

flattened set of FHIRTermServiceProvider instances mapped from concepts for the given code system

getConcepts

public java.util.Set<CodeSystem.Concept> getConcepts(CodeSystem codeSystem,
                                                     java.util.List<ValueSet.Compose.Include.Filter> filters)

Description copied from interface: FHIRTermServiceProvider

Get a set containing CodeSystem.Concept instances where all structural hierarchies have been flattened and filtered by the given set of value set include filters.

Specified by:

getConcepts in interface FHIRTermServiceProvider

Specified by:

getConcepts in class AbstractTermServiceProvider

Parameters:

codeSystem - the code system containing the set of Concept instances to be flattened / filtered

filters - the value set include filters

Returns:

flattened / filtered set of Concept instances for the given code system

getConcepts

public <R> java.util.Set<R> getConcepts(CodeSystem codeSystem,
                                        java.util.List<ValueSet.Compose.Include.Filter> filters,
                                        java.util.function.Function<CodeSystem.Concept,? extends R> function)

Description copied from interface: FHIRTermServiceProvider

Get a set containing FHIRTermServiceProvider instances mapped from concepts where all structural hierarchies have been flattened and filtered by the given set of value set include filters.

Type Parameters:

R - the element type of the result set

Parameters:

codeSystem - the code system containing the set of Concept instances to be flattened / filtered

filters - the value set include filters

function - the function to apply to each element of the result set

Returns:

flattened / filtered set of FHIRTermServiceProvider instances mapped from concepts for the given code system

getGraph

public FHIRTermGraph getGraph()

getTimeLimit

public int getTimeLimit()

hasConcept

public boolean hasConcept(CodeSystem codeSystem,
                          Code code)

Description copied from interface: FHIRTermServiceProvider

Indicates whether the given code system contains a concept with the specified code.

Specified by:

hasConcept in interface FHIRTermServiceProvider

Specified by:

hasConcept in class AbstractTermServiceProvider

Parameters:

codeSystem - the code system

code - the code

Returns:

true if the given code system contains a concept with the specified code, false otherwise

hasConcepts

public boolean hasConcepts(CodeSystem codeSystem,
                           java.util.Set<Code> codes)

Description copied from interface: FHIRTermServiceProvider

Indicates whether the given code system contains a concept for each of the specified codes.

Parameters:

codeSystem - the code system

codes - the codes

Returns:

true if the given code system contains a concept for each of the specified codes, false otherwise

isSupported

public boolean isSupported(CodeSystem codeSystem)

Description copied from interface: FHIRTermServiceProvider

Indicates whether the given code system is supported.

Specified by:

isSupported in interface FHIRTermServiceProvider

Specified by:

isSupported in class AbstractTermServiceProvider

Parameters:

codeSystem - the code system

Returns:

true if the given code system is supported, false otherwise

subsumes

public boolean subsumes(CodeSystem codeSystem,
                        Code codeA,
                        Code codeB)

Description copied from interface: FHIRTermServiceProvider

Indicates whether the concept for CodeA subsumes the concept for codeB in the passed CodeSystem.

Specified by:

subsumes in interface FHIRTermServiceProvider

Specified by:

subsumes in class AbstractTermServiceProvider

Parameters:

codeSystem - the code system

codeA - the root of the hierarchy to search

codeB - the code to match

Returns:

true if the code system concept for codeB exists in the tree rooted by the concept for CodeA, false otherwise