db-jdo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From m..@apache.org
Subject svn commit: r158176 [51/79] - in incubator/jdo/trunk/ri11: ./ src/ src/conf/ src/java/ src/java/org/ src/java/org/apache/ src/java/org/apache/jdo/ src/java/org/apache/jdo/ejb/ src/java/org/apache/jdo/enhancer/ src/java/org/apache/jdo/impl/ src/java/org/apache/jdo/impl/enhancer/ src/java/org/apache/jdo/impl/enhancer/classfile/ src/java/org/apache/jdo/impl/enhancer/core/ src/java/org/apache/jdo/impl/enhancer/generator/ src/java/org/apache/jdo/impl/enhancer/meta/ src/java/org/apache/jdo/impl/enhancer/meta/model/ src/java/org/apache/jdo/impl/enhancer/meta/prop/ src/java/org/apache/jdo/impl/enhancer/meta/util/ src/java/org/apache/jdo/impl/enhancer/util/ src/java/org/apache/jdo/impl/fostore/ src/java/org/apache/jdo/impl/jdoql/ src/java/org/apache/jdo/impl/jdoql/jdoqlc/ src/java/org/apache/jdo/impl/jdoql/scope/ src/java/org/apache/jdo/impl/jdoql/tree/ src/java/org/apache/jdo/impl/model/ src/java/org/apache/jdo/impl/model/java/ src/java/org/apache/jdo/impl/model/java/runtime/ src/java/org/apache/jdo/impl/model/jdo/ src/java/org/apache/jdo/impl/model/jdo/caching/ src/java/org/apache/jdo/impl/model/jdo/util/ src/java/org/apache/jdo/impl/model/jdo/xml/ src/java/org/apache/jdo/impl/pm/ src/java/org/apache/jdo/impl/sco/ src/java/org/apache/jdo/impl/state/ src/java/org/apache/jdo/jdoql/ src/java/org/apache/jdo/jdoql/tree/ src/java/org/apache/jdo/model/ src/java/org/apache/jdo/model/java/ src/java/org/apache/jdo/model/jdo/ src/java/org/apache/jdo/pm/ src/java/org/apache/jdo/sco/ src/java/org/apache/jdo/state/ src/java/org/apache/jdo/store/ src/java/org/apache/jdo/util/ test/ test/conf/ test/enhancer/ test/enhancer/sempdept/ test/enhancer/sempdept/src/ test/enhancer/sempdept/src/empdept/ test/fsuid2/ test/fsuid2/org/ test/fsuid2/org/apache/ test/fsuid2/org/apache/jdo/ test/fsuid2/org/apache/jdo/pc/ test/java/ test/java/org/ test/java/org/apache/ test/java/org/apache/jdo/ test/java/org/apache/jdo/impl/ test/java/org/apache/jdo/impl/fostore/ test/java/org/apache/jdo/pc/ test/java/org/apache/jdo/pc/appid/ test/java/org/apache/jdo/pc/empdept/ test/java/org/apache/jdo/pc/serializable/ test/java/org/apache/jdo/pc/xempdept/ test/java/org/apache/jdo/test/ test/java/org/apache/jdo/test/query/ test/java/org/apache/jdo/test/util/ test/jdo/ test/jdo/org/ test/jdo/org/apache/ test/jdo/org/apache/jdo/ test/jdo/org/apache/jdo/pc/ test/jdo/org/apache/jdo/pc/appid/ test/jdo/org/apache/jdo/pc/empdept/ test/jdo/org/apache/jdo/pc/serializable/ test/jdo/org/apache/jdo/pc/xempdept/ xdocs/
Date Sat, 19 Mar 2005 01:06:11 GMT
Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Declaration.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Declaration.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Declaration.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Declaration.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a declaration expression. Examples of
+ * declarations expressions are
+ * <code>ParameterDeclarationExpression</code> and
+ * <code>VariableDeclarationExpression</code>. Declaration expressions
+ * do not have any children.
+ *
+ * @author Michael Watzek
+ */
+public interface Declaration extends Node
+{
+    /**
+     * Returns the name of the specialized declaration.
+     * @return the name
+     */
+    public String getName();
+
+    /**
+     * Returns the Java type name of the specialized declaration.
+     * @return the Java type name
+     */
+    public String getTypeName();
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,29 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents an operator defining descendent ordering of instances
+ * returned by a query execution. The order is determined by an expression
+ * such as <code>FieldAccessExpression</code>. This expression is this node's
+ * child.
+ *
+ * @author Michael Watzek
+ */
+public interface DescendingOrderingExpression extends OrderingExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a division operator.
+ * A division operator is a binary expression.
+ * The string representation of this operator is <code>/</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface DivideExpression extends BinaryExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,31 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a double literal. It does not have any children.
+ *
+ * @author Michael Watzek
+ */
+public interface DoubleLiteralExpression extends ConstantExpression
+{
+    /**
+     * Returns the double value represented by this expression.
+     * @return the double value
+     */
+    public double getDouble();
+}
\ No newline at end of file

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,29 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents the method call expression
+ * <code>String.endsWith</code>. Children of this node are a target
+ * expression (e.g. a <code>FieldAccessExpression</code>) and the method
+ * argument which is an arbitrary expression.
+ *
+ * @author Michael Watzek
+ */
+public interface EndsWithCallExpression extends MethodCallExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents an equals operator.
+ * An equals operator is a binary expression.
+ * The string representation of this operator is <code>==</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface EqualsExpression extends BinaryExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Expression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Expression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Expression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Expression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,29 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a general expression. Examples of general expressions
+ * are <code>UnaryExpression</code>, <code>BinaryExpression</code>,
+ * <code>FieldAccessExpression</code>, <code>CastExpression</code>
+ * and <code>MethodCallExpression</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface Expression extends Node
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,330 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This interface provides methods for factorizing expression nodes.
+ * Expression nodes are used as filter expressions for query trees.
+ *
+ * @author Michael Watzek
+ */
+public interface ExpressionFactory
+{
+    /**
+     * The implementation may decide to create an instance
+     * of <code>FieldAccessExpression</code>,
+     * <code>VariableAccessExpression</code> or
+     * <code>ParameterAccessExpression</code> depending on the fact
+     * whether the argument corresponds with a parameter, variable or
+     * a field of the candidate class. Optionally, the implementation
+     * may return an instance of <code>IdentifierExpression</code>
+     * which later may be replaced with its specialized counterpart
+     * semantically analysing a query tree.
+     * @param identifier the name of the identifier access expression
+     * @return the identifier access expression instance
+     */
+    public IdentifierExpression newIdentifier(String identifier);
+
+    /**
+     * Returns an instance of <code>FieldAccessExpression</code>.
+     * @param target the target expression of the field access expression
+     * @param fieldName the name of the field to access
+     * @return the field access expression instance
+     */
+    public FieldAccessExpression newFieldAccess(Expression target,
+                                                String fieldName);
+
+    /**
+     * Returns an instance of <code>StaticFieldAccessExpression</code>.
+     * @param clazz the class instance defining the field
+     * @param fieldName the name of the field to access
+     * @return the static field access expression instance
+     */
+    public StaticFieldAccessExpression newFieldAccess(Class clazz,
+                                                      String fieldName);
+
+    /**
+     * The implementation may decide to create a specialized instance
+     * of <code>MethodCallExpression</code> (for example,
+     * <code>ContainsCallExpression</code>) 
+     * depending on the argument <code>methodName</code>.
+     * Optionally, the implementation may return an instance of
+     * <code>MethodCallExpression</code>
+     * which later may be replaced with its specialized counterpart
+     * semantically analysing a query tree.
+     * @param target the target expression of the method call expression
+     * @param methodName the name of the method
+     * @param arguments the array of arguments
+     * @return the specialized method call expression instance
+     */
+    public MethodCallExpression newMethodCall(
+        Expression target, String methodName, Expression[] arguments);
+
+    /**
+     * Returns an instance of <code>CastExpression</code>.
+     * @param clazz the Java class to cast the argument
+     * <code>expression</code> to
+     * @param expression the expression to cast
+     * @return the cast expression instance
+     */
+    public CastExpression newCast(Class clazz, Expression expression);
+
+    //////////////////////////////////////////////////////////
+    //methods for factorizing specialized constant expressions
+    //////////////////////////////////////////////////////////
+
+    /**
+     * Returns an instance of <code>BooleanLiteralExpression</code>.
+     * @param b the value wrapped by the boolean expression
+     * @return the boolean expression instance
+     */
+    public ConstantExpression newConstant(boolean b);
+
+    /**
+     * Returns an instance of <code>ByteLiteralExpression</code>.
+     * @param b the value wrapped by the byte expression
+     * @return the byte expression instance
+     */
+    public ConstantExpression newConstant(byte b);
+
+    /**
+     * Returns an instance of <code>CharLiteralExpression</code>.
+     * @param c the value wrapped by the char expression
+     * @return the char expression instance
+     */
+    public ConstantExpression newConstant(char c);
+
+    /**
+     * Returns an instance of <code>DoubleLiteralExpression</code>.
+     * @param d the value wrapped by the double expression
+     * @return the double expression instance
+     */
+    public ConstantExpression newConstant(double d);
+
+    /**
+     * Returns an instance of <code>FloatLiteralExpression</code>.
+     * @param f the value wrapped by the float expression
+     * @return the float expression instance
+     */
+    public ConstantExpression newConstant(float f);
+
+    /**
+     * Returns an instance of <code>IntLiteralExpression</code>.
+     * @param i the value wrapped by the int expression
+     * @return the int expression instance
+     */
+    public ConstantExpression newConstant(int i);
+
+    /**
+     * Returns an instance of <code>LongLiteralExpression</code>.
+     * @param l the value wrapped by the long expression
+     * @return the long expression instance
+     */
+    public ConstantExpression newConstant(long l);
+
+    /**
+     * Returns an instance of <code>ShortLiteralExpression</code>.
+     * @param s the value wrapped by the short expression
+     * @return the short expression instance
+     */
+    public ConstantExpression newConstant(short s);
+
+    /**
+     * Returns an instance of <code>ConstantExpression</code>.
+     * This method handles <code>null</code> as a constant expression.
+     * @param value the object wrapped by the constant expression
+     * @return the constant expression instance
+     */
+    public ConstantExpression newConstant(Object value);
+
+    ///////////////////////////////////////////////////////
+    //methods for factorizing specialized unary expressions
+    ///////////////////////////////////////////////////////
+
+    /**
+     * Returns a complement expression for the argument
+     * <code>expr</code>.
+     * @param expr the expression argument for the operation
+     * @return the complement expression instance
+     */
+    public ComplementExpression newComplement(Expression expr);
+
+    /**
+     * Returns a unary minus expression for the argument
+     * <code>expr</code>.
+     * @param expr the expression argument for the operation
+     * @return the unary minus expression instance
+     */
+    public UnaryMinusExpression newMinus(Expression expr);
+
+    /**
+     * Returns a not expression for the argument
+     * <code>expr</code>.
+     * @param expr the expression argument for the operation
+     * @return the not expression instance
+     */
+    public NotExpression newNot(Expression expr);
+
+    /**
+     * Returns a plus expression for the argument
+     * <code>expr</code>.
+     * @param expr the expression argument for the operation
+     * @return the plus expression instance
+     */
+    public UnaryPlusExpression newPlus(Expression expr);
+
+    ////////////////////////////////////////////////////////
+    //methods for factorizing specialized binary expressions
+    ////////////////////////////////////////////////////////
+
+    /**
+     * Returns an and expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the and expression instance
+     */
+    public AndExpression newAnd(Expression left, Expression right);
+
+    /**
+     * Returns a conditional and expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the conditional and expression instance
+     */
+    public ConditionalAndExpression newConditionalAnd(Expression left,
+                                                      Expression right);
+
+    /**
+     * Returns a conditional or expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the conditional or expression instance
+     */
+    public ConditionalOrExpression newConditionalOr(Expression left,
+                                                    Expression right);
+
+    /**
+     * Returns a divide expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * This method throws <code>NullPointerException</code> if one of
+     * the arguments <code>left</code> or <code>right</code> are
+     * <code>null</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the divide expression instance
+     */
+    public DivideExpression newDivide(Expression left, Expression right);
+
+    /**
+     * Returns an equals expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the equals expression instance
+     */
+    public EqualsExpression newEquals(Expression left, Expression right);
+
+    /**
+     * Returns a greater than expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the greater than expression instance
+     */
+    public GreaterThanExpression newGreaterThan(Expression left,
+                                                Expression right);
+
+    /**
+     * Returns a greater than equals expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the greater than equals expression instance
+     */
+    public GreaterThanEqualsExpression newGreaterThanEquals(Expression left,
+                                                            Expression right);
+
+    /**
+     * Returns a less than expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the less than expression instance
+     */
+    public LessThanExpression newLessThan(Expression left, Expression right);
+
+    /**
+     * Returns a less than equals expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the less than equals expression instance
+     */
+    public LessThanEqualsExpression newLessThanEquals(Expression left,
+                                                      Expression right);
+
+    /**
+     * Returns a minus expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the minus expression instance
+     */
+    public MinusExpression newMinus(Expression left, Expression right);
+
+    /**
+     * Returns a not equals expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the not equals expression instance
+     */
+    public NotEqualsExpression newNotEquals(Expression left, Expression right);
+
+    /**
+     * Returns a plus expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the plus expression instance
+     */
+    public PlusExpression newPlus(Expression left, Expression right);
+
+    /**
+     * Returns an or expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * This method throws <code>NullPointerException</code> if one of
+     * the arguments <code>left</code> or <code>right</code> are
+     * <code>null</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the or expression instance
+     */
+    public OrExpression newOr(Expression left, Expression right);
+
+    /**
+     * Returns a times expression for the arguments
+     * <code>left</code> and <code>right</code>.
+     * @param left the left expression argument for the operation
+     * @param right the right expression argument for the operation
+     * @return the times expression instance
+     */
+    public TimesExpression newTimes(Expression left, Expression right);
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+import javax.jdo.PersistenceManager;
+
+import org.apache.jdo.jdoql.JDOQueryException;
+
+/**
+ * This node represents a field access expression. Field access expression
+ * have exactly one child, the target expression.
+ * This expression can be an arbitrary expression.
+ *
+ * @author Michael Watzek
+ */
+public interface FieldAccessExpression extends IdentifierExpression
+{
+    /**
+     * Returns the target expression of this field access.
+     * The target expression can be an instance of
+     * <code>ThisExpression</code> or an instance of an arbitrary other
+     * <code>Expression</code>, e.g. <code>FieldAccessExpression</code>.
+     * @return the target expression
+     */
+    public Expression getTarget();
+
+    /**
+     * Returns the value of the field corresponding with this
+     * field access expression for the argument <code>object</code>.
+     * @param pm the persistence manager of the query
+     * @param object the instance for which to return the field value
+     * @return the field value for <code>object</code>
+     * @exception JDOQueryException if access to the corresponding field of this
+     * expression is denied
+     */
+    public Object getFieldValue(PersistenceManager pm, Object object);
+}
+

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,31 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a float literal. It does not have any children.
+ *
+ * @author Michael Watzek
+ */
+public interface FloatLiteralExpression extends ConstantExpression
+{
+    /**
+     * Returns the float value represented by this expression.
+     * @return the float value
+     */
+    public float getFloat();
+}
\ No newline at end of file

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a greater than equals operator.
+ * A greater than equals operator is a binary expression.
+ * The string representation of this operator is <code>>=</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface GreaterThanEqualsExpression extends BinaryExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a greater than operator.
+ * A greater equals operator is a binary expression.
+ * The string representation of this operator is <code>></code>.
+ *
+ * @author Michael Watzek
+ */
+public interface GreaterThanExpression extends BinaryExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,40 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents an identifier expression.
+ * Examples of identifier expressions are
+ * <code>FieldAccessExpression</code>, <code>ParameterAccessExpression</code>,
+ * <code>ThisExpression</code> or <code>VariableAccessExpression</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface IdentifierExpression extends Expression
+{
+    /**
+     * Returns the name of the specialized identifier.
+     * @return the name
+     */
+    public String getName();
+
+    /**
+     * Returns the Java type name of the specialized identifier.
+     * @return the Java type name
+     */
+    public String getTypeName();
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,31 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a integer literal. It does not have any children.
+ *
+ * @author Michael Watzek
+ */
+public interface IntLiteralExpression extends ConstantExpression
+{
+    /**
+     * Returns the int value represented by this expression.
+     * @return the int value
+     */
+    public int getInt();
+}
\ No newline at end of file

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents the method call expression
+ * <code>Collection.isEmpty</code>. This node's child is a target
+ * expression (e.g. an instance of <code>FieldAccessExpression</code>).
+ *
+ * @author Michael Watzek
+ */
+public interface IsEmptyCallExpression extends MethodCallExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a less than equals operator.
+ * A less than equals operator is a binary expression.
+ * The string representation of this operator is <code><=</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface LessThanEqualsExpression extends BinaryExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a less than operator.
+ * A less than operator is a binary expression.
+ * The string representation of this operator is <code><</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface LessThanExpression extends BinaryExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,31 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a long literal. It does not have any children.
+ *
+ * @author Michael Watzek
+ */
+public interface LongLiteralExpression extends ConstantExpression
+{
+    /**
+     * Returns the long value represented by this expression.
+     * @return the long value
+     */
+    public long getLong();
+}
\ No newline at end of file

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a method call expression.
+ * Examples of method call expressions are
+ * <code>ContainsCallExpression</code>, <code>IsEmptyCallExpression</code>,
+ * <code>EndsWithCallExpression</code> and
+ * <code>StartsWithCallExpression</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface MethodCallExpression extends Expression
+{
+    /**
+     * Returns the target expression of this method call.
+     * The target expression can be an instance of
+     * <code>ThisExpression</code> or an instance of an arbitrary other
+     * <code>Expression</code>, e.g. <code>FieldAccessExpression</code>.
+     * @return the target expression
+     */
+    public Expression getTarget();
+
+    /**
+     * Returns the method name.
+     * @return the method name
+     */
+    public String getMethodName();
+
+    /**
+     * Returns the argument array of this method call.
+     * @return the argument array
+     */
+    public Expression[] getArguments();
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,27 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+/**
+ * This node represents a binary minus operator.
+ * The string representation of this operator is <code>-</code>.
+ *
+ * @author Michael Watzek
+ */
+public interface MinusExpression extends BinaryExpression
+{
+}

Added: incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Node.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Node.java?view=auto&rev=158176
==============================================================================
--- incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Node.java (added)
+++ incubator/jdo/trunk/ri11/src/java/org/apache/jdo/jdoql/tree/Node.java Fri Mar 18 17:02:29 2005
@@ -0,0 +1,119 @@
+/*
+ * Copyright 2005 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at 
+ * 
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software 
+ * distributed under the License is distributed on an "AS IS" BASIS, 
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+ * See the License for the specific language governing permissions and 
+ * limitations under the License.
+ */
+
+package org.apache.jdo.jdoql.tree;
+
+import java.io.Serializable;
+
+/**
+ * This is the base interface of all nodes. Examples of nodes are
+ * <CandidateClass</code>, <code>Declaration</code>, <code>Expression</code>
+ * and <code>OrderingExpression<code>.
+ *
+ * @author Michael Watzek
+ */
+public interface Node extends Serializable
+{
+    /**
+     * Returns the user object.
+     * @return the ouser object
+     */
+    public Object getObject();
+
+    /**
+     * Sets the user object.
+     * @param object the user object
+     */
+    public void setObject(Object object);
+
+    /**
+     * Returns this node's parent node.
+     * @return the parent node
+     */
+    public Node getParent();
+
+    /**
+     * Sets the parent of this node.
+     * @param parent the parent node
+     */
+    public void setParent(Node parent);
+
+    /**
+     * Returns this node's children.
+     * @return the children
+     */
+    public Node[] getChildren();
+
+    /**
+     * Returns the Java type of this node.
+     * @return the Java type
+     */
+    public Class getJavaClass();
+
+    /**
+     * Returns the token type of this node.
+     * @return the token type
+     */
+    public int getTokenType();
+
+    /**
+     * This method is called by the tree walker when this node is walked
+     * but its children have not been walked yet.
+     * It delegates to the argument <code>visitor</code>.
+     * @param visitor the node visitor
+     */
+    public void arrive(NodeVisitor visitor);
+
+    /**
+     * This method is called by the tree walker when this node is walked
+     * and all of its children have been walked.
+     * It delegates to the argument <code>visitor</code>.
+     * The argument <code>results</code> contains the result instances
+     * returned by all <code>leave</code> methods of this node's children.
+     * This method returns the result instance of the delegation call
+     * of the argument <code>visitor</code>.
+     * @param visitor the node visitor
+     * @param results the result array containing result instances of
+     * this node's children
+     * @return the result instance of the delegation call
+     * of the argument <code>visitor</code>
+     */
+    public Object leave(NodeVisitor visitor, Object[] results);
+
+    /**
+     * This method is called by the tree walker after walking each child
+     * except the last child. 
+     * It delegates to the argument <code>visitor</code>. The argument
+     * <code>resultOfPreviousChild</code> contains the result instance
+     * returned by the <code>leave</code> method of the last walked
+     * child. The argument <code></code> indicates the index of the
+     * next child in the children array returned by method
+     * <code>getChildren</code>. If this method returns
+     * <code>false</code> then the tree walker does not walk any more
+     * children of this node. Instead, it calls method
+     * <code>leave</code> immediately.
+     * @param visitor the node visitor
+     * @param resultOfPreviousChild the result computed by leaving the
+     * previous child node
+     * @param indexOfNextChild the index in the children array of the
+     * next child to walk
+     * @return <code>false</code> if remaining children should not be walked
+     */
+    public boolean walkNextChild(NodeVisitor visitor,
+                                 Object resultOfPreviousChild,
+                                 int indexOfNextChild);
+
+}



Mime
View raw message