Starting Services

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:

  1. Include project files.

  2. Create a ServiceRegistry Client API object.

  3. Reference a service.

  4. 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:

  1. Include project files

    Include client JAR files, such as adobe-livecycle-client.jar, in your Java project’s class path.

  2. 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.

  3. 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.

// Ethnio survey code removed