com.filenet.rm.api

Class RMDriverManager

  1. java.lang.Object
  2. extended bycom.filenet.rm.api.RMDriverManager

  1. public class RMDriverManager
  2. extends java.lang.Object
Registers and retrieves connector and auto-naming implementations for a Records Manager application.

You can instantiate an RMDriverManager object by calling the default constructor.

You can register an RMConnector implementation for a custom application by calling the registerConnector method on an RMDriverManager object. This method generates and returns a unique registration ID for the specified connector implementation. The RMConnector implementation is then bound to the unique registration ID. For example, the RMDriverManager class instantiates respective implementations of Content Engine, Content Services, or Image Service according to the corresponding registration ID.


Constructor Summary

Constructor and Description
RMDriverManager()
Creates a new RMDriverManager object.

Method Summary

Modifier and Type Method and Description
  1. RMAutoName
getAutoName()
Returns the auto-namining implementation that is registered for this object.
  1. RMConnector
getConnector(RMObjectStore aoRMObjectStore,java.lang.String asRegistration_id)
Returns the connector implementation that is to be invoked for a specified ConnectorRegistration object.
  1. RMConnector
getConnector(RMObjectStore aoRMObjectStore,java.lang.String asRegistration_id,com.filenet.wcm.api.Session aoSession)
Returns the connector implementation that is to be invoked for a specified ConnectorRegistration object.
  1. boolean
isAlreadyRegistered(RMObjectStore aoObjectStore,java.lang.String asRepositoryType)
Indicates whether a connector implementation is registered in the specified object store.
  1. void
registerAutoName(RMAutoName aoAutoNameImpl)
Registers the specified auto-naming implementation for use by a custom application.
  1. java.lang.String
registerConnector(RMObjectStore aoObjectStore,java.lang.String asRepositoryType,java.lang.String asServerName,java.lang.String asRepositoryName,java.lang.String asImplementationclass)
Registers the connector implementation that is to be invoked for the specified combination of repository type, server name and repository name.
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RMDriverManager

  1. public RMDriverManager()
Creates a new RMDriverManager object.

Method Detail

registerConnector

  1. public java.lang.String registerConnector( RMObjectStore aoObjectStore,
  2. java.lang.String asRepositoryType,
  3. java.lang.String asServerName,
  4. java.lang.String asRepositoryName,
  5. java.lang.String asImplementationclass)
  6. throws RMException
Registers the connector implementation that is to be invoked for the specified combination of repository type, server name and repository name.

The registerConnector method creates a ConnectorRegistration object that is used to store registration-related in Content Engine. The method returns the a String containing the GUID for this object, which represents the registration ID.

If the specified combination of repository type, server name and repository name is already registered, this method throws an exception. If the specified combination is not registered, In case there exists no registration for the combination of repository type, the following two scenarios can happen:

1) If there exists an entry for the custom object with the given Repository type and with star (*) value for the server and repository name and a new custom object will be created.

2) If there exists no entry for the custom object with the given Repository type and with star (*) value for the server and repository name and two custom objects will be created.

The First object will have a star (*) entry for the server name and the repository name, and the other object will have all the values as specified in input parameters.

The return value will be the GUID of the custom object created. If an error occurs, an RMException is thrown.

Parameters:
asImplementationclass - The fully qualified name of implementation class that will be invoked. Note that the classes for implementation must be available in the classpath, such as,com.connector.api.Implementation. In additon, null or empty values are not allowed.
aoObjectStore - The RMObjectStore to which this registration applies. The null value is not allowed.
asRepositoryType - Specifies the type of repository, such as CE, CS or IS. Null or empty values are not allowed.
asServerName - The server name or the IP address of the repository server, such ashttp://fn-atlantic:8008/ApplicationEngine/xcmisasoap.dll. Star(*), null or empty values for the parameter will not be allowed.
asRepositoryName - Specifies the repository name including the domain name. In case of CE, it will be ObjectStore and domain name. In case of IS or CS, you must specify fully qualified name of the library (including domain name). Star(*), null, or empty values for the parameter will not be allowed.
Returns:
The unique registration ID as a String.
Throws:
RMException - In case of any error, an RMException will be thrown.

isAlreadyRegistered

  1. public boolean isAlreadyRegistered( RMObjectStore aoObjectStore,
  2. java.lang.String asRepositoryType)
Indicates whether a connector implementation is registered in the specified object store.
Parameters:
aoObjectStore - An RMObjectStore object that represents the object store to be checked for registration.
asRepositoryType - A String that represents the repository type such as CE for Content Engine or IS for Image Services.
Returns:
true if a ConnectorRegistration object exists in the specified object store; otherwise, returns false.

getConnector

  1. public RMConnector getConnector( RMObjectStore aoRMObjectStore,
  2. java.lang.String asRegistration_id)
  3. throws RMException
Returns the connector implementation that is to be invoked for a specified ConnectorRegistration object.
Parameters:
aoRMObjectStore - An RMObjectStore object specifying the object store in which the ConnectorRegistration object is located. This parameter cannot be null.
asRegistration_id - A String Containing the registration ID (GUID) of the ConnectorRegistration object. This String cannot be null or empty.
Returns:
An RMConnector object representing the connector implementation that is registered in the Records Manager application for the specified for a specified ConnectorRegistration object.
Throws:
RMException - If a Records Manager error occurs.

getConnector

  1. public RMConnector getConnector( RMObjectStore aoRMObjectStore,
  2. java.lang.String asRegistration_id,
  3. com.filenet.wcm.api.Session aoSession)
  4. throws RMException
Returns the connector implementation that is to be invoked for a specified ConnectorRegistration object.
Parameters:
aoRMObjectStore - An RMObjectStore object specifying the object store in which the ConnectorRegistration object is located. This parameter cannot be null.
asRegistration_id - A String Containing the registration ID (GUID) of the ConnectorRegistration object. This String cannot be null or empty.
aoSession - A Session object specifying the session to be set for the RMConnector object.
Returns:
An RMConnector object representing the connector implementation that is registered in the Records Manager application for the specified for a specified ConnectorRegistration object.
Throws:
RMException - If a Records Manager error occurs.

registerAutoName

  1. public void registerAutoName(RMAutoName aoAutoNameImpl)
Registers the specified auto-naming implementation for use by a custom application. This implementation enables an application to use the Records Manager auto-naming capabilities to define specific naming conventions for Records Manager entities.
Parameters:
aoAutoNameImpl - The RMAutoName object that contains the auto-naming implementation to be registered. If this parameter is null, no auto-naming implementation is registered and, as a result, subsequent calls to the getAutoName method cause an exception to be thrown.

getAutoName

  1. public RMAutoName getAutoName()
  2. throws RMException
Returns the auto-namining implementation that is registered for this object.
Returns:
The RMAutoName object that is registered for this object. the registerAutoName method.
Throws:
RMException - If no RMAutoName object is registered for this object or if a Record Manager error occurs.