org.mmbase.storage.implementation.database
Class DatabaseStorageManagerFactory

java.lang.Object
  org.mmbase.storage.StorageManagerFactory
      org.mmbase.storage.implementation.database.DatabaseStorageManagerFactory

public class DatabaseStorageManagerFactory

extends StorageManagerFactory

A storage manager factory for database storages. This factory sets up a datasource for connecting to the database. If you specify the datasource URI in the 'datasource' property in mmbaseroot.xml configuration file, the factory attempts to obtain the datasource from the application server. If this fails, or no datasource URI is given, it attempts to use the connectivity offered by the JDBC Module, which is then wrapped in a datasource. Note that if you provide a datasource you should make the JDBC Module inactive to prevent the module from interfering with the storage layer.

Since:

MMBase-1.7

Version:

$Id: DatabaseStorageManagerFactory.java,v 1.37 2006/07/15 14:35:06 michiel Exp $

Author:

Pierre van Rooden

To Do:

backward compatibility with the old supportclasses should be done by creating a separate Factory (LegacyStorageManagerFactory ?).

Field Summary

protected String	catalog The catalog used by this storage.
protected DataSource	dataSource The datasource in use by this factory.
protected boolean	supportsTransactions Whether transactions and rollback are supported by this database
protected int	transactionIsolation The transaction isolation level available for this storage.

Fields inherited from class org.mmbase.storage.StorageManagerFactory

attributes, changeManager, disallowedFields, getSurrogator, mmbase, queryHandler, queryHandlerClasses, setSurrogator, storageManagerClass, typeMappings

Constructor Summary

DatabaseStorageManagerFactory()

Method Summary

static boolean	checkBinaryFileBasePath(String basePath) Tries to ensure that basePath existis and is writable.
protected DataSource	createDataSource(String binaryFileBasePath)
String	getBinaryFileBasePath() As getBinaryFileBasePath(boolean) with true
String	getBinaryFileBasePath(boolean check) Returns the base path for 'binary file'
String	getCatalog() Returns the name of the catalog used by this storage (null if no catalog is used).
String	getDatabaseName() Doing some best effort to get a 'database name'.
DataSource	getDataSource() Returns the DataSource associated with this factory.
StorageReader	getDocumentReader() Locates and opens the storage configuration document, if available. The configuration document to open can be set in mmbasereoot (using the storage property). The property should point to a resource which is to be present in the MMBase classpath. Overriding factories may provide ways to auto-detect the location of a configuration file. MMBase determine it using information gained from the datasource, and the lookup.xml file in the database configuration directory Storage configuration files should become resource files, and configurable using a storageresource property.
double	getVersion() Returns the version of this factory implementation.
protected Object	instantiateBasicHandler(Class handlerClass) Instantiate a basic handler object using the specified class.
protected Object	instantiateChainedHandler(Class handlerClass, Object handler) Instantiate a chained handler object using the specified class.
protected SearchQueryHandler	instantiateQueryHandler(Object data) Instantiate a SearchQueryHandler object using the specified object.
protected void	load() Opens and reads the storage configuration document.
static void	main(String[] args)
boolean	supportsTransactions() Returns whether transactions, and specifically rollback, is supported in the storage layer.

Methods inherited from class org.mmbase.storage.StorageManagerFactory

getAttribute, getAttributes, getChangeManager, getDisallowedFields, getGetSurrogator, getMMBase, getScheme, getScheme, getSearchQueryHandler, getSetSurrogator, getStorageIdentifier, getStorageIdentifier, getStorageManager, getTimeZoneOffset, getTypeMappings, hasOption, init, newInstance, newInstance, setAttribute, setAttributes, setDisallowedFields, setOption, setScheme

Methods inherited from class java.lang.Object

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

Field Detail

catalog

protected String catalog

The catalog used by this storage.

dataSource

protected DataSource dataSource

The datasource in use by this factory. The datasource is retrieved either from the application server, or by wrapping the JDBC Module in a generic datasource.

transactionIsolation

protected int transactionIsolation

The transaction isolation level available for this storage. Default TRANSACTION_NONE (no transaction support). The actual value is determined from the database metadata.

supportsTransactions

protected boolean supportsTransactions

Whether transactions and rollback are supported by this database

Constructor Detail

DatabaseStorageManagerFactory

public DatabaseStorageManagerFactory()

Method Detail

getVersion

public double getVersion()

Description copied from class: StorageManagerFactory

Returns the version of this factory implementation. The factory uses this number to verify whether it can handle storage configuration files that list version requirements.

Specified by:

getVersion in class StorageManagerFactory

Returns:

the version as an integer

supportsTransactions

public boolean supportsTransactions()

Description copied from class: StorageManagerFactory

Returns whether transactions, and specifically rollback, is supported in the storage layer.

Specified by:

supportsTransactions in class StorageManagerFactory

Returns:

true if trasnactions are supported

getCatalog

public String getCatalog()

Description copied from class: StorageManagerFactory

Returns the name of the catalog used by this storage (null if no catalog is used).

Overrides:

getCatalog in class StorageManagerFactory

getDatabaseName

public String getDatabaseName()

Doing some best effort to get a 'database name'.

Since:

MMBase-1.8

getDataSource

public DataSource getDataSource()

Returns the DataSource associated with this factory.

Since:

MMBase-1.8

createDataSource

protected DataSource createDataSource(String binaryFileBasePath)

Since:

MMBase-1.8

load

protected void load()
             throws StorageException

Opens and reads the storage configuration document. Obtain a datasource to the storage, and load configuration attributes.

Overrides:

load in class StorageManagerFactory

Throws:

StorageException - if the storage could not be accessed or necessary configuration data is missing or invalid

getDocumentReader

public StorageReader getDocumentReader()
                                throws StorageException

Locates and opens the storage configuration document, if available. The configuration document to open can be set in mmbasereoot (using the storage property). The property should point to a resource which is to be present in the MMBase classpath. Overriding factories may provide ways to auto-detect the location of a configuration file. MMBase determine it using information gained from the datasource, and the lookup.xml file in the database configuration directory Storage configuration files should become resource files, and configurable using a storageresource property. The type of reader to return should be a StorageReader.

Overrides:

getDocumentReader in class StorageManagerFactory

Returns:

a StorageReader instance

Throws:

StorageException - if the storage could not be accessed while determining the database type

getBinaryFileBasePath

public String getBinaryFileBasePath()

As getBinaryFileBasePath(boolean) with true

getBinaryFileBasePath

public String getBinaryFileBasePath(boolean check)

Returns the base path for 'binary file'

Since:

MMBase-1.8.1

checkBinaryFileBasePath

public static boolean checkBinaryFileBasePath(String basePath)

Tries to ensure that basePath existis and is writable. Logs error and returns false otherwise.

Parameters:

basePath - a Directory name

Since:

MMBase-1.8.1

instantiateBasicHandler

protected Object instantiateBasicHandler(Class handlerClass)

Description copied from class: StorageManagerFactory

Instantiate a basic handler object using the specified class. A basic handler can be any type of class and is dependent on the factory implementation. For instance, the database factory expects an org.mmbase.storage.search.implentation.database.SQLHandler class.

Specified by:

instantiateBasicHandler in class StorageManagerFactory

Parameters:

handlerClass - the class to instantuate teh object with

Returns:

the new handler class

instantiateChainedHandler

protected Object instantiateChainedHandler(Class handlerClass,
                                           Object handler)

Description copied from class: StorageManagerFactory

Instantiate a chained handler object using the specified class. A chained handler can be any type of class and is dependent on the factory implementation. For instance, the database factory expects an org.mmbase.storage.search.implentation.database.ChainedSQLHandler class.

Specified by:

instantiateChainedHandler in class StorageManagerFactory

Parameters:

handlerClass - the class to instantuate teh object with

handler - a handler thatw a sinstantiated previously. this handler should be passed to the new handler class during or after constrcution, so the ne whandler can 'chain' any events it cannot handle to this class.

Returns:

the new handler class

instantiateQueryHandler

protected SearchQueryHandler instantiateQueryHandler(Object data)

Description copied from class: StorageManagerFactory

Instantiate a SearchQueryHandler object using the specified object. The specified parameter may be an actual SearchQueryHandler object, or it may be a utility class. For instance, the database factory expects an org.mmbase.storage.search.implentation.database.SQLHandler object, which is used as a parameter in the construction of the actual SearchQueryHandler class.

Specified by:

instantiateQueryHandler in class StorageManagerFactory

Parameters:

data - the object to instantuate a SearchQueryHandler object with

main

public static void main(String[] args)