org.eclipse.persistence.jpa.jpql.parser

Class EclipseLinkJPQLGrammar1

java.lang.Object

org.eclipse.persistence.jpa.jpql.parser.AbstractJPQLGrammar

org.eclipse.persistence.jpa.jpql.parser.EclipseLinkJPQLGrammar1

All Implemented Interfaces:

JPQLGrammar

public final class EclipseLinkJPQLGrammar1
extends AbstractJPQLGrammar

This JPQL grammar provides support for parsing JPQL queries defined in JSR-220 - Enterprise JavaBeans 3.0. EclipseLink 1.x does not provide additional support.

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.4

Field Summary

Fields

Modifier and Type	Field and Description
static EclipseLinkVersion	VERSION The EclipseLink version, which is 1.x.

Constructor Summary

Constructors

Constructor and Description
EclipseLinkJPQLGrammar1() Creates a new EclipseLinkJPQLExtension1.

Method Summary

Modifier and Type	Method and Description
protected JPQLGrammar	buildBaseGrammar() Creates the base JPQLGrammar this one extends, if one exists.
JPAVersion	getJPAVersion() Returns the JPAVersion of the Java Persistence supported by this grammar.
java.lang.String	getProvider() Returns the persistence provider name.
java.lang.String	getProviderVersion() Returns the version of the persistence provider.
protected void	initializeBNFs() Registers the JPQL query BNFs defining the JPQL grammar.
protected void	initializeExpressionFactories() Registers the ExpressionFactories required to properly parse JPQL queries.
protected void	initializeIdentifiers() Registers the JPQL identifiers support by this JPQLGrammar.
static JPQLGrammar	instance() Returns the singleton instance of this class.
java.lang.String	toString()

Methods inherited from class org.eclipse.persistence.jpa.jpql.parser.AbstractJPQLGrammar

addChildBNF, addChildFactory, addIdentifier, addIdentifiers, buildExpressionRegistry, getBaseGrammar, getExpressionRegistry, initialize, registerBNF, registerFactory, registerIdentifierRole, registerIdentifierVersion, setFallbackBNFId, setFallbackExpressionFactoryId, setHandleCollection, setHandleNestedArray, setHandleSubExpression

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

VERSION

public static final EclipseLinkVersion VERSION

The EclipseLink version, which is 1.x.

Constructor Detail

EclipseLinkJPQLGrammar1

public EclipseLinkJPQLGrammar1()

Creates a new EclipseLinkJPQLExtension1.

Method Detail

instance

public static JPQLGrammar instance()

Returns the singleton instance of this class.

Returns:

The EclipseLinkJPQLGrammar1

buildBaseGrammar

protected JPQLGrammar buildBaseGrammar()

Creates the base JPQLGrammar this one extends, if one exists.

IMPORTANT: The singleton instance of any JPQLGrammar (for example JPQLGrammar1_0.instance() cannot be used, the API does not support extending it, a new instance has to be created.

Specified by:

buildBaseGrammar in class AbstractJPQLGrammar

Returns:

The base JPQLGrammar or null if there is no base grammar

getJPAVersion

public JPAVersion getJPAVersion()

Returns the JPAVersion of the Java Persistence supported by this grammar.

Returns:

The JPA version supported by this grammar

getProvider

public java.lang.String getProvider()

Returns the persistence provider name.

Returns:

The name of the persistence provider, null should never be returned

getProviderVersion

public java.lang.String getProviderVersion()

Returns the version of the persistence provider.

Returns:

The version of the persistence provider, if one is extending the default JPQL grammar defined in the Java Persistence specification, otherwise returns an empty string

initializeBNFs

protected void initializeBNFs()

Registers the JPQL query BNFs defining the JPQL grammar.

Specified by:

initializeBNFs in class AbstractJPQLGrammar

initializeExpressionFactories

protected void initializeExpressionFactories()

Registers the ExpressionFactories required to properly parse JPQL queries. An ExpressionFactory is responsible to create an Expression object that represents a portion of the JPQL query.

Specified by:

initializeExpressionFactories in class AbstractJPQLGrammar

initializeIdentifiers

protected void initializeIdentifiers()

Registers the JPQL identifiers support by this JPQLGrammar. The registration involves registering the JPAVersion and the IdentifierRole.

Specified by:

initializeIdentifiers in class AbstractJPQLGrammar

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object