com.tangosol.coherence.dslquery.internal

Class UpdateSetListMaker

java.lang.Object

com.tangosol.coherence.dslquery.internal.AbstractCoherenceQueryWalker

com.tangosol.coherence.dslquery.internal.UpdateSetListMaker

All Implemented Interfaces:

TermWalker

public class UpdateSetListMaker
extends AbstractCoherenceQueryWalker

UpdateSetListMaker is a visitor class that converts a given Abstract Syntax Tree into implementation Objects for a Update query. The implementation Objects are typically subclasses of InvocableMap.EntryProcessor. UpdateSetListMakers can also be used to process ASTs that are java constructors.

Author:

djl 2009.08.31

Field Summary

Fields

Modifier and Type	Field and Description
protected Object[]	m_aoResults The results of the classification
protected boolean	m_fRValueExpected Flag that controls the path behaviors for lvalues and rvalues.
protected NodeTerm	m_term The Term that is the AST that encodes select list

Fields inherited from class com.tangosol.coherence.dslquery.internal.AbstractCoherenceQueryWalker

f_language, f_propertyBuilder, f_termKeyFunction, m_atomicTerm, m_fExtendedLanguage, m_listBindVars, m_namedBindVars, m_oResult, m_sAlias

Constructor Summary

Constructors

Constructor and Description
UpdateSetListMaker(List indexedBindVars, com.tangosol.config.expression.ParameterResolver namedBindVars, CoherenceQueryLanguage language) Construct a new UpdateSetListMaker using given array for indexed Bind vars and the given Map for named bind vars.

Method Summary

Modifier and Type	Method and Description
protected void	acceptBinaryOperator(String sOperator, Term termLeft, Term termRight) The receiver has classified a binary operation node.
protected void	acceptCall(String sFunctionName, NodeTerm term) The receiver has classified a call node.
protected void	acceptIdentifier(String sIdentifier) The receiver has classified an identifier node.
protected void	acceptList(NodeTerm termList) The receiver has classified a list node.
void	acceptNode(String sFunctor, NodeTerm term) The receiver has been dispatched to from the given node.
protected void	acceptPath(NodeTerm term) The receiver has classified a path node.
protected void	acceptTarget() Do the Tree Walk for the set target AST
protected void	acceptUnaryOperator(String sOperator, Term term) The receiver has classified a unary operation node.
InvocableMap.EntryProcessor	getResultAsEntryProcessor() Turn the results of tree processing into an InvocableMap.EntryProcessor that will return the results of the update
Object[]	getResults() Get the resultant Object[] from the tree processing
protected Object	makeListLiteral(Object[] aoArgs) Create an ArrayList from the given arguments.
protected Object	makeMapLiteral(Object[] aoArgs) Create an Map from the given arguments.
Object	makeObject(NodeTerm term) Process the AST Tree using the given Term that that is to be turned into an Object.
Object	makeObjectForKey(NodeTerm term, Object oValue) Process the AST Tree using the given Term that that is to be turned into an Object to be used as a key for the given context Object.
protected Object	makePairLiteral(Object[] aoArgs) Create an Object[] from the given arguments.
String	makePathString(Object oValue) Make a . separated String out of the given Object.
InvocableMap.EntryProcessor	makeSetList() Process the AST Tree using the already set AST Tree
InvocableMap.EntryProcessor	makeSetList(NodeTerm term) Process the AST Tree using the given Term
protected Object	makeSetLiteral(Object[] aoArgs) Create an HashSet from the given arguments.
protected Object	makeSetOrMapLiteral(Object[] aoArgs) Create a Set or Map from the given arguments.
ValueExtractor	makeValueExtractor(Object oValue) Make a ValueExtractor out of the given Object.
ValueUpdater	makeValueUpdater(Object oValue) Make a ValueUpdater out of the given Object.
protected boolean	needsObjectCreation(String sFunctor, Term term) Test to see if we need to construct object given a node type.

Methods inherited from class com.tangosol.coherence.dslquery.internal.AbstractCoherenceQueryWalker

acceptAtom, acceptIdentifierInternal, acceptKeyedBinding, acceptLiteral, acceptNumericBinding, acceptPathAsChainedExtractor, acceptTerm, append, buildExtractor, getResult, reflectiveMakeObject, setAlias, setExtendedLanguage, setResult, walk

Methods inherited from class java.lang.Object

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

Field Detail

m_term

protected NodeTerm m_term

The Term that is the AST that encodes select list

m_aoResults

protected Object[] m_aoResults

The results of the classification

m_fRValueExpected

protected boolean m_fRValueExpected

Flag that controls the path behaviors for lvalues and rvalues.

Constructor Detail

UpdateSetListMaker

public UpdateSetListMaker(List indexedBindVars,
                          com.tangosol.config.expression.ParameterResolver namedBindVars,
                          CoherenceQueryLanguage language)

Construct a new UpdateSetListMaker using given array for indexed Bind vars and the given Map for named bind vars.

Parameters:

indexedBindVars - the indexed bind vars

namedBindVars - the named bind vars

language - the CoherenceQueryLanguage to use

Method Detail

getResults

public Object[] getResults()

Get the resultant Object[] from the tree processing

Returns:

the results of processing

getResultAsEntryProcessor

public InvocableMap.EntryProcessor getResultAsEntryProcessor()

Turn the results of tree processing into an InvocableMap.EntryProcessor that will return the results of the update

Returns:

the resulting EntryProcessor

makeSetList

public InvocableMap.EntryProcessor makeSetList()

Process the AST Tree using the already set AST Tree

Returns:

the resulting Object[] of results

makeSetList

public InvocableMap.EntryProcessor makeSetList(NodeTerm term)

Process the AST Tree using the given Term

Parameters:

term - the AST used

Returns:

the resulting Object[] of results

makeObject

public Object makeObject(NodeTerm term)

Process the AST Tree using the given Term that that is to be turned into an Object. Java constructors, static calls, or Object literals are processed.

Parameters:

term - the AST used

Returns:

the resulting Object

Throws:

RuntimeException - Callers should catch exceptions

makeObjectForKey

public Object makeObjectForKey(NodeTerm term,
                               Object oValue)

Process the AST Tree using the given Term that that is to be turned into an Object to be used as a key for the given context Object. Simple properties or simple calls will be make on the context Object Java constructors, static calls, or Object literals stand by themselves.

This situation is complicated because we try to be helpful and allow sending messages to the passed context object. Cases: new Constructor(): The Constructor can be fully qualified or not but in any case it will already be processed it's a simple call in which case it has been turned into a ReflectionExtractor so test for it and use it. identifier: This is a property and you use ValueExtractor relative to the context object derefNode that is all properties: This is a ChainedExtractor relative to the context object derefNode with calls along the way in the middle: This is a ChainedExtractor too so make it and use it on the context object literal object: These will already have been processed. The test for needsReflectiveCreation will weed this case out so you can simply return m_out. derefNode that ends in a call: We can't really tell whether it is a static call or should be a ChainedExtractor relative to the context object so we try the static call which can fail so its backed by a catch that tries again with a ChainedExtractor unless we are trying something special like .object. .

If we ever add static imports the calls will need to be checked against some Map of know static imports because the normal mechanism will make a ReflectionExtractor.

Parameters:

term - the AST used

oValue - the Object to extract results from

Returns:

the resulting Object

Throws:

RuntimeException - Callers should catch exceptions

acceptNode

public void acceptNode(String sFunctor,
                       NodeTerm term)

Description copied from interface: TermWalker

The receiver has been dispatched to from the given node.

Specified by:

acceptNode in interface TermWalker

Overrides:

acceptNode in class AbstractCoherenceQueryWalker

Parameters:

sFunctor - the node functor

term - the NodeTerm

acceptList

protected void acceptList(NodeTerm termList)

Description copied from class: AbstractCoherenceQueryWalker

The receiver has classified a list node.

Overrides:

acceptList in class AbstractCoherenceQueryWalker

Parameters:

termList - the Term whose children represent the elements of the list

acceptIdentifier

protected void acceptIdentifier(String sIdentifier)

Description copied from class: AbstractCoherenceQueryWalker

The receiver has classified an identifier node.

Overrides:

acceptIdentifier in class AbstractCoherenceQueryWalker

Parameters:

sIdentifier - the String representing the identifier

acceptBinaryOperator

protected void acceptBinaryOperator(String sOperator,
                                    Term termLeft,
                                    Term termRight)

Description copied from class: AbstractCoherenceQueryWalker

The receiver has classified a binary operation node.

Overrides:

acceptBinaryOperator in class AbstractCoherenceQueryWalker

Parameters:

sOperator - the string representing the operator

termLeft - the left Term of the operation

termRight - the right Term of the operation

acceptUnaryOperator

protected void acceptUnaryOperator(String sOperator,
                                   Term term)

Description copied from class: AbstractCoherenceQueryWalker

The receiver has classified a unary operation node.

Overrides:

acceptUnaryOperator in class AbstractCoherenceQueryWalker

Parameters:

sOperator - the string representing the operator

term - the Term being operated upon

acceptCall

protected void acceptCall(String sFunctionName,
                          NodeTerm term)

Description copied from class: AbstractCoherenceQueryWalker

The receiver has classified a call node.

Overrides:

acceptCall in class AbstractCoherenceQueryWalker

Parameters:

sFunctionName - the function name

term - a Term whose children are the parameters to the call

acceptPath

protected void acceptPath(NodeTerm term)

Description copied from class: AbstractCoherenceQueryWalker

The receiver has classified a path node.

Overrides:

acceptPath in class AbstractCoherenceQueryWalker

Parameters:

term - a Term whose children are the elements of the path

acceptTarget

protected void acceptTarget()

Do the Tree Walk for the set target AST

makePathString

public String makePathString(Object oValue)

Make a . separated String out of the given Object.

Parameters:

oValue - an Object or Object[] that is to be a ValueUpdater

Returns:

the resulting String

makeValueUpdater

public ValueUpdater makeValueUpdater(Object oValue)

Make a ValueUpdater out of the given Object.

Parameters:

oValue - an Object or Object[] that is to be a ValueUpdater

Returns:

the resulting ValueUpdater

makeValueExtractor

public ValueExtractor makeValueExtractor(Object oValue)

Make a ValueExtractor out of the given Object.

Parameters:

oValue - an Object or Object[] that is to be a ValueExtractor

Returns:

the resulting ValueExtractor

needsObjectCreation

protected boolean needsObjectCreation(String sFunctor,
                                      Term term)

Test to see if we need to construct object given a node type.

Parameters:

sFunctor - String representing node type

term - the Term that could result in Object creation

Returns:

result of testing

makePairLiteral

protected Object makePairLiteral(Object[] aoArgs)

Create an Object[] from the given arguments.

Parameters:

aoArgs - an array of Object to be used as a pair

Returns:

a newly created ArrayList

makeListLiteral

protected Object makeListLiteral(Object[] aoArgs)

Create an ArrayList from the given arguments.

Parameters:

aoArgs - an array of Object to be added to ArrayList

Returns:

a newly created ArrayList

makeSetLiteral

protected Object makeSetLiteral(Object[] aoArgs)

Create an HashSet from the given arguments.

Parameters:

aoArgs - an array of Object to be added to ArrayList

Returns:

a newly created ArrayList

makeSetOrMapLiteral

protected Object makeSetOrMapLiteral(Object[] aoArgs)

Create a Set or Map from the given arguments. Make a Map if all given arguments are Object[] of length 2 otherwise make a Set.

Parameters:

aoArgs - an array of Object to be added to ArrayList

Returns:

a newly created HashSet or HashMap

makeMapLiteral

protected Object makeMapLiteral(Object[] aoArgs)

Create an Map from the given arguments.

Parameters:

aoArgs - an array of Object to be added to Map

Returns:

a newly created Map