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

Class BaseJPQLQueryFormatter

java.lang.Object

org.eclipse.persistence.jpa.jpql.tools.model.BaseJPQLQueryFormatter

All Implemented Interfaces:

IJPQLQueryFormatter, StateObjectVisitor

Direct Known Subclasses:

AbstractActualJPQLQueryFormatter, AbstractJPQLQueryFormatter

public abstract class BaseJPQLQueryFormatter
extends Object
implements StateObjectVisitor, IJPQLQueryFormatter

An abstract implementation of a IJPQLQueryFormatter.

Since:

2.4

Version:

2.4

Author:

Pascal Filion

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.persistence.jpa.jpql.tools.model.IJPQLQueryFormatter

IJPQLQueryFormatter.IdentifierStyle

Field Summary

Fields

Modifier and Type	Field	Description
protected static String	COMMA	The constant for a comma: ','.
protected static String	COMMA_SPACE	The constant for a comma followed by a space: ', '.
protected static String	LEFT_PARENTHESIS	The constant for the left parenthesis: '('.
protected static String	RIGHT_PARENTHESIS	The constant for the right parenthesis: ')'.
protected static String	SPACE	The constant for a space: ' '.
protected IJPQLQueryFormatter.IdentifierStyle	style	Determines how the JPQL identifiers are written out.
protected StringBuilder	writer	The holder of the string representation of the JPQL query.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BaseJPQLQueryFormatter(IJPQLQueryFormatter.IdentifierStyle style)	Creates a new BaseJPQLQueryFormatter.

Method Summary

Modifier and Type	Method	Description
protected String	formatIdentifier(String identifier)	Formats the given JPQL identifier, if it needs to be decorated with more information.
IJPQLQueryFormatter.IdentifierStyle	getIdentifierStyle()	Returns the style to use when formatting the JPQL identifiers.
String	toString()
String	toString(StateObject stateObject)	Creates a string representation of the given StateObject.
protected void	toText(StateObject stateObject)	Visits the given StateObject and prevents its decorator to be called, which will prevent any possible recursion when the decorator is outputting the information.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.persistence.jpa.jpql.tools.model.query.StateObjectVisitor

visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Field Detail

style

protected final IJPQLQueryFormatter.IdentifierStyle style

Determines how the JPQL identifiers are written out.

writer

protected final StringBuilder writer

The holder of the string representation of the JPQL query.

COMMA

protected static final String COMMA

The constant for a comma: ','.

See Also:

Constant Field Values

COMMA_SPACE

protected static final String COMMA_SPACE

The constant for a comma followed by a space: ', '.

See Also:

Constant Field Values

LEFT_PARENTHESIS

protected static final String LEFT_PARENTHESIS

The constant for the left parenthesis: '('.

See Also:

Constant Field Values

RIGHT_PARENTHESIS

protected static final String RIGHT_PARENTHESIS

The constant for the right parenthesis: ')'.

See Also:

Constant Field Values

SPACE

protected static final String SPACE

The constant for a space: ' '.

See Also:

Constant Field Values

Constructor Detail

BaseJPQLQueryFormatter

protected BaseJPQLQueryFormatter(IJPQLQueryFormatter.IdentifierStyle style)

Creates a new BaseJPQLQueryFormatter.

Parameters:

style - Determines how the JPQL identifiers are written out, which is used if the StateObject was modified after its creation

Throws:

NullPointerException - The IJPQLQueryFormatter.IdentifierStyle cannot be null

Method Detail

formatIdentifier

protected String formatIdentifier(String identifier)

Formats the given JPQL identifier, if it needs to be decorated with more information. Which depends on how the string is created.

Parameters:

identifier - JPQL identifier to format

Returns:

By default the given identifier is returned

getIdentifierStyle

public IJPQLQueryFormatter.IdentifierStyle getIdentifierStyle()

Returns the style to use when formatting the JPQL identifiers.

Returns:

One of the possible ways to format the JPQL identifiers

toString

public String toString()

Overrides:

toString in class Object

toString

public String toString(StateObject stateObject)

Description copied from interface: IJPQLQueryFormatter

Creates a string representation of the given StateObject.

Specified by:

toString in interface IJPQLQueryFormatter

Parameters:

stateObject - The StateObject that represents a complete or incomplete JPQL query

Returns:

The string representation of the given StateObject

toText

protected void toText(StateObject stateObject)

Visits the given StateObject and prevents its decorator to be called, which will prevent any possible recursion when the decorator is outputting the information.

Parameters:

stateObject - The decorated StateObject to traverse without going through the decorator