Class NullComparisonExpressionStateObject
java.lang.Object
org.eclipse.persistence.jpa.jpql.tools.model.query.AbstractStateObject
org.eclipse.persistence.jpa.jpql.tools.model.query.NullComparisonExpressionStateObject
- All Implemented Interfaces:
StateObject
A null comparison tests whether or not the single-valued path expression or input parameter is a
NULL
value.
BNF: null_comparison_expression ::= {single_valued_path_expression | input_parameter} IS [NOT] NULL
- Since:
- 2.4
- Version:
- 2.4
- See Also:
-
Field Summary
-
Constructor Summary
ConstructorDescriptionCreates a newNullComparisonExpressionStateObject
.NullComparisonExpressionStateObject
(StateObject parent, boolean not, String path) Creates a newNullComparisonExpressionStateObject
.NullComparisonExpressionStateObject
(StateObject parent, boolean not, StateObject stateObject) Creates a newNullComparisonExpressionStateObject
.NullComparisonExpressionStateObject
(StateObject parent, String path) Creates a newNullComparisonExpressionStateObject
.NullComparisonExpressionStateObject
(StateObject parent, StateObject stateObject) Creates a newNullComparisonExpressionStateObject
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
accept
(StateObjectVisitor visitor) Visits thisStateObject
by the givenvisitor
.protected void
addChildren
(List<StateObject> children) Adds the children of thisStateObject
to the given list.addNot()
Makes sure theNOT
identifier is specified.Returns the actual parsed object if thisStateObject
representation of the JPQL query was created by parsing an existing JPQL query.Returns theStateObject
representing the collection-valued path expression.boolean
hasNot()
Determines whether theNOT
identifier is used or not.boolean
Determines whether there is aStateObject
representing the collection-valued path expression.boolean
isEquivalent
(StateObject stateObject) Determines whether the givenStateObject
is equivalent to this one, i.e.void
Makes sure theNOT
identifier is not specified.void
setExpression
(NullComparisonExpression expression) Keeps a reference of theparsed object
object, which should only be done when this object is instantiated during the conversion of a parsed JPQL query intoStateObjects
.void
setNot
(boolean not) Sets whether theNOT
identifier should be part of the expression or not.void
setStateObject
(StateObject stateObject) Sets the givenStateObject
as the collection-valued path expression.void
Changes the visibility state of theNOT
identifier.protected void
toTextInternal
(Appendable writer) Prints out a string representation of thisStateObject
, which should not be used to define atrue
string representation of a JPQL query but should be used for debugging purposes.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
-
Field Details
-
NOT_PROPERTY
Notifies the visibility of theNOT
identifier has changed.- See Also:
-
STATE_OBJECT_PROPERTY
Notifies the state object property has changed.- See Also:
-
-
Constructor Details
-
NullComparisonExpressionStateObject
Creates a newNullComparisonExpressionStateObject
.- Parameters:
parent
- The parent of this state object, which cannot benull
- Throws:
NullPointerException
- The given parent cannot benull
-
NullComparisonExpressionStateObject
public NullComparisonExpressionStateObject(StateObject parent, boolean not, StateObject stateObject) Creates a newNullComparisonExpressionStateObject
.- Parameters:
parent
- The parent of this state object, which cannot benull
not
- Determines whether theNOT
identifier is part of the expression or notstateObject
- TheStateObject
representing the collection-valued path expression- Throws:
NullPointerException
- The given parent cannot benull
-
NullComparisonExpressionStateObject
Creates a newNullComparisonExpressionStateObject
.- Parameters:
parent
- The parent of this state object, which cannot benull
not
- Determines whether theNOT
identifier is part of the expression or notpath
- Either the singled-valued path expression or the input parameter- Throws:
NullPointerException
- The given parent cannot benull
-
NullComparisonExpressionStateObject
Creates a newNullComparisonExpressionStateObject
.- Parameters:
parent
- The parent of this state object, which cannot benull
stateObject
- TheStateObject
representing the collection-valued path expression- Throws:
NullPointerException
- The given parent cannot benull
-
NullComparisonExpressionStateObject
Creates a newNullComparisonExpressionStateObject
.- Parameters:
parent
- The parent of this state object, which cannot benull
path
- Either the singled-valued path expression or the input parameter- Throws:
NullPointerException
- The given parent cannot benull
-
-
Method Details
-
accept
Description copied from interface:StateObject
Visits thisStateObject
by the givenvisitor
.- Parameters:
visitor
- Thevisitor
to visit this object
-
addChildren
Description copied from class:AbstractStateObject
Adds the children of thisStateObject
to the given list.- Overrides:
addChildren
in classAbstractStateObject
- Parameters:
children
- The list used to store the children
-
addNot
Makes sure theNOT
identifier is specified.- Returns:
- This object
-
getExpression
Description copied from interface:StateObject
Returns the actual parsed object if thisStateObject
representation of the JPQL query was created by parsing an existing JPQL query.- Specified by:
getExpression
in interfaceStateObject
- Overrides:
getExpression
in classAbstractStateObject
- Returns:
- The parsed object when a JPQL query is parsed and converted into a
StateObject
ornull
when the JPQL query is manually created (i.e. not from a string)
-
getStateObject
Returns theStateObject
representing the collection-valued path expression.- Returns:
- The
StateObject
representing the collection-valued path expression
-
hasNot
public boolean hasNot()Determines whether theNOT
identifier is used or not.- Returns:
true
if theNOT
identifier is part of the expression;false
otherwise
-
hasStateObject
public boolean hasStateObject()Determines whether there is aStateObject
representing the collection-valued path expression.- Returns:
true
if theStateObject
is notnull
;false
otherwise
-
isEquivalent
Description copied from interface:StateObject
Determines whether the givenStateObject
is equivalent to this one, i.e. the information of bothStateObject
is the same.- Specified by:
isEquivalent
in interfaceStateObject
- Overrides:
isEquivalent
in classAbstractStateObject
- Parameters:
stateObject
- TheStateObject
to compare its content to this one- Returns:
true
if both object are equivalent;false
otherwise
-
removeNot
public void removeNot()Makes sure theNOT
identifier is not specified. -
setExpression
Keeps a reference of theparsed object
object, which should only be done when this object is instantiated during the conversion of a parsed JPQL query intoStateObjects
.- Parameters:
expression
- Theparsed object
representing the null expression
-
setNot
public void setNot(boolean not) Sets whether theNOT
identifier should be part of the expression or not.- Parameters:
not
-true
if theNOT
identifier should be part of the expression;false
otherwise
-
setStateObject
Sets the givenStateObject
as the collection-valued path expression.- Parameters:
stateObject
- TheStateObject
that represents the collection-valued path expression
-
toggleNot
public void toggleNot()Changes the visibility state of theNOT
identifier. -
toTextInternal
Description copied from class:AbstractStateObject
Prints out a string representation of thisStateObject
, which should not be used to define atrue
string representation of a JPQL query but should be used for debugging purposes.- Specified by:
toTextInternal
in classAbstractStateObject
- Parameters:
writer
- The writer used to print out the string representation- Throws:
IOException
- This should never happens, it is only required becauseAppendable
is used instead of any concrete class
-