ResolveReferencesEvent (IIZI(R) 1.6.0.15561 Java API Specification)

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

Constructor Summary

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

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	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:
    java.lang.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.