Faceted Project Listeners Extension Point

Identifier:
org.eclipse.wst.common.project.facet.core.listeners

Since:
2.0

Description:
This extension point allows for registration of listeners that will be notified of changes to the metadata of faceted projects. The following event types are supported:

PROJECT_MODIFIED
PRE_INSTALL
POST_INSTALL
PRE_UNINSTALL
POST_UNINSTALL
PRE_VERSION_CHANGE
POST_VERSION_CHANGE
FIXED_FACETS_CHANGED
TARGETED_RUNTIMES_CHANGED
PRIMARY_RUNTIME_CHANGED

See the documentation for org.eclipse.wst.common.project.facet.core.events.IFacetedProjectEvent.Type enum for more details about each event type.

It is also possible to register listeners in code using either FacetedProjectFramework.addListener() or IFacetedProject.addListener() methods.

Configuration Markup:

<!ELEMENT extension (listener+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT listener EMPTY>

<!ATTLIST listener

class      CDATA #REQUIRED

eventTypes CDATA #IMPLIED>

Registers one listener.



Examples:

<extension point="org.eclipse.wst.common.project.facet.core.listeners">
  <!-- Listen to all events. -->
  <listener class="com.mycompany.myproduct.MyListener1"/>
  <!-- Listen to specific events. -->
  <listener class="com.mycompany.myproduct.MyListener2" eventTypes="PROJECT_MODIFIED"/>
  <listener class="com.mycompany.myproduct.MyListener2" eventTypes="PRE_INSTALL,FIXED_FACETS_CHANGED"/>
</extension>


Copyright (c) 2005-2007 BEA Systems, Inc.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html.