ucar.netcdf
Interface NetcdfService

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

NetcdfServer_Stub, 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

public static final java.lang.String SVC_NAME

The string identifing this service in the rmi registry.

Method Detail

ping

public int ping()
         throws java.rmi.RemoteException

Test if the service is alive. Used by the automatic registration feature of the NetcdfServer implementation.

Returns:

0

lookup

public 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.

list

public java.lang.String[] list()
                        throws java.rmi.RemoteException

List the names of exported data sets.