ISO Datatype: Introduce Tutorial 1.3

Author: Calixto Melean


	Contents ISO Datatype: Introduce Tutorial 1.3 Overview SVN Checkout Graphical Use Implementation Deploy the Service Verify

Overview

The purpose of this document is to illustrate how to create an analytical service using introduce and the ISO21090 data type extension. This tutorial covers how to install the extension using the software update tool, and how to use the extension to create a simple analytical service.

SVN Checkout

The completed service in this tutorial is available from SVN repository and can be checked out through anonymous access with the following command:

svn checkout https://gforge.nci.nih.gov/svnroot/grid-incubation/trunk/grid-incubation/incubator/projects/iso21090/projects/iso21090AnalyticalService

Graphical Use

Launch Introduce and click the Create Service Skeleton button. Enter service information and click the Create button.

From the Help menu, choose Introduce Software Update. Copy and paste the following into the "Update Site" field:

http://software.cagrid.org

. Then click the Look For Updates button to retrieve a list of updates from the update site.

Check the ISO21090 Datatypes and NCI localizations and click Next

Introduce proceeds to download and install the extension. Click Next and then Finish to restart Introduce.

Once Introduce re-launches, click Modify Service and open the service previously created.

The Import Data Types area under the Add/Remove Types tab now has a ISO21090 tab. Click on it

Click the Add button to add the ISO21090 data types to the service. These will now be listed on the left side column

Let us now add an operation to the service using one of the ISO21090 types. Click the Services tab. Click Operations, and then the Add Method button to the right.

We define a sendAd operation that takes an Ad object as input and returns an Ad object as output.

Type "sendAd" for Method Name
Type "Send ISO address to the service" for the Method Description
For the Inputs tab, double-click Ad from the left.

Click the Outputs tab. Double-click Ad from the left. Click the Done button

Click Save to save the service.

Implementation

Next we will implement the client and server side code.

In your service directory, open the following file in a text editor: C:/../ServiceName/src/org/cagrid/ServiceName/client/ServiceNameClient.java.

Copy and past the following imports in the beginning of the file:

import org.iso._21090.Ad;
import org.iso._21090.NullFlavor;
import org.iso._21090.ObjectFactory;

Find the Main method. After:

     // place client calls here if you want to use this main as a
     // test....

copy and paste the following:

     org.iso._21090.ObjectFactory factory = new ObjectFactory();
     Ad ad = factory.createAd();
     ad.setFlavorId("Testing flavor Id");
     ad.setNullFlavor(NullFlavor.DER);
     ad.setControlActExtension("123456789");
     Ad returnAd = client.sendAd(ad);

     System.out.println(returnAd.getFlavorId());
     System.out.println(returnAd.getNullFlavor());
     System.out.println(returnAd.getControlActExtension());

Save the file.
Now open the following file: C:/.../ServiceName/src/org/cagrid/ServiceName/service/ServiceNameImpl.java.

Copy and past the following imports in the beginning of the file:

import org.iso._21090.Ad;
import org.iso._21090.NullFlavor;
import org.iso._21090.ObjectFactory;

Replace

    //TODO: Implement this autogenerated method
    throw new RemoteException("Not yet implemented");

with this:

      System.out.println("server: " + ad.getFlavorId());
      System.out.println("server: " + ad.getNullFlavor());
      System.out.println("server: " + ad.getControlActExtension());
      return ad;

Save the file.

Deploy the Service

Next we deploy the service to a container. For complete details on deployment, please see the Grid Service Deployment Guide.

If you have closed Introduce, restart it from a command prompt:
```
%> cd %CAGRID_HOME%

%> ant introduce
```
Click Deploy Service and browse to your service directory.
Choose a container (Tomcat is recommended) and configure other settings if needed. Refer to the Grid Service Deployment Guide for complete details.

Click Deploy

Start the Tomcat container with a command prompt.
```
%> cd %CATALINA_HOME%\bin

%> startup.bat
```

Verify

Run the test client to verify that the service is working.

- In a command prompt:
```
%> cd <location of service>

%> ant runClient
```
- Alternatively, verify by opening a web browser and entering the service's URL: http://localhost:8080/wsrf/services/cagrid/ISO21090AnalyticalService. You should see the following:

ISO 21090