org.hibernate.engine.jdbc.env.spi

Interface IdentifierHelper

All Known Implementing Classes:

NormalizingIdentifierHelperImpl

public interface IdentifierHelper

Helper for handling Identifier instances.

Method Summary

Modifier and Type	Method and Description
Identifier	applyGlobalQuoting(String text) Needed to account for certain fields (Column.columnDefinition() comes to mind) that need to be quoted id global identifier quoting is requested, but only for spec compliance.
boolean	isReservedWord(String word) Check whether the given word represents a reserved word.
Identifier	normalizeQuoting(Identifier identifier) Essentially quotes the identifier if it needs to be.
Identifier	toIdentifier(String text) Generate an Identifier instance from its simple name as obtained from mapping information.
Identifier	toIdentifier(String text, boolean quoted) Generate an Identifier instance from its simple name as obtained from mapping information.
String	toMetaDataCatalogName(Identifier catalogIdentifier) Render the Identifier representation of a catalog name into the String form needed in DatabaseMetaData calls.
String	toMetaDataObjectName(Identifier identifier) Render the Identifier representation of an object name (table, sequence, etc) into the String form needed in DatabaseMetaData calls.
String	toMetaDataSchemaName(Identifier schemaIdentifier) Render the Identifier representation of a schema name into the String form needed in DatabaseMetaData calls.

Method Detail

normalizeQuoting

Identifier normalizeQuoting(Identifier identifier)

Essentially quotes the identifier if it needs to be. Useful to apply global quoting, as well as reserved word quoting after calls to naming strategies.

Parameters:

identifier - The identifier for which to normalize quoting.

Returns:

The quoting-normalized Identifier.

toIdentifier

Identifier toIdentifier(String text)

Generate an Identifier instance from its simple name as obtained from mapping information.

Note that Identifiers returned from here may be implicitly quoted based on 'globally quoted identifiers' or based on reserved words.

Parameters:

text - The text form of a name as obtained from mapping information.

Returns:

The identifier form of the name.

toIdentifier

Identifier toIdentifier(String text,
                        boolean quoted)

Generate an Identifier instance from its simple name as obtained from mapping information. Additionally, this form takes a boolean indicating whether to explicitly quote the Identifier.

Note that Identifiers returned from here may be implicitly quoted based on 'globally quoted identifiers' or based on reserved words.

Parameters:

text - The text form of a name as obtained from mapping information.

quoted - Is the identifier to be quoted explicitly.

Returns:

The identifier form of the name.

applyGlobalQuoting

Identifier applyGlobalQuoting(String text)

Needed to account for certain fields (Column.columnDefinition() comes to mind) that need to be quoted id global identifier quoting is requested, but only for spec compliance. TBH, I can not think of a argument why column-definitions should ever be *globally* quoted, but the spec is the spec.

Parameters:

text - The text to be (possibly) quoted

Returns:

The identifier form

isReservedWord

boolean isReservedWord(String word)

Check whether the given word represents a reserved word.

Parameters:

word - The word to check

Returns:

true if the given word represents a reserved word; false otherwise.

toMetaDataCatalogName

String toMetaDataCatalogName(Identifier catalogIdentifier)

Render the Identifier representation of a catalog name into the String form needed in DatabaseMetaData calls.

Parameters:

catalogIdentifier - The Identifier representation of a catalog name

Returns:

The String representation of the given catalog name

toMetaDataSchemaName

String toMetaDataSchemaName(Identifier schemaIdentifier)

Render the Identifier representation of a schema name into the String form needed in DatabaseMetaData calls.

Parameters:

schemaIdentifier - The Identifier representation of a schema name

Returns:

The String representation of the given schema name

toMetaDataObjectName

String toMetaDataObjectName(Identifier identifier)

Render the Identifier representation of an object name (table, sequence, etc) into the String form needed in DatabaseMetaData calls.

Parameters:

identifier - The Identifier representation of an object name

Returns:

The String representation of the given object name