org.gvsig.fmap.dal.feature.impl.dynobjectutils

Class DynObjectSetFeatureSetFacade

java.lang.Object

org.gvsig.tools.observer.impl.BaseWeakReferencingObservable

org.gvsig.fmap.dal.feature.impl.dynobjectutils.DynObjectSetFeatureSetFacade

All Implemented Interfaces:

Cloneable, Disposable, DynObjectSet, ComplexObservable, ComplexWeakReferencingObservable, Observable, Observer, WeakReferencingObservable, IndexedVisitable, Visitable

public class DynObjectSetFeatureSetFacade
extends BaseWeakReferencingObservable
implements DynObjectSet, Observer

DynObject implementation to facade of a FeatureSet and allow to be used as a DynObjectSet.

Nested Class Summary

Nested classes/interfaces inherited from interface org.gvsig.tools.dynobject.DynObjectSet

DynObjectSet.Notification

Constructor Summary

Constructors

Constructor and Description
DynObjectSetFeatureSetFacade(FeatureSet featureSet, FeatureStore store) Creates a new facade over a given feature set, with fast dynobject iteration.
DynObjectSetFeatureSetFacade(FeatureSet featureSet, FeatureStore store, boolean fast) Creates a new facade over a given feature set, with fast dynobject iteration.

Method Summary

Modifier and Type	Method and Description
void	accept(Visitor visitor) Provides each value of this container to the provided Visitor.
void	accept(Visitor visitor, long firstValueIndex) Provides each value of this container to the provided Visitor, beginning from the provided index position.
void	delete(DynObject dynObject) Deletes a DynObject from this set.
void	dispose() Disposes the current object, to allow it to close and dispose any used resources.
long	getSize() Returns the number of DynObject(s) contained in this DynObjectSet.
boolean	isDeleteEnabled() Tells if DynObject deletion is enabled into this set.
boolean	isEmpty() Indicates whether this DynObjectSet contains zero DynObjects.
boolean	isUpdateEnabled() Tells if DynObject updates are enabled into this set.
DisposableIterator	iterator() Returns an iterator over the elements in this collection, in the order (if any) defined when the collection was obtained.
DisposableIterator	iterator(long index) Returns an iterator over the elements in this collection, in the order (if any) defined when the collection was obtained.
void	update(DynObject dynObject) Updates a DynObject from this set.
void	update(Observable observable, Object notification) Called whenever a Observable object is changed and this Observer has registered on it to receive notifications.

Methods inherited from class org.gvsig.tools.observer.impl.BaseWeakReferencingObservable

addObserver, addObserver, addObservers, beginComplexNotification, clearChanged, clone, countObservers, deleteObserver, deleteObserver, deleteObservers, disableNotifications, enableNotifications, endComplexNotification, hasChanged, inComplex, isEnabledNotifications, notify, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gvsig.tools.observer.Observable

addObserver, deleteObserver, deleteObservers

Constructor Detail

DynObjectSetFeatureSetFacade

public DynObjectSetFeatureSetFacade(FeatureSet featureSet,
                                    FeatureStore store)

Creates a new facade over a given feature set, with fast dynobject iteration.

Parameters:

featureSet - to facade

DynObjectSetFeatureSetFacade

public DynObjectSetFeatureSetFacade(FeatureSet featureSet,
                                    FeatureStore store,
                                    boolean fast)

Creates a new facade over a given feature set, with fast dynobject iteration.

Parameters:

featureSet - to facade

fast - if true try to reuse objects as much as possible to make the object iteration faster. If true, DynObjects got through the returned set must not be stored unless cloned.

Method Detail

dispose

public void dispose()

Description copied from interface: Disposable

Disposes the current object, to allow it to close and dispose any used resources.

NOTE:After calling this method, the object may not be usable anymore.

Specified by:

dispose in interface Disposable

accept

public void accept(Visitor visitor,
                   long firstValueIndex)
            throws BaseException

Description copied from interface: IndexedVisitable

Provides each value of this container to the provided Visitor, beginning from the provided index position.

Specified by:

accept in interface IndexedVisitable

Parameters:

visitor - the visitor to apply to each value.

firstValueIndex - index of first element to be visited by the Visitor

Throws:

BaseException - if there is an error while performing the visit

accept

public void accept(Visitor visitor)
            throws BaseException

Description copied from interface: Visitable

Provides each value of this container to the provided Visitor.

Specified by:

accept in interface Visitable

Parameters:

visitor - the visitor to apply to each value.

Throws:

BaseException - if there is an error while performing the visit

getSize

public long getSize()
             throws BaseException

Description copied from interface: DynObjectSet

Returns the number of DynObject(s) contained in this DynObjectSet.

Specified by:

getSize in interface DynObjectSet

Returns:

number of DynObject(s) contained in this DynObjectSet.

Throws:

BaseException

iterator

public DisposableIterator iterator(long index)
                            throws BaseException

Description copied from interface: DynObjectSet

Returns an iterator over the elements in this collection, in the order (if any) defined when the collection was obtained. The iterator starts at the specified position in this collection. The specified index indicates the first element that would be returned by an initial call to the next method. An initial call to the previous method would return the element with the specified index minus one.

NOTE: if you use this method to get the iterator, you must get sure the iterator is disposed (@see Disposable.dispose()) in any case, even if an error occurs while getting the data. It is recommended to use the accept methods instead, which handle everything for you. Take into account the accept methods may use a fast iterator to get the DynObjects.

Specified by:

iterator in interface DynObjectSet

Parameters:

index - index of first element to be returned from the iterator (by a call to the next method).

Returns:

an iterator of the elements in this collection (in proper sequence), starting at the specified position in the collection.

Throws:

BaseException - if the index is out of range (index < 0 || index > size()).

See Also:

Visitable.accept(org.gvsig.tools.visitor.Visitor), IndexedVisitable.accept(org.gvsig.tools.visitor.Visitor, long)

iterator

public DisposableIterator iterator()
                            throws BaseException

Description copied from interface: DynObjectSet

Returns an iterator over the elements in this collection, in the order (if any) defined when the collection was obtained.

NOTE: if you use this method to get the iterator, you must get sure the iterator is disposed (@see Disposable.dispose()) in any case, even if an error occurs while getting the data. It is recommended to use the accept methods instead, which handle everything for you. Take into account the accept methods may use a fast iterator to get the DynObjects.

Specified by:

iterator in interface DynObjectSet

Returns:

an iterator of the elements in this collection (in proper sequence).

Throws:

BaseException

See Also:

Visitable.accept(org.gvsig.tools.visitor.Visitor), IndexedVisitable.accept(org.gvsig.tools.visitor.Visitor, long)

isEmpty

public boolean isEmpty()
                throws BaseException

Description copied from interface: DynObjectSet

Indicates whether this DynObjectSet contains zero DynObjects.

Specified by:

isEmpty in interface DynObjectSet

Returns:

true if this DynObjectSet is empty, false otherwise.

Throws:

BaseException

isDeleteEnabled

public boolean isDeleteEnabled()

Description copied from interface: DynObjectSet

Tells if DynObject deletion is enabled into this set.

Specified by:

isDeleteEnabled in interface DynObjectSet

Returns:

if DynObject deletion is enabled into this set

delete

public void delete(DynObject dynObject)
            throws BaseException

Description copied from interface: DynObjectSet

Deletes a DynObject from this set. Depending on the inner set implementation that may mean also the data will be removed from a persistent state.

Specified by:

delete in interface DynObjectSet

Parameters:

dynObject - to remove

Throws:

BaseException - if there is an error removing the DynObject

isUpdateEnabled

public boolean isUpdateEnabled()

Description copied from interface: DynObjectSet

Tells if DynObject updates are enabled into this set.

Specified by:

isUpdateEnabled in interface DynObjectSet

Returns:

if DynObject updates are enabled into this set

update

public void update(DynObject dynObject)
            throws BaseException

Description copied from interface: DynObjectSet

Updates a DynObject from this set. Depending on the inner set implementation that may mean also the data will be updated in a persistent state.

Specified by:

update in interface DynObjectSet

Parameters:

dynObject - to update

Throws:

BaseException - if there is an error updating the DynObject

update

public void update(Observable observable,
                   Object notification)

Description copied from interface: Observer

Called whenever a Observable object is changed and this Observer has registered on it to receive notifications.

Implementations of this method will be called for each simple notification or, if a complex notification is created, for each of the child notifications.

In the latter case, don't assume any ordering in the notification between this Observer and other Observers listening to the same Observable.

In a complex notification scenario, if you want to receive only the complex notification and not each of the child notifications, just implement the ComplexObserver and prepare this method implementation to handle receiving DefaultComplexNotification instances as well as direct notification objects.

Specified by:

update in interface Observer

Parameters:

observable - the observable object.

notification - the notification data.