All Packages Class Hierarchy This Package Previous Next Index
Class org.w3c.tools.resources.FramedResource
java.lang.Object
|
+----org.w3c.tools.resources.AttributeHolder
|
+----org.w3c.tools.resources.Resource
|
+----org.w3c.tools.resources.FramedResource
- public class FramedResource
- extends Resource
- implements FrameEventListener
A FramedResource manage frames which are called during the
lookup and the perform.
-
ATTR_OID
- Attribute index - The object identifier.
-
attrListener
- Our AttributeChangedListener.
-
debugEvent
-
-
event_disabled
-
-
framesRef
- Our frames references.
-
structListener
- Our StructureChangedListener.
-
FramedResource()
-
-
addAttributeChangedListener(AttributeChangedListener)
- Add an attribute change listener.
-
addStructureChangedListener(StructureChangedListener)
- Add a structure change listener.
-
collectFramesReference(Class)
- Collect any frame reference pointing to an instance of the given class.
-
delete()
- Delete this Resource instance, and remove it from its store.
-
disableEvent()
-
-
displayEvent(FramedResource, EventObject)
-
-
enableEvent()
-
-
fireAttributeChangeEvent(AttributeChangedEvent)
- Fire an attribute change event.
-
fireStructureChangedEvent(int)
- Fire an structure change event.
-
fireStructureChangedEvent(StructureChangedEvent)
- Fire an structure change event.
-
frameAdded(FrameEvent)
- This handles the
FRAME_ADDED
kind of events.
-
frameModified(FrameEvent)
- This handles the
FRAME_MODIFIED
kind of events.
-
frameRemoved(FrameEvent)
- A frame is about to be removed
This handles the
FRAME_REMOVED
kind of events.
-
getClone(Object[])
- Clone this attribute holder, and init it with the given attributes.
-
getFrameReference(Class)
- Get the first occurence of a frame of the given class.
-
getFrameReference(ResourceFrame)
- Get The FrameReference of the given frame, or null
if the frame is not registered.
-
getFramesReference()
- Collect all frames references.
-
getOid()
- Get this resource's object identifier.
-
getServer()
- Get the server this resource is served by.
-
initialize(Object[])
- Initialize the frames of that framed resource.
-
lookup(LookupState, LookupResult)
- Lookup the target resource.
-
markModified()
- Mark this resource as having been modified.
-
notifyUnload()
- This resource is being unloaded.
-
perform(RequestInterface)
- Perform the request.
-
performFrames(RequestInterface)
- Perform the request on all the frames of that resource.
-
postAttributeChangeEvent(int, Object)
- post an attribute change event.
-
postEvent(ResourceEvent)
- Post an Event in the Event Queue.
-
postStructureChangedEvent(int)
- post an structure change event.
-
postStructureChangedEvent(ResourceReference, int)
- post an structure change event.
-
processEvent(ResourceEvent)
- (AWT Like), dspatch the Event to all our listeners.
-
registerFrame(ResourceFrame, Hashtable)
- Initialize and attach a new ResourceFrame to that resource.
-
registerFrameIfNone(String, String)
- Register a new ResourceFrame if none (from the same class) has been
registered.
-
removeAttributeChangedListener(AttributeChangedListener)
- Remove an attribute change listener.
-
removeStructureChangedListener(StructureChangedListener)
- Remove a structure change listener.
-
setValue(int, Object)
- Set some of this resource attribute.
-
unregisterFrame(ResourceFrame)
- Unregister a resource frame from the given resource.
framesRef
protected transient Hashtable framesRef
- Our frames references.
attrListener
protected transient AttributeChangedListener attrListener
- Our AttributeChangedListener.
structListener
protected transient StructureChangedListener structListener
- Our StructureChangedListener.
debugEvent
protected transient boolean debugEvent
event_disabled
protected transient boolean event_disabled
ATTR_OID
protected static int ATTR_OID
- Attribute index - The object identifier.
FramedResource
public FramedResource()
disableEvent
protected void disableEvent()
enableEvent
protected void enableEvent()
getClone
public Object getClone(Object values[])
- Clone this attribute holder, and init it with the given attributes.
- Overrides:
- getClone in class Resource
getServer
public ServerInterface getServer()
- Get the server this resource is served by.
- Returns:
- The first instance of Jigsaw this resource was attached to.
getOid
public int getOid()
- Get this resource's object identifier.
An object identifier is to be used specifically in etags. It's purpose
is to uniquify the etag of a resource. It's computed as a random number
, on demand only.
- Returns:
- A uniq object identifier for that resource, as an inteeger.
displayEvent
protected void displayEvent(FramedResource fr,
EventObject evt)
frameAdded
public void frameAdded(FrameEvent evt)
- This handles the
FRAME_ADDED
kind of events.
- Parameters:
- evt - The FrameEvent.
frameModified
public void frameModified(FrameEvent evt)
- This handles the
FRAME_MODIFIED
kind of events.
- Parameters:
- evt - The event describing the change.
frameRemoved
public void frameRemoved(FrameEvent evt)
- A frame is about to be removed
This handles the
FRAME_REMOVED
kind of events.
- Parameters:
- evt - The event describing the change.
registerFrame
public void registerFrame(ResourceFrame frame,
Hashtable defs)
- Initialize and attach a new ResourceFrame to that resource.
- Parameters:
- frame - An uninitialized ResourceFrame instance.
- defs - A default set of attribute values.
- Overrides:
- registerFrame in class Resource
registerFrameIfNone
protected void registerFrameIfNone(String classname,
String identifier) throws ClassNotFoundException, IllegalAccessException, InstantiationException, ClassCastException
- Register a new ResourceFrame if none (from the same class) has been
registered.
- Parameters:
- classname - The ResourceFrame class
- identifier - The ResourceFrame identifier
- Throws: ClassNotFoundException
- if the class can't be found
- Throws: IllegalAccessException
- if the class or initializer is not
accessible
- Throws: InstantiationException
- if the class can't be instanciated
- Throws: ClassCastException
- if the class is not a ResourceFrame
unregisterFrame
public synchronized void unregisterFrame(ResourceFrame frame)
- Unregister a resource frame from the given resource.
- Parameters:
- frame - The frame to unregister from the resource.
- Overrides:
- unregisterFrame in class Resource
getFramesReference
public synchronized ResourceReference[] getFramesReference()
- Collect all frames references.
- Returns:
- An array of ResourceReference, containing a set of
FrameReference instances or null if no resource
frame is available.
collectFramesReference
public synchronized ResourceReference[] collectFramesReference(Class c)
- Collect any frame reference pointing to an instance of the given class.
- Parameters:
- cls - The class of frames we are looking for.
- Returns:
- An array of ResourceReference, containing a set of
FrameReference pointing to instances of the given class, or
null if no resource frame is available.
getFrameReference
public synchronized ResourceReference getFrameReference(Class c)
- Get the first occurence of a frame of the given class.
- Parameters:
- cls - The class of te frame to look for.
- Returns:
- A ResourceReference instance, or null.
getFrameReference
public synchronized ResourceReference getFrameReference(ResourceFrame frame)
- Get The FrameReference of the given frame, or null
if the frame is not registered.
- Parameters:
- frame - The ResourceFrame.
- Returns:
- A ResourceReference instance.
processEvent
public void processEvent(ResourceEvent evt)
- (AWT Like), dspatch the Event to all our listeners.
- Parameters:
- evt - The resourceEvent to dispatch.
postEvent
public void postEvent(ResourceEvent evt)
- Post an Event in the Event Queue.
- Parameters:
- evt - The Event to post.
addAttributeChangedListener
public void addAttributeChangedListener(AttributeChangedListener l)
- Add an attribute change listener.
- Parameters:
- l - The new attribute change listener.
removeAttributeChangedListener
public void removeAttributeChangedListener(AttributeChangedListener l)
- Remove an attribute change listener.
- Parameters:
- l - The listener to remove.
postAttributeChangeEvent
protected void postAttributeChangeEvent(int idx,
Object newvalue)
- post an attribute change event. Actually this kind of event should
not be posted. So fire them!
- Parameters:
- idx - The index of the attribute that has changed.
- newvalue - The new value for that attribute.
fireAttributeChangeEvent
protected void fireAttributeChangeEvent(AttributeChangedEvent evt)
- Fire an attribute change event.
- Parameters:
- evt - the AttributeChangedEvent to fire.
addStructureChangedListener
public void addStructureChangedListener(StructureChangedListener l)
- Add a structure change listener.
- Parameters:
- l - The new structure change listener.
removeStructureChangedListener
public void removeStructureChangedListener(StructureChangedListener l)
- Remove a structure change listener.
- Parameters:
- l - The listener to remove.
postStructureChangedEvent
protected void postStructureChangedEvent(ResourceReference rr,
int type)
- post an structure change event.
- Parameters:
- rr - the ResourceReference of the source.
- type - The type of the event.
postStructureChangedEvent
protected void postStructureChangedEvent(int type)
- post an structure change event.
- Parameters:
- type - The type of the event.
fireStructureChangedEvent
protected void fireStructureChangedEvent(int type)
- Fire an structure change event.
- Parameters:
- type - The type of the event.
fireStructureChangedEvent
protected void fireStructureChangedEvent(StructureChangedEvent evt)
- Fire an structure change event.
- Parameters:
- evt - the StructureChangedEvent to fire.
notifyUnload
public void notifyUnload()
- This resource is being unloaded.
The resource is being unloaded from memory, perform any additional
cleanup required.
- Overrides:
- notifyUnload in class Resource
delete
public synchronized void delete() throws MultipleLockException
- Delete this Resource instance, and remove it from its store.
This method will erase definitely this resource, for ever, by removing
it from its resource store (when doable).
- Throws: MultipleLockException
- if someone has locked this resource.
- Overrides:
- delete in class Resource
markModified
public void markModified()
- Mark this resource as having been modified.
- Overrides:
- markModified in class Resource
setValue
public synchronized void setValue(int idx,
Object value)
- Set some of this resource attribute. We overide setValue to post
events.
- Overrides:
- setValue in class Resource
lookup
public boolean lookup(LookupState ls,
LookupResult lr) throws ProtocolException
- Lookup the target resource.
- Parameters:
- ls - The current lookup state
- lr - The result
- Returns:
- true if lookup is done.
- Throws: ProtocolException
- If an error relative to the protocol occurs
performFrames
protected ReplyInterface performFrames(RequestInterface request) throws ProtocolException, ResourceException
- Perform the request on all the frames of that resource. The
Reply returned is the first non-null reply.
- Parameters:
- request - A RequestInterface instance.
- Returns:
- A ReplyInterface instance.
- Throws: ProtocolException
- If an error relative to the protocol occurs
- Throws: ResourceException
- If an error not relative to the
protocol occurs
perform
public ReplyInterface perform(RequestInterface request) throws ProtocolException, ResourceException
- Perform the request.
- Returns:
- a ReplyInterface instance
- Throws: ProtocolException
- If an error relative to the protocol occurs
- Throws: ResourceException
- If an error not relative to the
protocol occurs
initialize
public void initialize(Object values[])
- Initialize the frames of that framed resource.
- Parameters:
- values - Default attribute values.
- Overrides:
- initialize in class AttributeHolder
All Packages Class Hierarchy This Package Previous Next Index