Class QueryEvaluationUtil

java.lang.Object

org.eclipse.rdf4j.query.algebra.evaluation.util.QueryEvaluationUtil

public class QueryEvaluationUtil
extends Object

Utility functions used during logical query evaluation.

Performance note: every comparison operator now has its own specialised method. All hot paths are branch‑free w.r.t. CompareOp, allowing the JVM to inline and optimise aggressively.

Field Summary

Fields

Modifier and Type	Field	Description
static final ValueExprEvaluationException	DATE_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION
static final ValueExprEvaluationException	INDETERMINATE_DATE_TIME_EXCEPTION
static final ValueExprEvaluationException	NOT_COMPATIBLE_AND_ORDERED_EXCEPTION
static final ValueExprEvaluationException	NUMERIC_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION
static final ValueExprEvaluationException	STRING_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION
static final ValueExprEvaluationException	UNSUPPOERTED_TYPES_EXCEPTION

Constructor Summary

Constructors

Constructor	Description
QueryEvaluationUtil()

Method Summary

Modifier and Type	Method	Description
static boolean	compare(Value l, Value r, Compare.CompareOp op)	Deprecated. use the specialised compareXX methods instead.
static boolean	compare(Value l, Value r, Compare.CompareOp op, boolean strict)	Deprecated. use the specialised compareXX methods instead.
static boolean	compareEQ(Value l, Value r)
static boolean	compareEQ(Value l, Value r, boolean strict)
static boolean	compareGE(Value l, Value r)
static boolean	compareGE(Value l, Value r, boolean strict)
static boolean	compareGT(Value l, Value r)
static boolean	compareGT(Value l, Value r, boolean strict)
static boolean	compareLE(Value l, Value r)
static boolean	compareLE(Value l, Value r, boolean strict)
static boolean	compareLiterals(Literal l, Literal r, Compare.CompareOp op)	Deprecated. use the specialised compareLiteralsXX methods instead.
static boolean	compareLiterals(Literal l, Literal r, Compare.CompareOp op, boolean strict)	Deprecated. use the specialised compareLiteralsXX methods instead.
static boolean	compareLiteralsEQ(Literal l, Literal r)
static boolean	compareLiteralsEQ(Literal l, Literal r, boolean strict)
static boolean	compareLiteralsGE(Literal l, Literal r)
static boolean	compareLiteralsGE(Literal l, Literal r, boolean strict)
static boolean	compareLiteralsGT(Literal l, Literal r)
static boolean	compareLiteralsGT(Literal l, Literal r, boolean strict)
static boolean	compareLiteralsLE(Literal l, Literal r)
static boolean	compareLiteralsLE(Literal l, Literal r, boolean strict)
static boolean	compareLiteralsLT(Literal l, Literal r)
static boolean	compareLiteralsLT(Literal l, Literal r, boolean strict)
static boolean	compareLiteralsNE(Literal l, Literal r)
static boolean	compareLiteralsNE(Literal l, Literal r, boolean strict)
static boolean	compareLT(Value l, Value r)
static boolean	compareLT(Value l, Value r, boolean strict)
static boolean	compareNE(Value l, Value r)
static boolean	compareNE(Value l, Value r, boolean strict)
static boolean	compareWithOperator(Compare.CompareOp op, int c)
static boolean	compatibleArguments(Literal arg1, Literal arg2)	Checks whether the supplied two literal arguments are 'argument compatible' according to the SPARQL definition.
static boolean	getEffectiveBooleanValue(Value value)
static boolean	isPlainLiteral(Literal l)
static boolean	isPlainLiteral(Value v)
static boolean	isSimpleLiteral(boolean lang, CoreDatatype dt)
static boolean	isSimpleLiteral(Literal l)
static boolean	isSimpleLiteral(Value v)
static boolean	isStringLiteral(Literal l)
static boolean	isStringLiteral(Value v)

Methods inherited from class Object

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

Field Details

INDETERMINATE_DATE_TIME_EXCEPTION

public static final ValueExprEvaluationException INDETERMINATE_DATE_TIME_EXCEPTION

STRING_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION

public static final ValueExprEvaluationException STRING_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION

NUMERIC_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION

public static final ValueExprEvaluationException NUMERIC_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION

DATE_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION

public static final ValueExprEvaluationException DATE_WITH_OTHER_SUPPORTED_TYPE_EXCEPTION

UNSUPPOERTED_TYPES_EXCEPTION

public static final ValueExprEvaluationException UNSUPPOERTED_TYPES_EXCEPTION

NOT_COMPATIBLE_AND_ORDERED_EXCEPTION

public static final ValueExprEvaluationException NOT_COMPATIBLE_AND_ORDERED_EXCEPTION

Constructor Details

QueryEvaluationUtil

public QueryEvaluationUtil()

Method Details

getEffectiveBooleanValue

public static boolean getEffectiveBooleanValue(Value value)
                                        throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareEQ

public static boolean compareEQ(Value l,
 Value r)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareEQ

public static boolean compareEQ(Value l,
 Value r,
 boolean strict)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareNE

public static boolean compareNE(Value l,
 Value r)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareNE

public static boolean compareNE(Value l,
 Value r,
 boolean strict)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLT

public static boolean compareLT(Value l,
 Value r)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLT

public static boolean compareLT(Value l,
 Value r,
 boolean strict)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLE

public static boolean compareLE(Value l,
 Value r)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLE

public static boolean compareLE(Value l,
 Value r,
 boolean strict)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareGT

public static boolean compareGT(Value l,
 Value r)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareGT

public static boolean compareGT(Value l,
 Value r,
 boolean strict)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareGE

public static boolean compareGE(Value l,
 Value r)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareGE

public static boolean compareGE(Value l,
 Value r,
 boolean strict)
                         throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsEQ

public static boolean compareLiteralsEQ(Literal l,
 Literal r)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsEQ

public static boolean compareLiteralsEQ(Literal l,
 Literal r,
 boolean strict)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsNE

public static boolean compareLiteralsNE(Literal l,
 Literal r)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsNE

public static boolean compareLiteralsNE(Literal l,
 Literal r,
 boolean strict)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsLT

public static boolean compareLiteralsLT(Literal l,
 Literal r)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsLT

public static boolean compareLiteralsLT(Literal l,
 Literal r,
 boolean strict)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsLE

public static boolean compareLiteralsLE(Literal l,
 Literal r)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsLE

public static boolean compareLiteralsLE(Literal l,
 Literal r,
 boolean strict)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsGT

public static boolean compareLiteralsGT(Literal l,
 Literal r)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsGT

public static boolean compareLiteralsGT(Literal l,
 Literal r,
 boolean strict)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsGE

public static boolean compareLiteralsGE(Literal l,
 Literal r)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compareLiteralsGE

public static boolean compareLiteralsGE(Literal l,
 Literal r,
 boolean strict)
                                 throws ValueExprEvaluationException

Throws:

ValueExprEvaluationException

compare

@Deprecated
public static boolean compare(Value l,
 Value r,
 Compare.CompareOp op)
                       throws ValueExprEvaluationException

Deprecated.

use the specialised compareXX methods instead.

Throws:

ValueExprEvaluationException

compare

@Deprecated
public static boolean compare(Value l,
 Value r,
 Compare.CompareOp op,
 boolean strict)
                       throws ValueExprEvaluationException

Deprecated.

use the specialised compareXX methods instead.

Throws:

ValueExprEvaluationException

compareLiterals

@Deprecated
public static boolean compareLiterals(Literal l,
 Literal r,
 Compare.CompareOp op)
                               throws ValueExprEvaluationException

Deprecated.

use the specialised compareLiteralsXX methods instead.

Throws:

ValueExprEvaluationException

compareLiterals

@Deprecated
public static boolean compareLiterals(Literal l,
 Literal r,
 Compare.CompareOp op,
 boolean strict)
                               throws ValueExprEvaluationException

Deprecated.

use the specialised compareLiteralsXX methods instead.

Throws:

ValueExprEvaluationException

compareWithOperator

public static boolean compareWithOperator(Compare.CompareOp op,
 int c)

isPlainLiteral

public static boolean isPlainLiteral(Value v)

isPlainLiteral

public static boolean isPlainLiteral(Literal l)

isSimpleLiteral

public static boolean isSimpleLiteral(Value v)

isSimpleLiteral

public static boolean isSimpleLiteral(Literal l)

isSimpleLiteral

public static boolean isSimpleLiteral(boolean lang,
 CoreDatatype dt)

isStringLiteral

public static boolean isStringLiteral(Value v)

isStringLiteral

public static boolean isStringLiteral(Literal l)

compatibleArguments

public static boolean compatibleArguments(Literal arg1,
 Literal arg2)

Checks whether the supplied two literal arguments are 'argument compatible' according to the SPARQL definition.

Parameters:

arg1 - the first argument

arg2 - the second argument

Returns:

true iff the two supplied arguments are argument compatible, false otherwise

See Also:

• SPARQL Argument Compatibility Rules