org.alfresco.hibernate

Class DialectFactory

java.lang.Object

org.alfresco.hibernate.DialectFactory

public class DialectFactory
extends java.lang.Object

A factory for generating Dialect instances.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DialectFactory.DatabaseDialectMapper For a given database product name, instances of DatabaseDialectMapper know which Dialect to use for different versions.
static class	DialectFactory.VersionInsensitiveMapper A simple DatabaseDialectMapper for dialects which are independent of the underlying database product version.

Constructor Summary

Constructors

Constructor and Description
DialectFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static org.hibernate.dialect.Dialect	buildDialect(java.util.Properties props, java.lang.String databaseName, int databaseMajorVersion) Builds an appropriate Dialect instance.
static org.hibernate.dialect.Dialect	buildDialect(java.lang.String dialectName) Returns a dialect instance given the name of the class to use.
static org.hibernate.dialect.Dialect	determineDialect(java.lang.String databaseName, int databaseMajorVersion) Determine the appropriate Dialect to use given the database product name and major version.

Methods inherited from class java.lang.Object

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

Constructor Detail

DialectFactory

public DialectFactory()

Method Detail

buildDialect

public static org.hibernate.dialect.Dialect buildDialect(java.util.Properties props,
                                         java.lang.String databaseName,
                                         int databaseMajorVersion)
                                                  throws org.hibernate.HibernateException

Builds an appropriate Dialect instance.

If a dialect is explicitly named in the incoming properties, it is used. Otherwise, the database name and version (obtained from connection metadata) are used to make the dertemination.

An exception is thrown if a dialect was not explicitly set and the database name is not known.

Parameters:

props - The configuration properties.

databaseName - The name of the database product (obtained from metadata).

databaseMajorVersion - The major version of the database product (obtained from metadata).

Returns:

The appropriate dialect.

Throws:

org.hibernate.HibernateException - No dialect specified and database name not known.

determineDialect

public static org.hibernate.dialect.Dialect determineDialect(java.lang.String databaseName,
                                             int databaseMajorVersion)

Determine the appropriate Dialect to use given the database product name and major version.

Parameters:

databaseName - The name of the database product (obtained from metadata).

databaseMajorVersion - The major version of the database product (obtained from metadata).

Returns:

An appropriate dialect instance.

buildDialect

public static org.hibernate.dialect.Dialect buildDialect(java.lang.String dialectName)

Returns a dialect instance given the name of the class to use.

Parameters:

dialectName - The name of the dialect class.

Returns:

The dialect instance.