org.eclipse.persistence.jpa.jpql.model.query
Class StringLiteralStateObject

java.lang.Object
  org.eclipse.persistence.jpa.jpql.model.query.AbstractStateObject
      org.eclipse.persistence.jpa.jpql.model.query.SimpleStateObject
          org.eclipse.persistence.jpa.jpql.model.query.StringLiteralStateObject

All Implemented Interfaces:

StateObject

public class StringLiteralStateObject
extends SimpleStateObject

A string literal is enclosed in single quotes. For example: 'literal'. A string literal that includes a single quote is represented by two single quotes. For example: 'literal''s'. String literals in queries, like Java String literals, use unicode character encoding. Approximate literals support the use Java floating point literal syntax as well as SQL approximate numeric literal syntax. Enum literals support the use of Java enum literal syntax. The enum class name must be specified. Appropriate suffixes may be used to indicate the specific type of a numeric literal in accordance with the Java Language Specification. The boolean literals are TRUE and FALSE. Although predefined reserved literals appear in upper case, they are case insensitive.

Version:

2.4

See Also:

StringLiteral

Author:

Pascal Filion

Since:

2.4

Field Summary

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

TEXT_PROPERTY

Constructor Summary

StringLiteralStateObject(StateObject parent)
Creates a new StringLiteralStateObject.

StringLiteralStateObject(StateObject parent, java.lang.String literal)
Creates a new StringLiteralStateObject.

Method Summary

void	accept(StateObjectVisitor visitor) Visits this StateObject by the given visitor.
StringLiteral	getExpression() Returns the actual parsed object if this StateObject representation of the JPQL query was created by parsing an existing JPQL query.
java.lang.String	getUnquotedText() Returns the string literal without the single quotes.
boolean	hasCloseQuote() Determines whether the closing quote was present or not.
void	setExpression(StringLiteral 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.

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

getText, hasText, isEquivalent, setText, setTextInternally, toTextInternal

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

acceptUnknownVisitor, acceptUnknownVisitor, addChildren, 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

StringLiteralStateObject

public StringLiteralStateObject(StateObject parent)

Creates a new StringLiteralStateObject.

Parameters:

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

Throws:

java.lang.NullPointerException - The given parent cannot be null

StringLiteralStateObject

public StringLiteralStateObject(StateObject parent,
                                java.lang.String literal)

Creates a new StringLiteralStateObject.

Parameters:

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

literal - The string literal

Throws:

java.lang.NullPointerException - The given parent cannot be null

Method Detail

accept

public void accept(StateObjectVisitor visitor)

Visits this StateObject by the given visitor.

Parameters:

visitor - The visitor to visit this object

getExpression

public StringLiteral getExpression()

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 AbstractStateObject

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)

getUnquotedText

public java.lang.String getUnquotedText()

Returns the string literal without the single quotes.

Returns:

The unquoted text

hasCloseQuote

public boolean hasCloseQuote()

Determines whether the closing quote was present or not.

Returns:

true if the literal is ended by a single quote; false otherwise

setExpression

public void setExpression(StringLiteral 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 a string literal