Package org.apache.juneau.commons.svl.functions

Class OpFunctions

java.lang.Object

org.apache.juneau.commons.svl.functions.OpFunctions

public final class OpFunctions
extends Object

Reserved $op.* operator functions targeted by the compiled expression grammar.

Each operator is one VarFunction registered only under its reserved $op. name (never under a plain name). All are deniable via an allowlist like any other function. Arguments arrive already evaluated; short-circuiting (and, or, elvis, ternary) is the evaluator's job.

Coercion rules (SpEL-style):

• Numeric tower: Byte/Short/Integer/Long stay long (overflow detected with Math.*Exact and promoted to BigDecimal); any Double/Float operand gives double (this wins over BigDecimal); otherwise any BigDecimal/BigInteger gives BigDecimal.
• add concatenates when either operand is a String; a null operand renders as "null". sub/mul/div/mod/neg/pos are numeric only.
• div of two integral values stays integral only when exact, otherwise double. Integral (and BigDecimal) division or modulo by zero is an error; by 0.0 follows IEEE 754.
• eq/ne compare numbers numerically (1 == 1.0), otherwise Objects.equals(java.lang.Object, java.lang.Object).
• lt/le/gt/ge compare numbers numerically or same-class Comparables; anything else is an error. A null operand is an error in strict mode and false in lenient mode.
• and/or/not/ternary accept Boolean or the strings "true"/"false", matched case-insensitively (consistent with BooleanFunctions, whose parser also uses case-insensitive matching but additionally accepts 1/yes/on and 0/no/off, which operators deliberately do not). and and or validate both operands before combining.
• Long.MIN_VALUE / -1 overflows and is promoted to BigDecimal; Long.MIN_VALUE % -1 is 0.
• NaN is unordered: eq is false, ne true, and all relational operators false. 0.0 == -0.0. Long-versus-double comparison is exact (no precision loss).
• add string concatenation renders doubles via ArithmeticFunctions.render(double) (integral values drop .0) and BigDecimal via toPlainString().
• elvis is null-only: false, 0 and "" are kept.
• matches uses a bounded shared pattern cache. There is no match timeout: ReDoS exposure is bounded only by the configured limits and the function allowlist.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OpFunctions.Add	$op.add.
static class	OpFunctions.And	$op.and.
static class	OpFunctions.Div	$op.div.
static class	OpFunctions.Elvis	$op.elvis.
static class	OpFunctions.Eq	$op.eq.
static class	OpFunctions.Ge	$op.ge.
static class	OpFunctions.Gt	$op.gt.
static class	OpFunctions.Le	$op.le.
static class	OpFunctions.Lt	$op.lt.
static class	OpFunctions.Matches	$op.matches.
static class	OpFunctions.Mod	$op.mod.
static class	OpFunctions.Mul	$op.mul.
static class	OpFunctions.Ne	$op.ne.
static class	OpFunctions.Neg	$op.neg.
static class	OpFunctions.Not	$op.not.
static class	OpFunctions.Or	$op.or.
static class	OpFunctions.Pos	$op.pos.
static class	OpFunctions.Project	Registered stub for the evaluator-only $op.project operator.
static class	OpFunctions.Select	Registered stub for the evaluator-only $op.select operator.
static class	OpFunctions.Sub	$op.sub.
static class	OpFunctions.Ternary	$op.ternary.

Field Summary

Fields

Modifier and Type	Field	Description
static final Class<? extends VarFunction>[]	ALL	All function classes in this category.

Method Summary

Methods inherited from class java.lang.Object

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

Field Details

ALL

public static final Class<? extends VarFunction>[] ALL

All function classes in this category.