Connecting to a Server

Connection holds a reference to a server which you can obtain using the getServer() method. The Connect method is responsible for connecting to a Server. All necessary parameters needed to obtain connection can usually be taken from the server configuration, which is initialized when the server is created. The available configuration parameters are defined in the serverTypes extension point. The values for these parameters are provided by the user when creating an instance of the Server using the New Server Wizard.

When the connection with the server is established and valid, the isConnected() method should return true; otherwise it returns false.

When the connection is no longer needed, you can close the connection by invoking the disconnect() method.

Defining a Runtime (Optional)

A Runtime is configuration data that is shared amongst many server types. For example, if you use a client-side management system such as a JMX console to manage many servers, this server type could use common configuration details. This is implemented using the extension point com.tibco.xpd.deploy.core.runtimeTypes and by providing values for the necessary runtime parameters.

If a server type has an associated runtime, it should be reflected in the serverTypes extension by providing the associated RuntimeType sub element with the identifier of the runtime type extension.