Package org.eclipse.persistence.jpa.jpql.tools.model.query

Class SubExpressionStateObject

java.lang.Object

org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractStateObject

org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractEncapsulatedExpressionStateObject

org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractSingleEncapsulatedExpressionStateObject

org.eclipse.persistence.jpa.jpql.tools.model.query.SubExpressionStateObject

All Implemented Interfaces:

StateObject

public class SubExpressionStateObject
extends AbstractSingleEncapsulatedExpressionStateObject

This expression wraps a sub-expression within parenthesis.

BNF: expression ::= (sub_expression)

Since:

2.4

Version:

2.4

Author:

Pascal Filion

See Also:

SubExpression

Field Summary

Fields inherited from class org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractSingleEncapsulatedExpressionStateObject

STATE_OBJECT_PROPERTY

Constructor Summary

Constructors

Constructor	Description
SubExpressionStateObject(StateObject parent)	Creates a new SubExpressionStateObject.
SubExpressionStateObject(StateObject parent, String jpqlFragment, String queryBNFId)	Creates a new SubExpressionStateObject.
SubExpressionStateObject(StateObject parent, StateObject stateObject)	Creates a new SubExpressionStateObject.

Method Summary

Modifier and Type	Method	Description
void	accept(StateObjectVisitor visitor)	Visits this StateObject by the given visitor.
SubExpression	getExpression()	Returns the actual parsed object if this StateObject representation of the JPQL query was created by parsing an existing JPQL query.
String	getIdentifier()	Returns the JPQL identifier of the expression represented by this AbstractSingleEncapsulatedExpressionStateObject.
protected String	getQueryBNFId()	Returns the unique identifier of the JPQLQueryBNF that will determine how to parse the encapsulated expression.
void	setExpression(SubExpression expression)	Keeps a reference of the parsed object object, which should only be done when this object is instantiated during the conversion of a parsed JPQL query into StateObjects.
void	setQueryBNFId(String queryBNFId)	Sets the unique identifier of the JPQLQueryBNF that is used to parse the encapsulated expression.
void	setStateObject(StateObject stateObject)	Sets the given StateObject to represent the new encapsulated expression.

Methods inherited from class org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractSingleEncapsulatedExpressionStateObject

addChildren, getStateObject, hasStateObject, isEquivalent, parse, toTextEncapsulatedExpression

Methods inherited from class org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractEncapsulatedExpressionStateObject

toTextInternal

Methods inherited from class org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractStateObject

acceptUnknownVisitor, acceptUnknownVisitor, addProblems, addPropertyChangeListener, areEquivalent, buildProblem, buildProblem, buildStateObject, buildStateObjects, checkParent, children, decorate, equals, findIdentificationVariable, firePropertyChanged, getChangeSupport, getDeclaration, getDecorator, getGrammar, getManagedTypeProvider, getParent, getQueryBuilder, getRoot, getType, getType, getTypeHelper, getTypeRepository, hashCode, initialize, isDecorated, parent, parent, parent, removePropertyChangeListener, setExpression, setParent, toString, toString, toStringInternal, toStringItems, toText

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

SubExpressionStateObject

public SubExpressionStateObject(StateObject parent)

Creates a new SubExpressionStateObject.

Parameters:

parent - The parent of this state object, which cannot be null

Throws:

NullPointerException - The given parent cannot be null

SubExpressionStateObject

public SubExpressionStateObject(StateObject parent,
                                StateObject stateObject)

Creates a new SubExpressionStateObject.

Parameters:

parent - The parent of this state object, which cannot be null

stateObject - The StateObject representing the encapsulated expression

Throws:

NullPointerException - The given parent cannot be null

SubExpressionStateObject

public SubExpressionStateObject(StateObject parent,
                                String jpqlFragment,
                                String queryBNFId)

Creates a new SubExpressionStateObject.

Parameters:

parent - The parent of this state object, which cannot be null

jpqlFragment - The portion of the query representing the encapsulated expression

queryBNFId - The unique identifier of the .JPQLQueryBNF JPQLQueryBNF that is used to parse the encapsulated expression

Throws:

NullPointerException - The given parent cannot be null

Method Detail

accept

public void accept(StateObjectVisitor visitor)

Description copied from interface: StateObject

Visits this StateObject by the given visitor.

Parameters:

visitor - The visitor to visit this object

getExpression

public SubExpression getExpression()

Description copied from interface: StateObject

Returns the actual parsed object if this StateObject representation of the JPQL query was created by parsing an existing JPQL query.

Specified by:

getExpression in interface StateObject

Overrides:

getExpression in class AbstractSingleEncapsulatedExpressionStateObject

Returns:

The parsed object when a JPQL query is parsed and converted into a StateObject or null when the JPQL query is manually created (i.e. not from a string)

getIdentifier

public String getIdentifier()

Description copied from class: AbstractEncapsulatedExpressionStateObject

Returns the JPQL identifier of the expression represented by this AbstractSingleEncapsulatedExpressionStateObject.

Specified by:

getIdentifier in class AbstractEncapsulatedExpressionStateObject

Returns:

The JPQL identifier that is shown before the left parenthesis

getQueryBNFId

protected String getQueryBNFId()

Description copied from class: AbstractSingleEncapsulatedExpressionStateObject

Returns the unique identifier of the JPQLQueryBNF that will determine how to parse the encapsulated expression.

Specified by:

getQueryBNFId in class AbstractSingleEncapsulatedExpressionStateObject

Returns:

The non-null ID of the BNF

setExpression

public void setExpression(SubExpression expression)

Keeps a reference of the parsed object object, which should only be done when this object is instantiated during the conversion of a parsed JPQL query into StateObjects.

Parameters:

expression - The parsed object representing an encapsulated expression

setQueryBNFId

public void setQueryBNFId(String queryBNFId)

Sets the unique identifier of the JPQLQueryBNF that is used to parse the encapsulated expression.

Parameters:

queryBNFId - The non-null ID of the BNF

Throws:

NullPointerException - The query BNF ID cannot be null

setStateObject

public void setStateObject(StateObject stateObject)

Description copied from class: AbstractSingleEncapsulatedExpressionStateObject

Sets the given StateObject to represent the new encapsulated expression.

Overrides:

setStateObject in class AbstractSingleEncapsulatedExpressionStateObject

Parameters:

stateObject - The new encapsulated StateObject