oracle.javatools.data
Class Structure

java.lang.Object
  oracle.javatools.data.Structure

All Implemented Interfaces:

Dirtyable

Direct Known Subclasses:

HashStructure, ListStructure

public abstract class Structure
extends java.lang.Object
implements Dirtyable

Base class for HashStructure and ListStructure.

See Also:

HashStructure, ListStructure

Method Summary

void	addStructureChangeListener(StructureChangeListener listener) Adds the specified StructureChangeListener to this Structure.
void	applyBatchChanges(java.lang.Runnable runnable) This method buffers all change events at this level of Structure for the duration of the specified Runnable.
void	clear()
java.lang.String	getFullName() Returns the fully qualified name of this structure relative to its root structure.
java.lang.String	getStructName() Returns the immediate name of this structure relative to its parent structure.
protected static java.lang.Object	intern(java.lang.Object object)
protected static java.lang.String	intern(java.lang.String s)
boolean	isDirty() True if the data in the object has been modified.
void	markDirty(boolean dirty) Marks the entire object graph containing this Structure instance as dirty.
void	removeStructureChangeListener(StructureChangeListener listener) Removes the specified StructureChangeListener from this Structure.

Methods inherited from class java.lang.Object

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

Method Detail

intern

protected static final java.lang.Object intern(java.lang.Object object)

intern

protected static final java.lang.String intern(java.lang.String s)

isDirty

public final boolean isDirty()

Description copied from interface: Dirtyable

True if the data in the object has been modified.

Specified by:

isDirty in interface Dirtyable

Returns:

true if the object graph containing this HashStructure is dirty; false otherwise.

markDirty

public void markDirty(boolean dirty)

Marks the entire object graph containing this Structure instance as dirty.

Specified by:

markDirty in interface Dirtyable

Parameters:

dirty - If true, sets the object as being dirty; if false, sets the object as being up-to-date.

clear

public void clear()

getStructName

public java.lang.String getStructName()

Returns the immediate name of this structure relative to its parent structure. If this structure is a root structure (i.e. it has no parent), then this method returns null.

getFullName

public java.lang.String getFullName()

Returns the fully qualified name of this structure relative to its root structure. If this structure is a root structure (i.e. it has no parent), then this method returns null.

addStructureChangeListener

public void addStructureChangeListener(StructureChangeListener listener)

Adds the specified StructureChangeListener to this Structure. Only events firing from this level of Structure or one of its descendants is forwarded to the listener -- i.e. changes applied to sibling Structures will not automatically notify listeners registered on this Structure.

removeStructureChangeListener

public void removeStructureChangeListener(StructureChangeListener listener)

Removes the specified StructureChangeListener from this Structure.

applyBatchChanges

public void applyBatchChanges(java.lang.Runnable runnable)

This method buffers all change events at this level of Structure for the duration of the specified Runnable. When the Runnable finishes (and if there are no remaining nested calls to applyBatchChanges at this level), a single StructureChangeEvent is fired to listeners with the details of all individual change events that occurred.