A domain connection is required to obtain a reference to any object stores within that domain. A
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
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
object, is the most frequent cause of an exception related to a connection failure. For example, if the URI carried by the
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
object by calling one of the static
methods on the
Once you have obtained a
object, you can call its methods to retrieve information about the connection. All engine objects maintain a reference to the
instance, which you can retrieve by calling the engine object's
method. The
object is also used as an input to factory methods that create other objects. Examples are
and
.
The following tables list the members exposed by IConnection.
Public Methods
Name | Description | |
---|---|---|
![]() | GetParameter | Retrieves the specified configuration parameter. |
![]() | GetURI | Returns 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. |
![]() | SetParameter | Sets a configuration parameter. If the value of the value argument is |
![]() | SetParameters | Sets the configuration parameters specified in the argument. Other configuration parameters are unchanged. This is equivalent to calling |