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