Creating a Java Service

Cloud Application Integration (On-Premises) : Service Development : Building Java Services : Creating a Java Service

Notes about Creating and Editing Java Services in Designer

Use the Designer Java service editor to create a new Java service. Before you can create a Java service, make sure the following items are true:

Designer is using the Service Development perspective. If not, switch to it by selecting Window > Open Perspective > Service Development.

The Integration Server on which you want the Java service to reside is running and that it is connected to Designer.

The IS package and folder in which you want to create the Java service already exists. For more information, see Package and Folder Requirements.

All Java services in the folder in which you want to create the new service are unlocked. Alternatively, you can ensure that you have all the Java services locked. For more information, see Guidelines for Locking Java and C/C++ Services.

If you want to use Unicode characters in the Java service, change the Text file encoding preference. To do so, select Window > Preferences > General > Workspace and for Text file encoding clear Default (Cp1252), select Other, and then select or type a new encoding.

To create a Java service

1. In Designer: File > New > Java Service.

2. In the Create New Java Service wizard, expand the IS package in which you want the service to reside and select the folder in which you want to create the service.

3. In the Element name field, type the name you want to assign to the Java service.

4. If you have a template you want to use to initialize a default set of properties for the service, select if from the Choose template list.

5. Click Finish.

6. Specify the input parameters and output parameters for the Java service on the Input/Output tab. For more information, see About the Service Signature.

7. Optionally, specify usage notes or comments in the Comments tab.

8. Specify service properties using the Properties view. For more information, see:

About Service Run-Time Parameters

About Automatic Service Retry

About Service Auditing

About Universal Names for Services or Document Types

About Service Output Templates.

9. Optionally, generate starter code for the service based on the declared input and output parameters. For more information, see Generating Java Code from Service Input and Output Parameters.

10. Add and modify the Java code on the Source tab.

You can use the webMethods Integration Server Java API in your service. For more information, see webMethods Integration Server Java API Reference.

11. Select File > Save.

Designer compiles the Java service on Integration Server and displays compilation error messages from the server in a popup window. Designer also writes the error messages to the Designer log file making them visible within the Error Log View.

Designer also compiles the Java service locally in the Service Development Project. Additionally, if the workspace preference Build Automatically is selected, Designer rebuilds other classes in the Service Development Project at the same time. Designer adds compilation errors from the local compilation to the Problems view. If Problems view is not already open, you can open it by selecting Window > Show View > Problems. To view the line of code that caused the error, double click on the error in the Problems view and Designer shifts focus to the Java service editor, with the cursor positioned at the line of code that caused the error.

Note:

For more information, see Compiling a Java Service.