You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jdo-commits@db.apache.org by mb...@apache.org on 2005/05/22 20:09:00 UTC
svn commit: r171353 [11/13] - in /incubator/jdo/trunk/query20: ./ src/
src/conf/ src/java/ src/java/org/ src/java/org/apache/
src/java/org/apache/jdo/ src/java/org/apache/jdo/impl/
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/jdoql/
src/java/org/apache/jdo/jdoql/tree/
Added: incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Declaration.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Declaration.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Declaration.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Declaration.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DescendingOrderingExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DivideExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/DoubleLiteralExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/EndsWithCallExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/EqualsExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/Expression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Expression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Expression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Expression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/ExpressionFactory.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/FieldAccessExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/FloatLiteralExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanEqualsExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/GreaterThanExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IdentifierExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IntLiteralExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/IsEmptyCallExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LessThanEqualsExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LessThanExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/LongLiteralExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/MethodCallExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/MinusExpression.java Sun May 22 11:08:57 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/query20/src/java/org/apache/jdo/jdoql/tree/Node.java
URL: http://svn.apache.org/viewcvs/incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Node.java?rev=171353&view=auto
==============================================================================
--- incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Node.java (added)
+++ incubator/jdo/trunk/query20/src/java/org/apache/jdo/jdoql/tree/Node.java Sun May 22 11:08:57 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);
+
+}