Difference between revisions of "NAL"

Revision as of 19:13, 20 March 2007

Introduction

The Node Access Library (NAL) is a Java Library that provides different functionalities to access the local node information. It allows to obtain the DHN unique ID, the Running Instance unique ID, the list of service running in the node, the running instance profile of the caller, and the node free disk space. Moreover, the NAL, gives access to the VO Maps and allows services to set/get both the Specific Data section and the State section in their Running Instance profile.

Implentation Overview

Each WSRF service should instantiate a NAL object in order to have access to node information (see Usage Example for details).

• Library functionalities description:
  1. List VO Maps
     • Return a list with the name of the DHN VOs

       signature

       public Vector getVOMapsList ( ) throws Exception

       parameters

       n.a.

       return

       The list of the DHN VOs

  2. get VO Map
     • Return a VO Map

       signature

       public String getVOMap (String voname) throws Exception

       parameters

       The VO name

       return

       The VO Map if exists, exception otherwise.

  3. Get the Running Instance ID
     • Returns the RI unique ID of a given service name and service class

       signature

       public String getRIID ( String serviceName, String serviceClass ) throws Exception

       parameters

       A valid local RI service name

       A valid local RI service class

       return

       The RI ID if valid {class, name} parameters were used, exception otherwise.

/** * Returns the RI unique ID of a given service name and service class. * * @param serviceName a String with a valid local RI service name. * @param serviceClass a String with a valid local RI service class. * * @return if the required RI service profile exists return its unique ID * else return null. * */ public String getRIID ( String serviceName, String serviceClass ) throws Exception {

• 1. • signature

       parameters

       return

  2. • signature

       parameters

       return

  3. • signature

       parameters

       return

  4. • signature

       parameters

       return

  5. • signature

       parameters

       return

  6. • signature

       parameters

       return

  7. • signature

       parameters

       return

  8. • signature

       parameters

       return

  9. • signature

       parameters

       return

  10. • signature

        parameters

        return

  11. • signature

        parameters

        return

Dependencies

Usage Example