EclipseLink 2.5.0, build 'v20130507-3faac2b' API Reference

org.eclipse.persistence.jpa.jpql.parser
Class ExpressionFactory

java.lang.Object
  extended by org.eclipse.persistence.jpa.jpql.parser.ExpressionFactory
All Implemented Interfaces:
java.lang.Comparable<ExpressionFactory>
Direct Known Subclasses:
AbsExpressionFactory, AbstractLiteralExpressionFactory, AbstractSchemaNameFactory, AllOrAnyExpressionFactory, AndExpressionFactory, ArithmeticExpressionFactory, AsOfClauseFactory, AvgFunctionFactory, BadExpressionFactory, BetweenExpressionFactory, CaseExpressionFactory, CastExpressionFactory, CoalesceExpressionFactory, CollectionMemberDeclarationFactory, CollectionMemberExpressionFactory, ComparisonExpressionFactory, ConcatExpressionFactory, ConnectByClauseFactory, ConstructorExpressionFactory, CountFunctionFactory, DatabaseTypeFactory, DateTimeFactory, DeleteClauseFactory, DeleteStatementFactory, EntryExpressionFactory, ExistsExpressionFactory, ExtractExpressionFactory, FromClauseFactory, FunctionExpressionFactory, GeneralIdentificationExpressionFactory, GroupByClauseFactory, GroupByItemFactory, HavingClauseFactory, HierarchicalQueryClauseFactory, IdentificationVariableDeclarationFactory, IdentificationVariableFactory, IndexExpressionFactory, InExpressionFactory, InternalOrderByItemFactory, IsExpressionFactory, JoinFactory, KeywordExpressionFactory, LengthExpressionFactory, LikeExpressionFactory, LocateExpressionFactory, LowerExpressionFactory, MaxFunctionFactory, MinFunctionFactory, ModExpressionFactory, NotExpressionFactory, NullIfExpressionFactory, ObjectExpressionFactory, OnClauseFactory, OrderByClauseFactory, OrderByItemFactory, OrderSiblingsByClauseFactory, OrExpressionFactory, RangeDeclarationFactory, RangeVariableDeclarationFactory, RegexpExpressionFactory, ResultVariableFactory, SelectClauseFactory, SelectStatementFactory, SimpleSelectStatementFactory, SizeExpressionFactory, SqrtExpressionFactory, StartWithClauseFactory, StringLiteralFactory, SubstringExpressionFactory, SumFunctionFactory, TableExpressionFactory, TableVariableDeclarationFactory, TreatExpressionFactory, TrimExpressionFactory, TypeExpressionFactory, UnionClauseFactory, UnknownExpressionFactory, UpdateClauseFactory, UpdateItemFactory, UpdateItemStateFieldPathExpressionFactory, UpdateStatementFactory, UpperExpressionFactory, WhenClauseFactory, WhereClauseFactory

public abstract class ExpressionFactory
extends java.lang.Object
implements java.lang.Comparable<ExpressionFactory>

An ExpressionFactory is responsible to parse a portion of JPQL query which starts with one of the factory's JPQL identifiers.

Provisional API: This interface is part of an interim API that is still under development and expected to change significantly before reaching stability. It is available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.

Version:
2.5
Author:
Pascal Filion
Since:
2.3

Constructor Summary
protected ExpressionFactory(java.lang.String id, java.lang.String... identifiers)
          Creates a new ExpressionFactory.
 
Method Summary
protected abstract  AbstractExpression buildExpression(AbstractExpression parent, WordParser wordParser, java.lang.String word, JPQLQueryBNF queryBNF, AbstractExpression expression, boolean tolerant)
          Creates a new Expression.
 int compareTo(ExpressionFactory expressionFactory)
          
 boolean equals(java.lang.Object object)
          
 ExpressionRegistry getExpressionRegistry()
          Returns the registry containing the JPQLQueryBNFs and the ExpressionFactories that are used to properly parse a JPQL query.
 java.lang.String getId()
          Returns the unique identifier of this ExpressionFactory.
 int hashCode()
          
 java.lang.String[] identifiers()
          Returns the JPQL identifiers handled by this factory.
 java.lang.String toString()
          
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ExpressionFactory

protected ExpressionFactory(java.lang.String id,
                            java.lang.String... identifiers)
Creates a new ExpressionFactory.

Parameters:
id - The unique identifier of this ExpressionFactory
identifiers - The JPQL identifiers handled by this factory
Throws:
java.lang.NullPointerException - The given unique identifier cannot be null or the list of JPQL identifiers was null
Method Detail

buildExpression

protected abstract AbstractExpression buildExpression(AbstractExpression parent,
                                                      WordParser wordParser,
                                                      java.lang.String word,
                                                      JPQLQueryBNF queryBNF,
                                                      AbstractExpression expression,
                                                      boolean tolerant)
Creates a new Expression.

Parameters:
parent - The parent AbstractExpression
wordParser - The text to parse based on the current position of the cursor
word - The current word being parsed
queryBNF - The BNF grammar that was used to identifier this factory to be capable to parse a portion of the query
expression - During the parsing, it is possible the first part of an expression was parsed which needs to be used as a sub-expression of the newly created expression
Returns:
A new AbstractExpression representing the portion or the totality of the text held by WordParser starting at the cursor position

compareTo

public final int compareTo(ExpressionFactory expressionFactory)

Specified by:
compareTo in interface java.lang.Comparable<ExpressionFactory>

equals

public final boolean equals(java.lang.Object object)

Overrides:
equals in class java.lang.Object

getExpressionRegistry

public final ExpressionRegistry getExpressionRegistry()
Returns the registry containing the JPQLQueryBNFs and the ExpressionFactories that are used to properly parse a JPQL query.

Returns:
The registry containing the information related to the JPQL grammar

getId

public final java.lang.String getId()
Returns the unique identifier of this ExpressionFactory.

Returns:
The identifier used to register this ExpressionFactory with ExpressionRegistry

hashCode

public final int hashCode()

Overrides:
hashCode in class java.lang.Object

identifiers

public final java.lang.String[] identifiers()
Returns the JPQL identifiers handled by this factory.

Returns:
The list of JPQL identifiers this factory knows how to parse

toString

public final java.lang.String toString()

Overrides:
toString in class java.lang.Object

EclipseLink 2.5.0, build 'v20130507-3faac2b' API Reference