ucar.netcdf
Interface NetcdfService

All Superinterfaces:
java.rmi.Remote
All Known Implementing Classes:
NetcdfServer

public interface NetcdfService
extends java.rmi.Remote

This service provides a way to 'open' remote Netcdf data sets by name. It is a placeholder for a more elaborate directory service, hopefully to be provided later on.


Field Summary
static java.lang.String SVC_NAME
          The string identifing this service in the rmi registry.
 
Method Summary
 java.lang.String[] list()
          List the names of exported data sets.
 NetcdfRemoteProxy lookup(java.lang.String dataSetName)
          Connect to (open) a remote Netcdf dataSet by name.
 int ping()
          Test if the service is alive.
 

Field Detail

SVC_NAME

static final java.lang.String SVC_NAME
The string identifing this service in the rmi registry.

See Also:
Constant Field Values
Method Detail

ping

int ping()
         throws java.rmi.RemoteException
Test if the service is alive. Used by the automatic registration feature of the NetcdfServer implementation.

Returns:
0
Throws:
java.rmi.RemoteException

lookup

NetcdfRemoteProxy lookup(java.lang.String dataSetName)
                         throws java.rmi.RemoteException
Connect to (open) a remote Netcdf dataSet by name. If the name is not the same as one obtainable from the list() opteration on this service, then this method will fail.

Parameters:
dataSetName - String name of the remote Netcdf
Returns:
NetcdfRemoteProxy which can be used to create an instance of RemoteNetcdf.
Throws:
java.rmi.RemoteException

list

java.lang.String[] list()
                        throws java.rmi.RemoteException
List the names of exported data sets.

Throws:
java.rmi.RemoteException