RepositoryFactory is a factory class for Repository
+ * implementations.
+ *
+ * A concrete implementation of this class must have a zero-argument
+ * constructor. Repository factories may be installed in an instance of the Java
+ * platform as extensions, that is, jar files placed into any of the usual
+ * extension directories. Factories may also be made available by adding them to
+ * the applet or application class path or by some other platform-specific
+ * means. Repository factories are looked up via the current thread's context
+ * class loader.
+ *
+ * A repository factory should identify itself with a factory-configuration file
+ * named javax.jcr.RepositoryFactory in the resource directory
+ * META-INF/services. The file should contain a list of fully-qualified concrete
+ * repository-factory class names, one per line. A line is terminated by any one
+ * of a line feed ('\n'), a carriage return ('\r'), or a carriage return
+ * followed immediately by a line feed. Space and tab characters surrounding
+ * each name, as well as blank lines, are ignored. The comment character is '#'
+ * ('\u0023'); on each line all characters following the first comment character
+ * are ignored. The file must be encoded in UTF-8.
+ *
+ * If a particular concrete repository factory class is named in more than one
+ * configuration file, or is named in the same configuration file more than
+ * once, then the duplicates will be ignored. The configuration file naming a
+ * particular factory need not be in the same jar file or other distribution
+ * unit as the factory itself. The factory must be accessible from the same
+ * class loader that was initially queried to locate the configuration file;
+ * this is not necessarily the class loader that loaded the file.
+ *
+ *
+ * Parameters are passed to the connect and
+ * getRepository methods
+ * in a Map of key/value pairs. The keys are not
+ * specified by JCR and will be implementation specific. However,
+ * vendors should use keys that are namespace qualified in the
+ * Java package style to distinguish their key names. For example
+ * an address parameter might be com.vendor.address.
+ *
+ *
+ * Map parameters = new HashMap();
+ * parameters.put("com.vendor.address", "vendor://localhost:9999/repo");
+ * Repository repo = RepositoryFactory.getRepository(parameters);
+ *
+ *
+ * Get a default repository available in this environment:
+ *
+ *
+ * Repository repo = RepositoryFactory.getRepository();
+ *
+ *
+ * Manually instantiate a specific repository factory and connect to the
+ * repository:
+ *
+ *
+ * Map parameters = new HashMap();
+ * parameters.put("com.vendor.address", "vendor://localhost:9999/repo");
+ * RepositoryFactory factory = new com.vendor.RepositoryFactory();
+ * Repository repo = factory.connect(parameters);
+ *
+ *
+ *
+ * @since JCR 2.0
+ */
+public abstract class RepositoryFactory {
+
+ /**
+ * Attempts to establish a connection to a repository described by the given
+ * parameters.
+ *
+ *
+ * Parameters are passed in a Map of key/value pairs.
+ * The keys are not specified by JCR and will be implementation specific.
+ * However, vendors should use keys that are namespace qualified in the
+ * Java package style to distinguish their key names. For example
+ * an address parameter might be com.vendor.address.
+ *
+ * The implementation should return null if it does
+ * not understand the given parameters. The implementation may also return
+ * null if a default repository instance is requested
+ * (indicated by null parameters) and this factory
+ * is not able to identify a default repository.
+ * An implementation should throw an RepositoryException if it
+ * is the right factory but has trouble connecting to the repository.
+ *
+ * An implementation of this method must be thread-safe. + *
+ * + * @param parameters map of arbitrary string key/value pairs as repository + * arguments ornull if none are provided and
+ * a client wishes to connect to a default repository.
+ * @return a repository instance or null if this implementation
+ * does not understand the passed properties.
+ * @throws RepositoryException if an error occurs while connecting to the
+ * repository.
+ * @see RepositoryFactory#getRepository(java.util.Map)
+ */
+ public abstract Repository connect(Map parameters)
+ throws RepositoryException;
+
+ /**
+ * Attempts to establish a connection to a repository using the given
+ * parameters.
+ *
+ * Parameters are passed in a Map of key/value pairs.
+ * The keys are not specified by JCR and will be implementation specific.
+ * However, vendors should use keys that are namespace qualified in the
+ * Java package style to distinguish their key names. For example
+ * an address parameter might be com.vendor.address.
+ *
null if none are provided and
+ * a client wishes to connect to a default repository.
+ * @return a repository instance.
+ * @throws RepositoryException if getRepository fails or if no suitable
+ * repository is found.
+ */
+ public static Repository getRepository(Map parameters)
+ throws RepositoryException {
+ parameters = Collections.unmodifiableMap(parameters);
+ Iterator it = ServiceRegistry.lookupProviders(RepositoryFactory.class);
+ while (it.hasNext()) {
+ RepositoryFactory factory = (RepositoryFactory) it.next();
+ Repository repo = factory.connect(parameters);
+ if (repo != null) {
+ return repo;
+ }
+ }
+ throw new RepositoryException("No suitable Repository found");
+ }
+
+ /**
+ * Returns the first default Repository returned by a RepositoryFactory.
+ *
+ * @return a default repository instance.
+ * @throws RepositoryException if no factory returned a default repository
+ * or if an error occurs.
+ */
+ public static Repository getRepository() throws RepositoryException {
+ Iterator it = ServiceRegistry.lookupProviders(RepositoryFactory.class);
+ while (it.hasNext()) {
+ RepositoryFactory factory = (RepositoryFactory) it.next();
+ Repository repo = factory.connect(null);
+ if (repo != null) {
+ return repo;
+ }
+ }
+ throw new RepositoryException("No default Repository found");
+ }
+}
\ No newline at end of file
Property changes on: src\main\java\org\apache\jackrabbit\api\jsr283\RepositoryFactory.java
___________________________________________________________________
Added: svn:eol-style
+ native