org.w3c.tools.resources
Class AbstractContainer

java.lang.Object
  extended by org.w3c.tools.resources.AttributeHolder
      extended by org.w3c.tools.resources.Resource
          extended by org.w3c.tools.resources.FramedResource
              extended by org.w3c.tools.resources.AbstractContainer
All Implemented Interfaces:
java.lang.Cloneable, java.util.EventListener, ContainerInterface, AttributeChangedListener, FrameEventListener, StructureChangedListener
Direct Known Subclasses:
ConfigResource, ContainerResource, ControlResource

public abstract class AbstractContainer
extends FramedResource
implements ContainerInterface, StructureChangedListener, AttributeChangedListener

The top level class for Resource Container.


Field Summary
static java.lang.String ur
           
 
Fields inherited from class org.w3c.tools.resources.FramedResource
ATTR_OID, attrListener, debugEvent, event_disabled, framesRef, structListener
 
Fields inherited from class org.w3c.tools.resources.Resource
ATTR_CONTEXT, ATTR_HELP_URL, ATTR_IDENTIFIER, ATTR_LAST_MODIFIED, ATTR_PARENT, ATTR_RESOURCE_FRAMES, ATTR_STORE_ENTRY, ATTR_URL, co, id
 
Fields inherited from class org.w3c.tools.resources.AttributeHolder
attributes, values
 
Constructor Summary
AbstractContainer()
           
 
Method Summary
 void attributeChanged(AttributeChangedEvent evt)
          Gets called when a property changes.
abstract  ResourceReference createDefaultResource(java.lang.String name)
          Create a default child resource in that container.
abstract  void delete(java.lang.String name)
          Remove a child resource from that container.
 java.util.Enumeration enumerateResourceIdentifiers()
           
abstract  java.util.Enumeration enumerateResourceIdentifiers(boolean all)
          Enumerate children resource identifiers.
abstract  ResourceReference lookup(java.lang.String name)
          Lookup a children in the container.
abstract  void registerResource(java.lang.String name, Resource resource, java.util.Hashtable defs)
          Initialize and register the given resource within that container.
 void resourceCreated(StructureChangedEvent evt)
          A new resource has been created in some space.
 void resourceModified(StructureChangedEvent evt)
          This handles the RESOURCE_MODIFIED kind of events.
 void resourceRemoved(StructureChangedEvent evt)
          A resource is about to be removed This handles the RESOURCE_REMOVED kind of events.
 void resourceUnloaded(StructureChangedEvent evt)
          A resource is about to be unloaded This handles the RESOURCE_UNLOADED kind of events.
protected  ResourceContext updateDefaultChildAttributes(java.util.Hashtable attrs)
          Ask our frames to update default child attributes.
 
Methods inherited from class org.w3c.tools.resources.FramedResource
addAttributeChangedListener, addStructureChangedListener, collectFramesReference, delete, disableEvent, displayEvent, enableEvent, eventDisabled, fireAttributeChangeEvent, fireStructureChangedEvent, fireStructureChangedEvent, frameAdded, frameModified, frameRemoved, getClone, getFrame, getFrame, getFrameReference, getFrameReference, getFramesReference, getOid, initialize, lookup, markModified, notifyUnload, perform, performFrames, postAttributeChangeEvent, postEvent, postStructureChangedEvent, postStructureChangedEvent, processEvent, registerFrame, registerFrameIfNone, removeAttributeChangedListener, removeStructureChangedListener, setSilentValue, setSilentValue, setValue, unregisterFrame
 
Methods inherited from class org.w3c.tools.resources.Resource
acceptUnload, checkMultipleLock, collectFrames, getContext, getFrame, getFrames, getHelpURL, getHelpURL, getIdentifier, getLastModified, getParent, getResourceReference, getServer, getSpace, getSpaceEntry, getStoreEntry, getURLPath, getValue, getValue, initialize, isInitialized, isUnloaded, pickleValues, setContext, setContext, setValue, unsafeGetContext, unsafeGetFrame, unsafeGetFrames, unsafeGetIdentifier, unsafeGetResourceReference, unsafeGetURLPath, unsafeGetValue, updateAttributes
 
Methods inherited from class org.w3c.tools.resources.AttributeHolder
definesAttribute, definesAttribute, getAttributes, getBoolean, getChar, getClone, getClone, getDouble, getFloat, getInt, getLong, getString, getValue, lookupAttribute, print, setBoolean, setChar, setDouble, setFloat, setInt, setLong, setString, setValue, unsafeDefinesAttribute, unsafeGetDouble, unsafeGetString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ur

public static java.lang.String ur
Constructor Detail

AbstractContainer

public AbstractContainer()
Method Detail

resourceModified

public void resourceModified(StructureChangedEvent evt)
This handles the RESOURCE_MODIFIED kind of events.

Specified by:
resourceModified in interface StructureChangedListener
Parameters:
evt - The StructureChangeEvent.

resourceCreated

public void resourceCreated(StructureChangedEvent evt)
A new resource has been created in some space. This handles the RESOURCE_CREATED kind of events.

Specified by:
resourceCreated in interface StructureChangedListener
Parameters:
evt - The event describing the change.

resourceRemoved

public void resourceRemoved(StructureChangedEvent evt)
A resource is about to be removed This handles the RESOURCE_REMOVED kind of events.

Specified by:
resourceRemoved in interface StructureChangedListener
Parameters:
evt - The event describing the change.

resourceUnloaded

public void resourceUnloaded(StructureChangedEvent evt)
A resource is about to be unloaded This handles the RESOURCE_UNLOADED kind of events.

Specified by:
resourceUnloaded in interface StructureChangedListener
Parameters:
evt - The event describing the change.

attributeChanged

public void attributeChanged(AttributeChangedEvent evt)
Gets called when a property changes.

Specified by:
attributeChanged in interface AttributeChangedListener
Parameters:
evt - The AttributeChangeEvent describing the change.

enumerateResourceIdentifiers

public abstract java.util.Enumeration enumerateResourceIdentifiers(boolean all)
Enumerate children resource identifiers.

Specified by:
enumerateResourceIdentifiers in interface ContainerInterface
Parameters:
all - Should all resources be enumerated ? Resources are often created on demand only, this flag allows the caller to tell the container about wether it is interested only in already created resources, or in all resources (even the one that have not yet been created).
Returns:
An String enumeration, one element per child.

enumerateResourceIdentifiers

public java.util.Enumeration enumerateResourceIdentifiers()

updateDefaultChildAttributes

protected ResourceContext updateDefaultChildAttributes(java.util.Hashtable attrs)
Ask our frames to update default child attributes.

Parameters:
attrs - A hashtable.

lookup

public abstract ResourceReference lookup(java.lang.String name)
Lookup a children in the container.

Specified by:
lookup in interface ContainerInterface
Parameters:
name - The name of the children to lookup. the resource from its store.

delete

public abstract void delete(java.lang.String name)
                     throws MultipleLockException
Remove a child resource from that container.

Specified by:
delete in interface ContainerInterface
Parameters:
name - The name of the child to remove.
Throws:
MultipleLockException - If someone else has locked the resource.

createDefaultResource

public abstract ResourceReference createDefaultResource(java.lang.String name)
Create a default child resource in that container. This method is called by the editor to add a default resource in the container under the given name. The meaning of default is left up to the container here.

Parameters:
name - The identifier for the new resource.

registerResource

public abstract void registerResource(java.lang.String name,
                                      Resource resource,
                                      java.util.Hashtable defs)
                               throws InvalidResourceException
Initialize and register the given resource within that container.

Specified by:
registerResource in interface ContainerInterface
Parameters:
name - The identifier for the resource.
resource - An unitialized resource instance.
defs - A default set of init attribute values (may be null).
Throws:
InvalidResourceException - If an error occurs during the registration.