org.modeshape.jcr

Class JcrRepositoryFactory

java.lang.Object

org.modeshape.jcr.JcrRepositoryFactory

All Implemented Interfaces:

RepositoryFactory

@ThreadSafe
public class JcrRepositoryFactory
extends Object
implements RepositoryFactory

Service provider for the JCR2 RepositoryFactory interface. This class provides a single public method, getRepository(Map), that allows for a runtime link to a ModeShape JCR repository.

The canonical way to get a reference to this class is to use the ServiceLoader:

 String configUrl = ... ; // URL that points to your configuration file
 Map parameters = Collections.singletonMap(JcrRepositoryFactory.URL, configUrl);
 Repository repository;
 
 for (RepositoryFactory factory : ServiceLoader.load(RepositoryFactory.class)) {
     repository = factory.getRepository(parameters);
     if (repository != null) break;
 }
 

It is also possible to instantiate this class directly.

 RepositoryFactory repoFactory = new JcrRepositoryFactory();    
 String url = ... ; // URL that points to your configuration file
 Map params = Collections.singletonMap(JcrRepositoryFactory.URL, url);
 
 Repository repository = repoFactory.getRepository(params);]]>
 

Several URL formats are supported:

• JNDI location of repository - The URL contains the location in JNDI of an existing javax.jcr.Repository instance. For example, "jndi:jcr/local/my_repository" is a URL that identifies the JCR repository located in JNDI at the name "jcr/local/my_repository". Note that the use of such URLs requires that the repository already be registered in JNDI at that location.
• JNDI location of engine and repository name - The URL contains the location in JNDI of an existing ModeShape engine instance and the name of the javax.jcr.Repository repository as a URL query parameter. For example, "jndi:jcr/local?repositoryName=my_repository" identifies a ModeShape engine registered in JNDI at "jcr/local", and looks in that engine for a JCR repository named " my_repository".
• Location of a repository configuration - The URL contains a location that is resolvable to a configuration file for the repository. If the configuration file has not already been loaded by the factory, then the configuration file is read and used to deploy a new repository; subsequent uses of the same URL will return the previously deployed repository instance. Several URL schemes are supported, including classpath:, "file:", http: and any other URL scheme that can be resolved and opened. For example, " file://path/to/myRepoConfig.json" identifies the file on the file system at the absolute path " /path/to/myRepoConfig.json"; "classpath://path/to/myRepoConfig.json" identifies the file at " /path/to/myRepoConfig.json" on the classpath, and "http://www.example.com/path/to/myRepoConfig.json " identifies the file "myRepoConfig.json" at the given URL.

See Also:

getRepository(Map), RepositoryFactory.getRepository(Map)

Field Summary

Fields inherited from interface org.modeshape.jcr.api.RepositoryFactory

REPOSITORY_NAME, URL

Constructor Summary

Constructors

Constructor and Description
JcrRepositoryFactory()

Method Summary

Modifier and Type	Method and Description
Repository	getRepository(Map parameters) Returns a reference to the appropriate repository for the given parameter map, if one exists.
protected boolean	shutdown(long timeout, TimeUnit unit)

Methods inherited from class java.lang.Object

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

Constructor Detail

JcrRepositoryFactory

public JcrRepositoryFactory()

Method Detail

getRepository

public Repository getRepository(Map parameters)
                         throws RepositoryException

Returns a reference to the appropriate repository for the given parameter map, if one exists. Although the parameters map can have any number of entries, this method only considers the entry with the key JcrRepositoryFactory#URL.

The value of this key is treated as a URL with the format PROTOCOL://PATH[?repositoryName=REPOSITORY_NAME] where PROTOCOL is "jndi" or "file", PATH is the JNDI name of the ModeShapeEngine or the path to the configuration file, and REPOSITORY_NAME is the name of the repository to return if there is more than one JCR repository in the given ModeShapeEngine or configuration file.

Specified by:

getRepository in interface RepositoryFactory

Parameters:

parameters - a map of parameters to use to look up the repository; may be null

Returns:

the repository specified by the value of the entry with key RepositoryFactory.URL, or null if any of the following are true:

• the parameters map is empty; or,
• there is no parameter with the RepositoryFactory.URL; or,
• the value for the RepositoryFactory.URL key is null or cannot be parsed into a ModeShape JCR URL; or,
• the ModeShape JCR URL is parseable but does not point to a ModeShapeEngine (in the JNDI tree) or a configuration file (in the classpath or file system); or,
• or there is an error starting up the ModeShapeEngine with the given configuration information.

Throws:

RepositoryException

See Also:

RepositoryFactory.getRepository(Map)

shutdown

protected boolean shutdown(long timeout,
                           TimeUnit unit)
                    throws InterruptedException

Throws:

InterruptedException