org.compass.core.config
Class CompassConfiguration

java.lang.Object
  org.compass.core.config.CompassConfiguration

Direct Known Subclasses:

CompassAnnotationsConfiguration

public class CompassConfiguration
extends Object

Used to configure Compass instances.

An instance of it allows the application to specify settings and mapping files to be used when creating Compass.

There are several options to configure a Compass instance, programmatically using the CompassConfiguration class, using the xml configuration file (compass.cfg.xml), or a combination of both.

Usually the application will create a single CompassConfiguration, use it to configure and than build a Compass instance, and than instantiate CompassSessions in threads servicing client requests.

The CompassConfiguration is meant only as an initialization-time object. Compass is immutable and do not affect the CompassConfiguration that created it.

Author:

kimchy

See Also:

Compass

Field Summary

protected ConfigurationBuilder	configurationBuilder
protected static org.apache.commons.logging.Log	log
protected CompassMappingBinding	mappingBinding

Constructor Summary

CompassConfiguration()

Method Summary

CompassConfiguration	addClass(Class searchableClass) Read a mapping from an application resource, using a convention.
CompassConfiguration	addDirectory(File dir) Read all mapping and meta-data documents from a directory tree.
CompassConfiguration	addFile(File file) Read mappings from a particular file.
CompassConfiguration	addFile(String filePath) Read mappings from a particular file.
CompassConfiguration	addInputStream(InputStream inputStream, String resourceName) Read mappings from an InputStream.
CompassConfiguration	addJar(File jar) Read all mappings and meta-data from a jar file.
protected void	addMappingBindings(CompassMappingBinding mappingBinding)
CompassConfiguration	addMappingResover(InputStreamMappingResolver mappingResolver) Uses a class that implements the InputStreamMappingResolver for auto generation of mapping definitions.
CompassConfiguration	addPackage(String packageName) Read annotated package definitions.
CompassConfiguration	addResource(String path) Read mappings from an application resource trying different classloaders.
CompassConfiguration	addResource(String path, ClassLoader classLoader) Read mappings from an application resource
CompassConfiguration	addResourceMapping(ResourceMapping resourceMapping) Advance: Add mappings based on ResourceMapping implementation which allows for adding pre built mapping constructs.
CompassConfiguration	addURL(URL url) Read mappings from a URL.
Compass	buildCompass() Build compass with the configurations set.
CompassConfiguration	configure() Use the mappings and properties specified in an application resource with the path /compass.cfg.xml.
CompassConfiguration	configure(File configFile) Use the mappings and properties specified in the given application file.
CompassConfiguration	configure(String resource) Use the mappings and properties specified in the given application resource.
CompassConfiguration	configure(URL url) Use the mappings and properties specified in the given document.
CompassSettings	getSettings() Returns the current set of settings associated with the configuration.
CompassConfiguration	registerConverter(String converterName, Converter converter) Registers a Converter under the given name.
protected void	registerExtraConverters(ConverterLookup converterLookup)
CompassConfiguration	setConnection(String connection) Sets the connection for the compass instance.
CompassConfiguration	setSetting(String setting, String value) Sets a specific setting in the compass configuration settings.
boolean	tryAddClass(Class searchableClass)

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static final org.apache.commons.logging.Log log

mappingBinding

protected CompassMappingBinding mappingBinding

configurationBuilder

protected ConfigurationBuilder configurationBuilder

Constructor Detail

CompassConfiguration

public CompassConfiguration()

Method Detail

addMappingBindings

protected void addMappingBindings(CompassMappingBinding mappingBinding)

getSettings

public CompassSettings getSettings()

Returns the current set of settings associated with the configuration.

Returns:

The settings used by the configuration

setSetting

public CompassConfiguration setSetting(String setting,
                                       String value)

Sets a specific setting in the compass configuration settings.

Parameters:

setting - The setting name

value - The setting value

Returns:

CompassConfiguration for method chaining

setConnection

public CompassConfiguration setConnection(String connection)

Sets the connection for the compass instance.

Parameters:

connection - The connection for compass to use

Returns:

CompassConfiguration for method chaining

registerConverter

public CompassConfiguration registerConverter(String converterName,
                                              Converter converter)

Registers a Converter under the given name. The name can then be used in the mapping definitions as a logical name to the converter.

Parameters:

converterName - the converter name the converter will be registered under

converter - The converter to use

Returns:

The configuration

buildCompass

public Compass buildCompass()
                     throws CompassException

Build compass with the configurations set. Creates a copy of all the current settings and mappings, configures a Compass instance and starts it.

Note that the CompassConfiguration class can be used to create more Compass objects after the method has been called.

Returns:

the Compass

Throws:

CompassException

registerExtraConverters

protected void registerExtraConverters(ConverterLookup converterLookup)

configure

public CompassConfiguration configure()
                               throws ConfigurationException

Use the mappings and properties specified in an application resource with the path /compass.cfg.xml.

Returns:

CompassConfiguration for method chaining

Throws:

ConfigurationException

configure

public CompassConfiguration configure(String resource)
                               throws ConfigurationException

Use the mappings and properties specified in the given application resource.

Parameters:

resource - The compass configuration resource path

Returns:

CompassConfiguration for method chaining

Throws:

ConfigurationException

configure

public CompassConfiguration configure(URL url)
                               throws ConfigurationException

Use the mappings and properties specified in the given document.

Parameters:

url - URL from which you wish to load the configuration

Returns:

A configuration configured via the file

Throws:

ConfigurationException

configure

public CompassConfiguration configure(File configFile)
                               throws ConfigurationException

Use the mappings and properties specified in the given application file.

Parameters:

configFile - File from which you wish to load the configuration

Returns:

A configuration configured via the file

Throws:

ConfigurationException

addResourceMapping

public CompassConfiguration addResourceMapping(ResourceMapping resourceMapping)

Advance: Add mappings based on ResourceMapping implementation which allows for adding pre built mapping constructs.

addMappingResover

public CompassConfiguration addMappingResover(InputStreamMappingResolver mappingResolver)
                                       throws ConfigurationException

Uses a class that implements the InputStreamMappingResolver for auto generation of mapping definitions.

Parameters:

mappingResolver -

Throws:

ConfigurationException

addResource

public CompassConfiguration addResource(String path,
                                        ClassLoader classLoader)
                                 throws ConfigurationException

Read mappings from an application resource

Parameters:

path - a resource

classLoader - a ClassLoader to use

Throws:

ConfigurationException

addResource

public CompassConfiguration addResource(String path)
                                 throws ConfigurationException

Read mappings from an application resource trying different classloaders. This method will try to load the resource first from the thread context classloader and then from the classloader that loaded Compass.

Parameters:

path - The path of the resource

Throws:

ConfigurationException

addFile

public CompassConfiguration addFile(String filePath)
                             throws ConfigurationException

Read mappings from a particular file.

Parameters:

filePath - a path to a file

Throws:

ConfigurationException

addFile

public CompassConfiguration addFile(File file)
                             throws ConfigurationException

Read mappings from a particular file.

Parameters:

file - a path to a file

Throws:

ConfigurationException

addPackage

public CompassConfiguration addPackage(String packageName)
                                throws ConfigurationException

Read annotated package definitions.

Parameters:

packageName - The package name to load

Throws:

ConfigurationException

addClass

public CompassConfiguration addClass(Class searchableClass)
                              throws ConfigurationException

Read a mapping from an application resource, using a convention. The class foo.bar.Foo is mapped by the file foo/bar/Foo.cpm.xml (in the case of Xml binding).

Parameters:

searchableClass - the mapped class

Throws:

ConfigurationException

tryAddClass

public boolean tryAddClass(Class searchableClass)
                    throws ConfigurationException

Throws:

ConfigurationException

addDirectory

public CompassConfiguration addDirectory(File dir)
                                  throws ConfigurationException

Read all mapping and meta-data documents from a directory tree. Assume that any file named *.cpm.xml or *.cmd.xml is a mapping document.

Parameters:

dir - a directory

Throws:

ConfigurationException

addJar

public CompassConfiguration addJar(File jar)
                            throws ConfigurationException

Read all mappings and meta-data from a jar file. Assume that any file named *.cpm.xml or *.cmd.xml is a mapping document.

Parameters:

jar - a jar file

Throws:

ConfigurationException

addURL

public CompassConfiguration addURL(URL url)
                            throws ConfigurationException

Read mappings from a URL.

Parameters:

url - the URL

Throws:

ConfigurationException

addInputStream

public CompassConfiguration addInputStream(InputStream inputStream,
                                           String resourceName)
                                    throws ConfigurationException

Read mappings from an InputStream.

Parameters:

inputStream - an InputStream containing

Throws:

ConfigurationException