Package com.sun.msv.verifier.regexp
Class CombinedChildContentExpCreator
- java.lang.Object
-
- com.sun.msv.verifier.regexp.CombinedChildContentExpCreator
-
- All Implemented Interfaces:
ExpressionVisitorVoid
public class CombinedChildContentExpCreator extends java.lang.Object implements ExpressionVisitorVoid
creates "combined child content expression" and gathers "elements of concern" and its "attribute-pruned" content model. Intuitively, "combined child content expression" is a set of content models of "elements of concern", which is appropriately combined to express dependency between elements. "Elements of concern" are ElementExps that are possibly applicable to the next element. These gathered element declarations are then tested against next XML element. "Attribute-pruned" content model is a content model after consuming AttributeTokens and removing unused AttributeExp nodes.For example, when the current expression is
then the combined child expression is..(A).. ..(B).. .....(C).. ....
and elements of concern and its attribute-pruned content models are..(A').. ..(B').. ..(C').. (A'),(B'), and (C') are attribute-pruned content models of (A),(B), and (C) respectively. Note that combined child pattern contains only <choice> and <concur> as its grue (of course, except ..(A').. , ..(B').. , and ..(C').. ). This function object also calculates "continuation", which is the residual expression after eating elements of concern. For example, say the expression is "(A|(B,C))?,D". When EoC is B, then the continuation will be C,D. When EoC is A, then the continuation will be D. When EoC is D, then the continuation will be epsilon. When there are multiple EoC, (say A and B), then the continuation will be meaningless (because it depends on which EoC will be accepted), and thus won't be used. However, the implementator must be aware that it is possible for a binary operator to have EoC on both branch and EoC is still unique. The following expression is an example. (A|B)*,C?,(A|B)* when A is EoC, SequenceExp of (A|B)* and C?,(A|B)* has EoC on both branch...(A).. -> ..(A')....(B).. -> ..(B')....(C).. -> ..(C')..
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classCombinedChildContentExpCreator.ExpressionPair
-
Field Summary
Fields Modifier and Type Field Description private booleancheckTagNameprivate Expressioncontentprivate Expressioncontinuationprivate booleanfoundConcura flag that indicates that we have 'concur' element to combine elements of concern.private intnumElementsprotected ExpressionPoolpoolprivate ElementExp[]resultmatched elements.private StartTagInfotagInfo
-
Constructor Summary
Constructors Modifier Constructor Description protectedCombinedChildContentExpCreator(ExpressionPool pool)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description CombinedChildContentExpCreator.ExpressionPaircontinueGet(Expression combinedPattern, StartTagInfo info, boolean checkTagName)CombinedChildContentExpCreator.ExpressionPairget(Expression combinedPattern, StartTagInfo info)computes a combined child content pattern and (,if possible,) its continuation.CombinedChildContentExpCreator.ExpressionPairget(Expression combinedPattern, StartTagInfo info, boolean checkTagName)computes a combined child content pattern and its continuation, with error recovery.ElementExp[]getMatchedElements()obtains matched elements.booleanisComplex()checks if the result of 'get' method is not the union of all elements of concern.intnumMatchedElements()gets the number of matched elements.voidonAnyString()voidonAttribute(AttributeExp exp)voidonChoice(ChoiceExp exp)voidonConcur(ConcurExp exp)voidonData(DataExp exp)voidonElement(ElementExp exp)voidonEpsilon()voidonInterleave(InterleaveExp exp)voidonList(ListExp exp)voidonMixed(MixedExp exp)voidonNullSet()voidonOneOrMore(OneOrMoreExp exp)voidonOther(OtherExp exp)voidonRef(ReferenceExp exp)voidonSequence(SequenceExp exp)voidonValue(ValueExp exp)
-
-
-
Field Detail
-
pool
protected final ExpressionPool pool
-
tagInfo
private StartTagInfo tagInfo
-
result
private ElementExp[] result
matched elements. the buffer is usually bigger thannumElements, but only firstnumElementsitems are valid result.
-
numElements
private int numElements
-
checkTagName
private boolean checkTagName
-
content
private Expression content
-
continuation
private Expression continuation
-
foundConcur
private boolean foundConcur
a flag that indicates that we have 'concur' element to combine elements of concern. If 'concur' is used, we have to keep track of combined child content expression to detect errors. If 'concur' is not used, then keeping track of all primitive child content expressions are enough to detect errors.
-
-
Constructor Detail
-
CombinedChildContentExpCreator
protected CombinedChildContentExpCreator(ExpressionPool pool)
-
-
Method Detail
-
get
public CombinedChildContentExpCreator.ExpressionPair get(Expression combinedPattern, StartTagInfo info, boolean checkTagName)
computes a combined child content pattern and its continuation, with error recovery. After calling this method, caller can call getElementsOfConcern to obtain each EoC. If both feedAttributes and checkTagName are false, then StartTagInfo is also unnecessary.- Parameters:
feedAttributes- if this flag is false, Attribute feeding & pruning are skipped and AttributeExps are fully remained in the resulting expression.checkTagName- if this flag is false, tag name check is skipped.
-
continueGet
public final CombinedChildContentExpCreator.ExpressionPair continueGet(Expression combinedPattern, StartTagInfo info, boolean checkTagName)
-
get
public CombinedChildContentExpCreator.ExpressionPair get(Expression combinedPattern, StartTagInfo info)
computes a combined child content pattern and (,if possible,) its continuation.
-
getMatchedElements
public final ElementExp[] getMatchedElements()
obtains matched elements. This method should be called after calling the get method. The result is in effect until the next invocation of get method.The extra care should be taken not to hold reference to the result longer than necessary. The contents of the result is valid only until the next invocation. Because OwnerAndContent objects are reused.
Apparently this is a bad design, but this design gives us better performance.
-
numMatchedElements
public final int numMatchedElements()
gets the number of matched elements. This method should be called after calling get method. The result is in effect until next invocation of get method. Apparently this is a bad design, but this design gives us better performance.
-
onConcur
public void onConcur(ConcurExp exp)
- Specified by:
onConcurin interfaceExpressionVisitorVoid
-
onInterleave
public void onInterleave(InterleaveExp exp)
- Specified by:
onInterleavein interfaceExpressionVisitorVoid
-
isComplex
public final boolean isComplex()
checks if the result of 'get' method is not the union of all elements of concern. Within this class, combined child content expression is always the union of all elements of concern. However, some derived class does not guarantee this property.- Returns:
- true if the combined child content expression is not the union of all elements of concern. false if otherwise.
-
onElement
public void onElement(ElementExp exp)
- Specified by:
onElementin interfaceExpressionVisitorVoid
-
onOneOrMore
public void onOneOrMore(OneOrMoreExp exp)
- Specified by:
onOneOrMorein interfaceExpressionVisitorVoid
-
onMixed
public void onMixed(MixedExp exp)
- Specified by:
onMixedin interfaceExpressionVisitorVoid
-
onAttribute
public void onAttribute(AttributeExp exp)
- Specified by:
onAttributein interfaceExpressionVisitorVoid
-
onEpsilon
public void onEpsilon()
- Specified by:
onEpsilonin interfaceExpressionVisitorVoid
-
onNullSet
public void onNullSet()
- Specified by:
onNullSetin interfaceExpressionVisitorVoid
-
onAnyString
public void onAnyString()
- Specified by:
onAnyStringin interfaceExpressionVisitorVoid
-
onData
public void onData(DataExp exp)
- Specified by:
onDatain interfaceExpressionVisitorVoid
-
onValue
public void onValue(ValueExp exp)
- Specified by:
onValuein interfaceExpressionVisitorVoid
-
onList
public void onList(ListExp exp)
- Specified by:
onListin interfaceExpressionVisitorVoid
-
onRef
public void onRef(ReferenceExp exp)
- Specified by:
onRefin interfaceExpressionVisitorVoid
-
onOther
public void onOther(OtherExp exp)
- Specified by:
onOtherin interfaceExpressionVisitorVoid
-
onChoice
public void onChoice(ChoiceExp exp)
- Specified by:
onChoicein interfaceExpressionVisitorVoid
-
onSequence
public void onSequence(SequenceExp exp)
- Specified by:
onSequencein interfaceExpressionVisitorVoid
-
-