net.sourceforge.esw.collection
Class NodeMetaCollection

java.lang.Object
  |
  +--net.sourceforge.esw.graph.decorator.ANodeDecorator
        |
        +--net.sourceforge.esw.collection.NodeMetaCollection

All Implemented Interfaces:

java.lang.Cloneable, ICloneable, IMetaCollection, INode, ISupportObject, java.io.Serializable

public class NodeMetaCollection

extends ANodeDecorator

implements IMetaCollection

Provides the abiliities of an IMetaCollection instance based off of a INode instance.

Provides the abilities to retrieve data from any data source, anywhere within the enterprise.

An IMetaCollection instance is an INode instance. All the abilities of the INode architecture are availiable to the IMetaCollection architecture. Since nearly all data structures can be represented as a graph of one sort or another, IMetaCollection instances can contain any kind of data.

Once you set an ITransducer instance on an IMetaCollection you can get() and put() (transduce) data from/to the specified external data source.

Initially, IMetaCollection instances have a DefaultTransducer instance assigned to it during their creational pattern. This DefaultTransducer instance throws TransducerExceptions during any get or put method invocation to handle accedental use of transduction without a viable ITransducer instance assigned to this IMetaCollection instance.

Examples:

    INode node = NodeFactory.createNode();
    IMetaCollection meta = MetaFactory.createMetaCollection( node );
 

See Also:

MetaFactory, INode, ITransducer, Serialized Form

Field Summary

protected ITransducer

transducer The ITransducer instance that represents the operations against a data source.

Fields inherited from class net.sourceforge.esw.graph.decorator.ANodeDecorator

node

Constructor Summary

protected

NodeMetaCollection(INode aNode) Creates a new NodeMetaCollection instance wrapping the specified INode instance.

Method Summary

void	get() Gets the data referrences by the current ITransducer instance into this IMetaCollection instance.
ITransducer	getTransducer() Returns the ITransducer instance used by this IMetaCollection instance during the put() or get() method invocations.
void	put() Puts the data contained within this IMetaCollection instance into the data source referenced by the current ITransducer instance.
void	setTransducer(ITransducer aTransducer) Sets the ITransducer instance to be used by this IMetaCollection instance during the put() or get() method invocations.

Methods inherited from class net.sourceforge.esw.graph.decorator.ANodeDecorator

acceptVisitor, add, add, addParent, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, clear, clone, containsID, equals, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, get, get, getDecoratedNode, getID, getList, getParents, getProperty, getPropertySize, getValue, hashCode, isEmpty, iterator, propertyKeys, remove, removeParent, removeProperty, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener, setID, setProperty, setValue, size, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.sourceforge.esw.graph.INode

acceptVisitor, add, add, addParent, clear, containsID, get, get, getList, getParents, getValue, isEmpty, iterator, remove, removeParent, setValue, size

Methods inherited from interface net.sourceforge.esw.util.ISupportObject

addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, getID, getProperty, getPropertySize, propertyKeys, removeProperty, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener, setID, setProperty

Methods inherited from interface net.sourceforge.esw.util.ICloneable

clone

Field Detail

transducer

protected ITransducer transducer

The ITransducer instance that represents the operations against a data source.

Constructor Detail

NodeMetaCollection

protected NodeMetaCollection(INode aNode)

Creates a new NodeMetaCollection instance wrapping the specified INode instance.

Parameters:

aNode - the INode instance to be wrapped by this NodeMetaCollection instance.

Method Detail

setTransducer

public void setTransducer(ITransducer aTransducer)

Sets the ITransducer instance to be used by this IMetaCollection instance during the put() or get() method invocations.

Fires a IMetaResources.TRANSDUCER_PROPERTY property change event.

Specified by:

setTransducer in interface IMetaCollection

Parameters:

aTransducer - the ITransducer instance to be used for transduction.

See Also:

getTransducer()

getTransducer

public ITransducer getTransducer()

Returns the ITransducer instance used by this IMetaCollection instance during the put() or get() method invocations.

Specified by:

getTransducer in interface IMetaCollection

Returns:

the ITransducer instance for this IMetaCollection instance.

See Also:

setTransducer( ITransducer )

put

public void put()
         throws TransducerException

Puts the data contained within this IMetaCollection instance into the data source referenced by the current ITransducer instance.

Specified by:

put in interface IMetaCollection

Throws:

TransducerException - if an error occurred during the execution of put on the ITransducer instance.

See Also:

get()

get

public void get()
         throws TransducerException

Gets the data referrences by the current ITransducer instance into this IMetaCollection instance.

Specified by:

get in interface IMetaCollection

Throws:

TransducerException - if an error occurred during the execution of get on the ITransducer instance.

See Also:

put()