Package com.ibm.fhir.path.evaluator

Class FHIRPathEvaluator

java.lang.Object

com.ibm.fhir.path.evaluator.FHIRPathEvaluator

@NotThreadSafe
public class FHIRPathEvaluator
extends Object

A FHIRPath evaluation engine that implements the FHIRPath 2.0.0 specification

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FHIRPathEvaluator.EvaluatingVisitor
static class	FHIRPathEvaluator.EvaluationContext	A context object used to pass information to/from the FHIRPath evaluation engine
static interface	FHIRPathEvaluator.EvaluationListener	A listener interface for receiving notifications during evaluation

Field Summary

Fields

Modifier and Type	Field	Description
static Collection<FHIRPathNode>	SINGLETON_FALSE
static Collection<FHIRPathNode>	SINGLETON_TRUE

Method Summary

Modifier and Type	Method	Description
Collection<FHIRPathNode>	evaluate(Resource resource, String expr)	Evaluate a FHIRPath expression against a Resource
Collection<FHIRPathNode>	evaluate(Element element, String expr)	Evaluate a FHIRPath expression against an Element
Collection<FHIRPathNode>	evaluate(Visitable resourceOrElement, String expr)	Evaluate a FHIRPath expression against a Resource or Element
Collection<FHIRPathNode>	evaluate(FHIRPathEvaluator.EvaluationContext evaluationContext, String expr)	Evaluate a FHIRPath expression using an existing evaluation context
Collection<FHIRPathNode>	evaluate(FHIRPathEvaluator.EvaluationContext evaluationContext, String expr, FHIRPathNode node)	Evaluate a FHIRPath expression using an existing evaluation context against a FHIRPath node
Collection<FHIRPathNode>	evaluate(FHIRPathEvaluator.EvaluationContext evaluationContext, String expr, Collection<FHIRPathNode> initialContext)	Evaluate a FHIRPathExpression using an existing EvaluationContext against a collection of FHIRPath nodes
Collection<FHIRPathNode>	evaluate(String expr)	Evaluate a FHIRPath expression
static FHIRPathEvaluator	evaluator()	Static factory method for creating FHIRPathEvaluator instances
FHIRPathEvaluator.EvaluationContext	getEvaluationContext()	Get the EvaluationContext associated with this FHIRPathEvaluator

Methods inherited from class java.lang.Object

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

Field Detail

SINGLETON_TRUE

public static final Collection<FHIRPathNode> SINGLETON_TRUE

SINGLETON_FALSE

public static final Collection<FHIRPathNode> SINGLETON_FALSE

Method Detail

getEvaluationContext

public FHIRPathEvaluator.EvaluationContext getEvaluationContext()

Get the EvaluationContext associated with this FHIRPathEvaluator

Returns:

get the EvaluationContext associated with this FHIRPathEvaluator

evaluate

public Collection<FHIRPathNode> evaluate(String expr)
                                  throws FHIRPathException

Evaluate a FHIRPath expression

Parameters:

expr - the FHIRPath expression to evaluate

Returns:

the result of evaluation as a non-null, potentially empty collection of FHIRPath nodes

Throws:

NullPointerException - if any of the parameters are null

FHIRPathException - if an exception occurs during evaluation

evaluate

public Collection<FHIRPathNode> evaluate(Visitable resourceOrElement,
                                         String expr)
                                  throws FHIRPathException

Evaluate a FHIRPath expression against a Resource or Element

Parameters:

resourceOrElement - the Resource or Element

expr - the FHIRPath expression to evaluate

Returns:

the result of evaluation as a non-null, potentially empty collection of FHIRPath nodes

Throws:

NullPointerException - if any of the parameters are null

FHIRPathException - if an exception occurs during evaluation

evaluate

public Collection<FHIRPathNode> evaluate(Resource resource,
                                         String expr)
                                  throws FHIRPathException

Evaluate a FHIRPath expression against a Resource

Parameters:

resource - the resource

expr - the FHIRPath expression to evaluate

Returns:

the result of evaluation as a non-null, potentially empty collection of FHIRPath nodes

Throws:

NullPointerException - if any of the parameters are null

FHIRPathException - if an exception occurs during evaluation

evaluate

public Collection<FHIRPathNode> evaluate(Element element,
                                         String expr)
                                  throws FHIRPathException

Evaluate a FHIRPath expression against an Element

Parameters:

element - the element

expr - the FHIRPath expression to evaluate

Returns:

the result of evaluation as a non-null, potentially empty collection of FHIRPath nodes

Throws:

NullPointerException - if any of the parameters are null

FHIRPathException - if an exception occurs during evaluation

evaluate

public Collection<FHIRPathNode> evaluate(FHIRPathEvaluator.EvaluationContext evaluationContext,
                                         String expr)
                                  throws FHIRPathException

Evaluate a FHIRPath expression using an existing evaluation context

Parameters:

evaluationContext - the evaluation context

expr - the FHIRPath expression to evaluate

Returns:

the result of evaluation as a non-null, potentially empty collection of FHIRPath nodes

Throws:

NullPointerException - if any of the parameters are null

FHIRPathException - if an exception occurs during evaluation

evaluate

public Collection<FHIRPathNode> evaluate(FHIRPathEvaluator.EvaluationContext evaluationContext,
                                         String expr,
                                         FHIRPathNode node)
                                  throws FHIRPathException

Evaluate a FHIRPath expression using an existing evaluation context against a FHIRPath node

Parameters:

evaluationContext - the evaluation context

expr - the FHIRPath expression to evaluate

node - the FHIRPath node

Returns:

the result of evaluation as a non-null, potentially empty collection of FHIRPath nodes

Throws:

NullPointerException - if any of the parameters are null

FHIRPathException - if an exception occurs during evaluation

evaluate

public Collection<FHIRPathNode> evaluate(FHIRPathEvaluator.EvaluationContext evaluationContext,
                                         String expr,
                                         Collection<FHIRPathNode> initialContext)
                                  throws FHIRPathException

Evaluate a FHIRPathExpression using an existing EvaluationContext against a collection of FHIRPath nodes

Parameters:

evaluationContext - the evaluation context

expr - the FHIRPath expression to evaluate

initialContext - the initial context as a non-null, potentially empty collection of FHIRPath nodes

Returns:

the result of evaluation as a collection of FHIRPath nodes

Throws:

NullPointerException - if any of the parameters are null

FHIRPathException - if an exception occurs during evaluation

evaluator

public static FHIRPathEvaluator evaluator()

Static factory method for creating FHIRPathEvaluator instances

Returns:

a new FHIRPathEvaluator instance