visad.data.dods

Class DODSSource

java.lang.Object

visad.data.dods.DODSSource

All Implemented Interfaces:

DataInputSource, DataInputStream

public class DODSSource
extends java.lang.Object
implements DataInputSource

Provides support for generating a stream of VisAD data objects from a DODS dataset.

Instances are mutable.

Constructor Summary

Constructors

Constructor and Description
DODSSource() Constructs from nothing.
DODSSource(DataFactory factory) Constructs from a factory for creating VisAD data objects.

Method Summary

Modifier and Type	Method and Description
void	open(java.lang.String spec) Opens an existing DODS dataset.
DataImpl	readData() Returns the next VisAD data object from the DODS dataset.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DODSSource

public DODSSource()

Constructs from nothing. The default factory for creating VisAD data objects will be used.

DODSSource

public DODSSource(DataFactory factory)

Constructs from a factory for creating VisAD data objects.

Parameters:

factory - A factory for creating VisAD data objects.

Method Detail

open

public void open(java.lang.String spec)
          throws BadFormException,
                 java.rmi.RemoteException,
                 VisADException

Opens an existing DODS dataset.

Specified by:

open in interface DataInputSource

Parameters:

spec - The URL string specification of the DODS dataset The path component should have a ".dods" suffix.

Throws:

BadFormException - The DODS dataset is corrupt.

VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI failure.

readData

public DataImpl readData()
                  throws VisADException,
                         java.rmi.RemoteException

Returns the next VisAD data object from the DODS dataset. Returns null if there is no more objects.

Specified by:

readData in interface DataInputStream

Returns:

A VisAD data object or null if there are no more such objects.

Throws:

VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI failure.