com.iizix.event

Class ResolveReferencesEvent

java.lang.Object

com.iizix.event.GEvent

com.iizix.event.ResolveReferencesEvent

All Implemented Interfaces:

IPostEventProcessing

public class ResolveReferencesEvent
extends GEvent

Event used to resolve references in a broadcast event sent to all properties from the root container.

This event is not passed the normal event channel, it is sent directly to the property. Property containers call all its children with this event using GProp.onReferenceEvent(ResolveReferencesEvent).

Two events are sent with the same event ID, but with different options, the first one is sent in the order of: SELF, LISTENER, CHILDREN. To check if it's the first event, verify that isPostResolving() is false. This event makes sure that a property performs its own reference resolving before passing it on further down to its children. It is e.g. used to handle the VSReference property for a Web Service, followed by VSRelativeReference in the Web Service children properties. In this case it is important that VSReference is resolved before VSRelativeReference.

The second event has the flag returned by isPostResolving() set to true. The event order is: CHILDREN, LISTENER, SELF. It gives the property an opportunity to collect results from the resolve process of its children in order to e.g. create error markers in Eclipse for resources.

The Event ID is GEvent.PROP_RESOLVE_REFERENCES.

Author:

Christopher Mindus

Nested Class Summary

Nested classes/interfaces inherited from class com.iizix.event.GEvent

GEvent.Operation

Field Summary

Fields inherited from class com.iizix.event.GEvent

PROP_ADDED, PROP_ATTR_CHANGED, PROP_CNR_ADDED, PROP_CNR_FOCUS, PROP_CNR_MOVED, PROP_CNR_RENAMED, PROP_DESIGNER_ASSET_CHANGED, PROP_DESIGNER_JAVA_CLASS_CHANGED, PROP_DESIGNER_JAVA_METHOD_RENAMED, PROP_DESIGNER_KSTRING, PROP_DESIGNER_VIEWER_UPDATE, PROP_DESIGNER_VS_REFERENCE, PROP_DISPOSED, PROP_FOCUS, PROP_MOVED_FROM, PROP_MOVED_TO, PROP_PROJECT_RENAMED, PROP_QUERY_DESIGNER_PROPS, PROP_REFRESH, PROP_REMOVED, PROP_RENAMED, PROP_REORDERED, PROP_RESOLVE_REFERENCES_DIRECT, PROP_VALUE_CHANGED, REMOTE

Constructor Summary

Constructors

Constructor and Description
ResolveReferencesEvent(PropCnr root, boolean doReCheck, boolean isPostResolving) Constructs a new Resolve References event with the specified isPostResolving flag.

Method Summary

Modifier and Type	Method and Description
boolean	doReCheck() Gets the flag to force a re-check of the reference, even resolved ones.
GEvent.Operation[]	getOperations() Gets the Operations order describing what Operation the property that receives the event should process.
boolean	isPostResolving() Checks if event is a post-reference resolve event flavor, i.e.

Methods inherited from class com.iizix.event.GEvent

addPostProcessor, cancel, consume, getAlternateDestination, getEventID, getEventName, getEventName, getEventTarget, getOperation, getPostProcessors, getSender, getSource, getTrigger, isCancelled, isClearCacheEvent, isConsumed, isEventProcessed, isPropertyChange, isPropertyChange, isPropertyChange, isPropertyChangeIn, isPropertyChangeInTree, isRefreshEvent, isRemoteInduced, isVerifyEvent, paramString, send, send, sendSelf, setInitialProperty, setOperation, setProgressMonitor, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ResolveReferencesEvent

public ResolveReferencesEvent(PropCnr root,
                              boolean doReCheck,
                              boolean isPostResolving)

Constructs a new Resolve References event with the specified isPostResolving flag.

Parameters:

root - The root property.

isPostResolving - Flag indicating this change is induced from a remote party.

Throws:

NullPointerException - If monitor is null.

Method Detail

getOperations

public GEvent.Operation[] getOperations()

Gets the Operations order describing what Operation the property that receives the event should process. This Operations order defines that the event will be sinking, i.e. sent from parent to children.

The event Operations in order are: SELF, CHILDREN for both pre- and post-resolving.

Specified by:

getOperations in class GEvent

Returns:

The order of the Operations, per Event-implementing class dependent, normally a static final array.

isPostResolving

public boolean isPostResolving()

Checks if event is a post-reference resolve event flavor, i.e. the second of the two events fired when resolving references.

doReCheck

public boolean doReCheck()

Gets the flag to force a re-check of the reference, even resolved ones.