All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.modeshape.jcr.JcrRepositoryFactory Maven / Gradle / Ivy

There is a newer version: 5.4.1.Final
Show newest version
/*
 * ModeShape (http://www.modeshape.org)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.modeshape.jcr;

import java.net.URL;
import java.util.Collections;
import java.util.Map;
import java.util.ServiceLoader;
import java.util.Set;
import java.util.concurrent.Future;
import java.util.concurrent.TimeUnit;
import javax.jcr.Repository;
import javax.jcr.RepositoryException;
import org.modeshape.common.annotation.ThreadSafe;
import org.modeshape.common.logging.Logger;
import org.modeshape.jcr.api.RepositoryFactory;

/**
 * Service provider for the JCR2 {@code RepositoryFactory} interface. This class provides a single public method,
 * {@link #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 {@link 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 {@link org.modeshape.jcr.ModeShapeEngine 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 {@link URL#openConnection() 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 #getRepository(Map) * @see RepositoryFactory#getRepository(Map) */ @ThreadSafe public class JcrRepositoryFactory implements RepositoryFactory { private static final Logger LOG = Logger.getLogger(JcrRepositoryFactory.class); /** * The container which hold the engine and which is responsible for initializing & returning the repository. */ private static final JcrRepositoriesContainer CONTAINER = new JcrRepositoriesContainer(); /** * Returns a reference to the appropriate repository for the given parameter map, if one exists. Although the * {@code 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 {@code PROTOCOL://PATH[?repositoryName=REPOSITORY_NAME]} where * PROTOCOL is "jndi" or "file", PATH is the JNDI name of the {@link 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 * {@link ModeShapeEngine} or configuration file. *

* * @param parameters a map of parameters to use to look up the repository; may be null * @return the repository specified by the value of the entry with key {@link #URL}, or null if any of the following are true: *
    *
  • the parameters map is empty; or,
  • *
  • there is no parameter with the {@link #URL}; or,
  • *
  • the value for the {@link #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 {@link ModeShapeEngine} (in the JNDI tree) or a * configuration file (in the classpath or file system); or,
  • *
  • or there is an error starting up the {@link ModeShapeEngine} with the given configuration information.
  • *
      * @see RepositoryFactory#getRepository(Map) */ @Override @SuppressWarnings( "rawtypes" ) public Repository getRepository( Map parameters ) throws RepositoryException { LOG.debug("Trying to load ModeShape JCR Repository with parameters: " + parameters); return CONTAINER.getRepository(null, parameters); } @Override @Deprecated public Future shutdown() { return CONTAINER.shutdown(); } @Override @Deprecated public boolean shutdown( long timeout, TimeUnit unit ) throws InterruptedException { return CONTAINER.shutdown(timeout, unit); } @Override @Deprecated public Repository getRepository( String repositoryName ) throws RepositoryException { return CONTAINER.getRepository(repositoryName, null); } @Override @Deprecated public Set getRepositoryNames() { try { return CONTAINER.getRepositoryNames(null); } catch (RepositoryException e) { LOG.debug(e, "Cannot retrieve the names of all the repositories"); return Collections.emptySet(); } } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy