Faceted Project Framework
Version 1.3

org.eclipse.wst.common.project.facet.core.events
Interface IFacetedProjectListener


public interface IFacetedProjectListener

This interface is implemented by those who wish to receive events when a faceted project is changed. There are three ways to register a listener: (a) using methods on IFacetedProject, (b) using methods on FacetedProjectFramework, or (c) using the provided extension point. Method (a) catches only events for a specific faceted project while methods (b) and (c) catch events for all faceted projects in the workspace.

Author:
Konstantin Komissarchik

Method Summary
 void handleEvent(IFacetedProjectEvent event)
          This method is called by the framework to notify the listener that an event has occurred.
 

Method Detail

handleEvent

void handleEvent(IFacetedProjectEvent event)
This method is called by the framework to notify the listener that an event has occurred.

All events except for PROJECT_MODIFIED of this type are triggered in the lock context of the operation that caused the original change. This guarantees that the project has not changed further from the state it was in after the change was complete, however the listener is unable to call any modifier methods on the IFacetedProject interface. To do so, the listener must spin off a thread.

It is highly advised that any listener that performs non-critical or long-running tasks that can be performed in the background (such as updating UI) do so asynchronously by spinning off a thread, scheduling a job, etc. This allows the original modification to complete faster resulting in better perceived responsiveness.

Parameters:
event - the object describing the event

Faceted Project Framework
Version 1.3

Copyright (c) 2008 BEA Systems, Inc. and others. All rights reserved.