Represents a logical connection to a FileNet P8 domain.

A domain connection is required to obtain a reference to any object stores within that domain. A Connection object contains information, such as configuration options, needed to execute an operation on the Content Engine server that runs in the FileNet P8 domain.

A Connection object contains enough information to establish communication with the Content Engine server. This information is carried in a URI and includes the transport protocol (connection type), host name, and port number that are used for server communication. An incorrect configuration, such as an incompatibility between the environment and the information in the Connection object, is the most frequent cause of an exception related to a connection failure. For example, if the URI carried by the Connection object specifies the EJB transport protocol, but an EJB .jar file is not in the classpath, the API throws an exception.

You can create a Connection object by calling one of the static GetConnection methods on the Factory.Connection class.

Once you have obtained a Connection object, you can call its methods to retrieve information about the connection. All engine objects maintain a reference to the Connection instance, which you can retrieve by calling the engine object's GetConnection method. The Connection object is also used as an input to factory methods that create other objects. Examples are Factory.Domain.GetInstance(Connection conn, String name) and Factory.EntireNetwork.GetInstance(Connection conn).


The following tables list the members exposed by IConnection.

Public Methods

 NameDescription
Public methodGetParameterRetrieves the specified configuration parameter.
Public methodGetURIReturns the Universal Resource Identity (URI) for this connection.

The URI carries the information required to establish a connection to the Content Engine server, such as the transport protocol, host, and port used for server communication.

Public methodSetParameterSets a configuration parameter.

If the value of the value argument is Null, this method removes the value. Defaults are used for removed values.

Public methodSetParametersSets the configuration parameters specified in the parameters argument.

Other configuration parameters are unchanged. This is equivalent to calling SetParameter(ConfigurationParameter parameter, Object value) for each parameter with a non-null value in its parameter argument.

Top

See Also