Starting Services

Summary of steps
Start a service using the Java API

You can programmatically start a service that is located in the service container by using the Java API. After you start a service, you can invoke it by using supported invocation methods. For example, you can invoke a running service by using the Java API. (See Invoking LiveCycle using the Java API.)

If a service contains configuration values, you can programmatically modify these values. (See Modifying Service Configuration Values.)

Note: You cannot start services by using web services.

Summary of steps

To start a service, perform the following tasks:

Include project files.
Create a ServiceRegistry Client API object.
Reference a service.
Start the service

Include project files

Include necessary files into your development project. If you are creating a client application by using Java, include the necessary JAR files. If you are using web services, make sure that you include the proxy files.

Create a ServiceRegistry Client API object

Before you can programmatically perform a service registry operation, you must create a ServiceRegistryClient object.

Start the service

To programmatically deploy a component, reference the component JAR file. When you reference the JAR file, create a com.adobe.idp.Document object that stores the JAR file.

Start a service using the Java API

Start a service by using the Java API:

Include project files

Include client JAR files, such as adobe-livecycle-client.jar, in your Java project’s class path.
Create a ServiceRegistry Client API object
- Create a ServiceClientFactory object that contains connection properties.
- Create a ServiceRegistryClient object by using its constructor and passing a ServiceClientFactory object that contains connection properties.
Start the service
- Retrieve the service to start by invoking the ServiceRegistryClient object’s getHeadActiveConfiguration method and passing a string value that specifies the name of the service. If multiple service versions exist, the latest version (referred to as the head version) is returned.This method returns a ServiceConfiguration object that represents the service.
- Start the service by invoking the ServiceRegistryClient object’s start method and passing the ServiceConfiguration object that was returned by the getHeadActiveConfiguration method.