Serializable
AttributeExp
, BinaryExp
, DataExp
, ElementExp
, OtherExp
, ReferenceExp
, UnaryExp
, ValueExp
public abstract class Expression extends Object implements Serializable
By making it immutable, it becomes possible to share subexpressions among expressions. This is very important for regular-expression-derivation based validation algorithm, as well as for smaller memory footprint. This sharing is automatically achieved by ExpressionPool.
ReferebceExp, ElementExp, and OtherExp are also placed in the pool, but these are not unified. Since they are not unified, application can derive classes from these expressions and mix them into AGM. This technique is heavily used to introduce schema language specific primitives into AGM. See various sub-packages of this package for examples.
The equals method must be implemented by the derived type. equals method will be used to unify the expressions. equals method can safely assume that its children are already unified (therefore == can be used to test the equality, rather than equals method).
To achieve unification, we overload the equals method so that
o1.equals(o2)
is true if o1 and o2 are identical.
There, those two objects must return the same hash code. For this purpose,
the hash code is calculated statically and cached internally.
Modifier and Type | Field | Description |
---|---|---|
static Expression |
anyString |
special expression object that represents "any string".
|
static Expression |
epsilon |
Special expression object that represents epsilon (ε).
|
static Expression |
nullSet |
special expression object that represents the empty set (Φ).
|
Object |
verifierTag |
this field can be used by Verifier implementation to speed up
validation.
|
Modifier | Constructor | Description |
---|---|---|
protected |
Expression() |
this constructor can be used for the ununified expressions.
|
protected |
Expression(int hashCode) |
Modifier and Type | Method | Description |
---|---|---|
protected abstract boolean |
calcEpsilonReducibility() |
computes epsilon reducibility
|
protected abstract int |
calcHashCode() |
Computes the hashCode again.
|
abstract boolean |
equals(Object o) |
|
Expression |
getExpandedExp(ExpressionPool pool) |
Gets the expression after removing all ReferenceExps, until child
AttributeExp or ElementExp.
|
int |
hashCode() |
|
protected static int |
hashCode(Object o,
int hashKey) |
|
protected static int |
hashCode(Object o1,
Object o2,
int hashKey) |
|
boolean |
isEpsilonReducible() |
returns true if this expression accepts empty sequence.
|
Expression |
peelOccurence() |
Peels the occurence expressions from this expression.
|
protected Object |
readResolve() |
|
abstract Object |
visit(ExpressionVisitor visitor) |
|
abstract boolean |
visit(ExpressionVisitorBoolean visitor) |
|
abstract Expression |
visit(ExpressionVisitorExpression visitor) |
|
abstract void |
visit(ExpressionVisitorVoid visitor) |
|
Object |
visit(RELAXExpressionVisitor visitor) |
|
boolean |
visit(RELAXExpressionVisitorBoolean visitor) |
|
Expression |
visit(RELAXExpressionVisitorExpression visitor) |
|
void |
visit(RELAXExpressionVisitorVoid visitor) |
public transient Object verifierTag
public static final Expression epsilon
public static final Expression nullSet
public static final Expression anyString
This object is used as <anyString/> pattern of TREX and <text/> pattern of RELAX NG.
protected Expression(int hashCode)
protected Expression()
public boolean isEpsilonReducible()
If this method is called while creating Expressions, then this method may return approximated value. When this method is used while validation, this method is guaranteed to return the correct value.
protected abstract boolean calcEpsilonReducibility()
public Expression getExpandedExp(ExpressionPool pool)
public final Expression peelOccurence()
In AGM, 'X?','X+' and 'X*' are represented by using other primitives. This method returns the 'X' part by removing occurence related expressions.
public abstract Object visit(ExpressionVisitor visitor)
public abstract Expression visit(ExpressionVisitorExpression visitor)
public abstract boolean visit(ExpressionVisitorBoolean visitor)
public abstract void visit(ExpressionVisitorVoid visitor)
public Object visit(RELAXExpressionVisitor visitor)
public Expression visit(RELAXExpressionVisitorExpression visitor)
public boolean visit(RELAXExpressionVisitorBoolean visitor)
public void visit(RELAXExpressionVisitorVoid visitor)
protected abstract int calcHashCode()
This method and the parameter to the constructor has to be the same. This method is used when the object is being read from the stream.
protected static int hashCode(Object o, int hashKey)
protected Object readResolve()
Copyright © 2019 Oracle Corporation. All rights reserved.