Guide to GSX

Extreme! Labs , Indiana University

This is a simple guide to writing OGSI compatible grid services and clients using GSX v1.0. GSX is part of the Service Frameworks (SFWorX) initiative of the Grid and Web Services (XGWS) work done at the Extreme! Lab.

XSUL is the Extreme Lab's Web Services Utility Library. GSX, or Grid Service eXtensions, uses XSUL to to provide base OGSI Grid services. Currently, GSX v1.0 provides implemntations of the GridService, HandleResolver and ServiceGroupRegistry porttypes. The user can implement additional web services porttypes to the base grid service porttypes. The basic grid service implementation provides service data management, lifetime management and means to register service metadata and resolve handles. Users can build upon them by defining their own porttypes and use the capabilities provided by the grid service porttype.

GSX uses Xml Beans, which give a Java Object view of the OGSI schema elements. Developers can also generate Xml Bean Objects from their own schema, to use as service data elements or methods parameters and results. For a brief introduction to Xml Beans, look at the Introduction to Xml Beans documentation. For details on this, look at the Generating Xml Bean Objects documentation or use the example given in GUIDE_IMPL/xsd as a template.

Make sure to read the NOTE before proceeding with the guide

• Proceed to the Guide for Writing Services >>>
  

• Proceed to the Guide for Writing Service Clients >>>
  

NOTE:

• Throughout the guide, the following variables will be used to represent these directories:

  GSX_HOME

  The base GSX directory (./../..)
  

  GSX_API

  The directory in which the GSX API package is present(GSX_HOME/src/java/api)
  

  GSX_IMPL

  The directory in which the GSX Implementation package is present(GSX_HOME/src/java/impl)
  

  GSX_API_SRC

  The base directory for source files in the API (GSX_API/edu/indiana/extreme/gsx/)
  

  GSX_IMPL_SRC

  The base directory for source files in the implementation (GSX_IMPL/edu/indiana/extreme/gsx/)
  

  GUIDE_IMPL

  The directory in which the guide samples are present (GSX_HOME/samples/guide_impl)
  

  GUIDE_SRC

  The directory in which the guide source files are present (GUIDE_IMPL/edu/indiana/extreme/ gsx/samples/guide)

• The package names and the directories in which the source files are present are as follows:

  edu.indiana.extreme.gsx

  GSX_API_SRC

  edu.indiana.extreme.gsx.port_type

  GSX_API_SRC/port_type

  edu.indiana.extreme.gsx.base_types

  GSX_API/ogsi_xbeans_src_files.jar

  edu.indiana.extreme.gsx.extended_types

  GSX_API/ogsi_xbeans_src_files.jar

  edu.indiana.extreme.gsx.service.grid_service

  GSX_IMPL_SRC/service/grid_service

  edu.indiana.extreme.gsx.service.handle_resolver

  GSX_IMPL_SRC/service/handle_resolver

  edu.indiana.extreme.gsx.service.service_group

  GSX_IMPL_SRC/service/service_group

  edu.indiana.extreme.gsx.sde

  GSX_API_SRC/sde and GSX_IMPL_SRC/sde

  edu.indiana.extreme.gsx.util

  GSX_IMPL_SRC/util

Make sure to read the NOTE before proceeding with the guide

• Proceed to the Guide for Writing Services >>>

• Proceed to the Guide for Writing Service Clients >>>