visad.data
Class LinkedDataSource

java.lang.Object
  visad.data.LinkedDataSource

Direct Known Subclasses:

SocketDataSource

public abstract class LinkedDataSource
extends java.lang.Object

A class for linking a data source (e.g., a URL) with a DataReference. Whenever the data changes at the source, the new data is automatically loaded and the DataReference is set to point to it. VisAD applications can then use a CellImpl with the DataReference object in order to detect changes to the data at its source.

Field Summary

protected static boolean	DEBUG Debugging flag.
protected java.lang.String	name The name of this LinkedDataSource.

Constructor Summary

LinkedDataSource(java.lang.String name)
Construct a LinkedDataSource with the given name.

Method Summary

void	dataChanged(Data data) Update the data to which this LinkedDataSource is linked.
java.lang.String	getName() Return the name of this LinkedDataSource.
DataReferenceImpl	getReference() Return the DataReference for this LinkedDataSource.
boolean	isAlive() Return whether the connection to the data source is still alive.
abstract void	open(java.lang.String id) Load initial data from the given data source and remain linked to the data source, monitoring it for changes to the data.

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

protected static final boolean DEBUG

Debugging flag.

See Also:

Constant Field Values

name

protected java.lang.String name

The name of this LinkedDataSource.

Constructor Detail

LinkedDataSource

public LinkedDataSource(java.lang.String name)

Construct a LinkedDataSource with the given name.

Method Detail

open

public abstract void open(java.lang.String id)
                   throws java.io.IOException,
                          VisADException,
                          java.rmi.RemoteException

Load initial data from the given data source and remain linked to the data source, monitoring it for changes to the data.

Throws:

java.io.IOException

VisADException

java.rmi.RemoteException

dataChanged

public void dataChanged(Data data)
                 throws VisADException,
                        java.rmi.RemoteException

Update the data to which this LinkedDataSource is linked.

Throws:

VisADException

java.rmi.RemoteException

getName

public java.lang.String getName()

Return the name of this LinkedDataSource.

getReference

public DataReferenceImpl getReference()

Return the DataReference for this LinkedDataSource.

isAlive

public boolean isAlive()

Return whether the connection to the data source is still alive.