org.apache.derby.impl.sql.compile
Class NonStaticMethodCallNode

java.lang.Object
  org.apache.derby.impl.sql.compile.QueryTreeNode
      org.apache.derby.impl.sql.compile.JavaValueNode
          org.apache.derby.impl.sql.compile.MethodCallNode
              org.apache.derby.impl.sql.compile.NonStaticMethodCallNode

All Implemented Interfaces:

Visitable

public class NonStaticMethodCallNode

extends MethodCallNode

A NonStaticMethodCallNode is really a node to represent a (static or non-static) method call from an object (as opposed to a static method call from a class.

Field Summary

private boolean	isStatic
(package private) JavaValueNode	receiver

Fields inherited from class org.apache.derby.impl.sql.compile.MethodCallNode

actualMethodReturnType, internalCall, javaClassName, method, methodName, methodParameterTypes, methodParms, routineInfo, signature

Fields inherited from class org.apache.derby.impl.sql.compile.JavaValueNode

forCallStatement, jsqlType

Fields inherited from class org.apache.derby.impl.sql.compile.QueryTreeNode

AUTOINCREMENT_INC_INDEX, AUTOINCREMENT_IS_AUTOINCREMENT_INDEX, AUTOINCREMENT_START_INDEX, beginOffset, endOffset

Constructor Summary

NonStaticMethodCallNode()

Method Summary

Visitable	accept(Visitor v) Accept a visitor, and call v.visit() on child nodes as necessary.
JavaValueNode	bindExpression(FromList fromList, SubqueryList subqueryList, java.util.Vector aggregateVector) Bind this expression.
boolean	categorize(JBitSet referencedTabs, boolean simplePredsOnly) Categorize this predicate.
void	generateExpression(ExpressionClassBuilder acb, MethodBuilder mb) Do code generation for this method call
protected boolean	generateReceiver(ExpressionClassBuilder acb, MethodBuilder mb) Generate the expression that evaluates to the receiver.
protected int	getOrderableVariantType() Return the variant type for the underlying expression.
void	init(java.lang.Object methodName, java.lang.Object receiver) Initializer for a NonStaticMethodCallNode
void	preprocess(int numTables, FromList outerFromList, SubqueryList outerSubqueryList, PredicateList outerPredicateList) Preprocess an expression tree.
void	printSubNodes(int depth) Prints the sub-nodes of this object.
JavaValueNode	remapColumnReferencesToExpressions() Remap all ColumnReferences in this tree to be clones of the underlying expression.

Methods inherited from class org.apache.derby.impl.sql.compile.MethodCallNode

addParms, addParms, areParametersQueryInvariant, bindParameters, generateOneParameter, generateParameters, getIsParam, getJavaClassName, getMethodName, getMethodParms, getObjectSignature, getParameterTypeName, getPrimitiveSignature, getSignature, init, resolveMethodCall, setClause, setNullParameterInfo, someParametersAreNull, throwNoMethodFound, toString

Methods inherited from class org.apache.derby.impl.sql.compile.JavaValueNode

castToPrimitive, checkReliability, generate, generateReceiver, getConstantValueAsObject, getJavaTypeName, getJSQLType, getPrimitiveTypeName, getReceiverExpression, isPrimitiveType, mapToTypeID, markForCallStatement, markReturnValueDiscarded, mustCastToPrimitive, returnValueDiscarded, returnValueToSQLDomain, setJavaTypeName, valueReturnedToSQLDomain

Methods inherited from class org.apache.derby.impl.sql.compile.QueryTreeNode

bind, convertDefaultNode, debugFlush, debugPrint, executeSchemaName, executeStatementName, formatNodeString, foundString, generate, generateAuthorizeCheck, getBeginOffset, getClassFactory, getCompilerContext, getContextManager, getCursorInfo, getDataDictionary, getDependencyManager, getEndOffset, getExecutionFactory, getGenericConstantActionFactory, getIntProperty, getLanguageConnectionContext, getNodeFactory, getNodeType, getNullNode, getParameterTypes, getRowEstimate, getSchemaDescriptor, getSchemaDescriptor, getSPSName, getStatementType, getTableDescriptor, getTypeCompiler, init, init, init, init, init, init, init, init, init, init, init, init, isAtomic, isInstanceOf, isSessionSchema, isSessionSchema, makeConstantAction, makeResultDescription, makeTableName, needsSavepoint, nodeHeader, optimize, parseQueryText, printLabel, referencesSessionSchema, resolveTableToSynonym, setBeginOffset, setContextManager, setEndOffset, setNodeType, setRefActionInfo, treePrint, treePrint, verifyClassExist

Methods inherited from class java.lang.Object

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

Field Detail

receiver

JavaValueNode receiver

isStatic

private boolean isStatic

Constructor Detail

NonStaticMethodCallNode

public NonStaticMethodCallNode()

Method Detail

init

public void init(java.lang.Object methodName,
                 java.lang.Object receiver)
          throws StandardException

Initializer for a NonStaticMethodCallNode

Overrides:

init in class QueryTreeNode

Parameters:

methodName - The name of the method to call

receiver - A JavaValueNode representing the receiving object

Throws:

StandardException - Thrown on error

bindExpression

public JavaValueNode bindExpression(FromList fromList,
                                    SubqueryList subqueryList,
                                    java.util.Vector aggregateVector)
                             throws StandardException

Bind this expression. This means binding the sub-expressions, as well as figuring out what the return type is for this expression.

Specified by:

bindExpression in class JavaValueNode

Parameters:

fromList - The FROM list for the query this expression is in, for binding columns.

subqueryList - The subquery list being built as we find SubqueryNodes

aggregateVector - The aggregate vector being built as we find AggregateNodes

Returns:

this

Throws:

StandardException - Thrown on error

See Also:

ValueNode.bindExpression(org.apache.derby.impl.sql.compile.FromList, org.apache.derby.impl.sql.compile.SubqueryList, java.util.Vector)

categorize

public boolean categorize(JBitSet referencedTabs,
                          boolean simplePredsOnly)
                   throws StandardException

Categorize this predicate. Initially, this means building a bit map of the referenced tables for each predicate. If the source of this ColumnReference (at the next underlying level) is not a ColumnReference or a VirtualColumnNode then this predicate will not be pushed down. For example, in: select * from (select 1 from s) a (x) where x = 1 we will not push down x = 1. NOTE: It would be easy to handle the case of a constant, but if the inner SELECT returns an arbitrary expression, then we would have to copy that tree into the pushed predicate, and that tree could contain subqueries and method calls. RESOLVE - revisit this issue once we have views.

Overrides:

categorize in class MethodCallNode

Parameters:

referencedTabs - JBitSet with bit map of referenced FromTables

simplePredsOnly - Whether or not to consider method calls, field references and conditional nodes when building bit map

Returns:

boolean Whether or not source.expression is a ColumnReference or a VirtualColumnNode.

Throws:

StandardException - Thrown on error

getOrderableVariantType

protected int getOrderableVariantType()
                               throws StandardException

Return the variant type for the underlying expression. The variant type can be: VARIANT - variant within a scan (non-static field access) SCAN_INVARIANT - invariant within a scan (column references from outer tables) QUERY_INVARIANT - invariant within the life of a query (constant expressions)

Overrides:

getOrderableVariantType in class MethodCallNode

Returns:

The variant type for the underlying expression.

Throws:

StandardException

remapColumnReferencesToExpressions

public JavaValueNode remapColumnReferencesToExpressions()
                                                 throws StandardException

Remap all ColumnReferences in this tree to be clones of the underlying expression.

Overrides:

remapColumnReferencesToExpressions in class MethodCallNode

Returns:

JavaValueNode The remapped expression tree.

Throws:

StandardException - Thrown on error

printSubNodes

public void printSubNodes(int depth)

Prints the sub-nodes of this object. See QueryTreeNode.java for how tree printing is supposed to work.

Overrides:

printSubNodes in class MethodCallNode

Parameters:

depth - The depth of this node in the tree

Returns:

Nothing

preprocess

public void preprocess(int numTables,
                       FromList outerFromList,
                       SubqueryList outerSubqueryList,
                       PredicateList outerPredicateList)
                throws StandardException

Preprocess an expression tree. We do a number of transformations here (including subqueries, IN lists, LIKE and BETWEEN) plus subquery flattening. NOTE: This is done before the outer ResultSetNode is preprocessed.

Overrides:

preprocess in class MethodCallNode

Parameters:

numTables - Number of tables in the DML Statement

outerFromList - FromList from outer query block

outerSubqueryList - SubqueryList from outer query block

outerPredicateList - PredicateList from outer query block

Returns:

Nothing.

Throws:

StandardException - Thrown on error

generateExpression

public void generateExpression(ExpressionClassBuilder acb,
                               MethodBuilder mb)
                        throws StandardException

Do code generation for this method call

Specified by:

generateExpression in class JavaValueNode

Parameters:

acb - The ExpressionClassBuilder for the class we're generating

mb - The method the expression will go into

Returns:

The compiled Expression

Throws:

StandardException - Thrown on error

generateReceiver

protected boolean generateReceiver(ExpressionClassBuilder acb,
                                   MethodBuilder mb)
                            throws StandardException

Generate the expression that evaluates to the receiver. This is for the case where a java expression is being returned to the SQL domain, and we need to check whether the receiver is null (if so, the SQL value should be set to null, and this Java expression not evaluated). Instance method calls and field references have receivers, while class method calls and calls to constructors do not. If this Java expression does not have a receiver, this method returns null. Only generate the receiver once and cache it in a field. This is because there will be two references to the receiver, and we want to evaluate it only once.

Overrides:

generateReceiver in class JavaValueNode

Parameters:

acb - The ExpressionClassBuilder for the class being built

mb - The method the expression will go into

Returns:

true if compiled receiver, false otherwise.

Throws:

StandardException - Thrown on error

accept

public Visitable accept(Visitor v)
                 throws StandardException

Accept a visitor, and call v.visit() on child nodes as necessary.

Specified by:

accept in interface Visitable

Overrides:

accept in class MethodCallNode

Parameters:

v - the visitor

Throws:

StandardException - on error