Class java.beans.EventSetDescriptor
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.beans.EventSetDescriptor

java.lang.Object
   |
   +----java.beans.FeatureDescriptor
           |
           +----java.beans.EventSetDescriptor

public class EventSetDescriptor
extends FeatureDescriptor
An EventSetDescriptor describes a group of events that a given Java bean fires.

The given group of events are all delivered as method calls on a single event listener interface, and an event listener object can be registered via a call on a registration method supplied by the event source.


Constructor Index

 o EventSetDescriptor(String, Class, Method[], Method, Method)
This constructor creates an EventSetDescriptor from scratch using java.lang.reflect.Method and java.lang.Class objects.
 o EventSetDescriptor(String, String, String, String)
This constructor creates an EventSetDescriptor assuming that you are following the most simple standard design pattern where a named event "fred" is (1) delivered as a call on the single method of interface FredListener, (2) has a single argument of type FredEvent, and (3) where the FredListener may be registered with a call on an addFredListener method of the source component and removed with a call on a removeFredListener method.
 o EventSetDescriptor(String, String, String, String[], String, String)
This constructor creates an EventSetDescriptor from scratch using string names.

Method Index

 o getAddListenerMethod()
 o getListenerMethods()
 o getListenerType()
 o getRemoveListenerMethod()
 o isUnicast()
Normally event sources are multicast.
 o setUnicast(boolean)
Mark an event set as unicast (or not).

Constructors

 o EventSetDescriptor
  public EventSetDescriptor(String sourceClassName,
                            String eventSetName,
                            String listenerClassName,
                            String listenerMethodName) throws IntrospectionException
This constructor creates an EventSetDescriptor assuming that you are following the most simple standard design pattern where a named event "fred" is (1) delivered as a call on the single method of interface FredListener, (2) has a single argument of type FredEvent, and (3) where the FredListener may be registered with a call on an addFredListener method of the source component and removed with a call on a removeFredListener method.
Parameters:
sourceClassName - The name of the class firing the event.
eventSetName - The programmatic name of the event. E.g. "fred". Note that this should normally start with a lower-case character.
listenerClassName - The name of the target interface that events will get delivered to.
listenerMethodName - The method that will get called when the event gets delivered to its target listener interface.
 o EventSetDescriptor
  public EventSetDescriptor(String sourceClassName,
                            String eventSetName,
                            String listenerClassName,
                            String listenerMethodNames[],
                            String addListenerMethodName,
                            String removeListenerMethodName) throws IntrospectionException
This constructor creates an EventSetDescriptor from scratch using string names.
Parameters:
sourceClassName - The name of the class firing the event.
eventSetName - The programmatic name of the event set. Note that this should normally start with a lower-case character.
listenerClassName - The name of the target interface that events will get delivered to.
listenerMethodNames - The names of the methods that will get called when the event gets delivered to its target listener interface.
addListenerMethodName - The name of the method on the event source that can be used to register an event listener object.
removeListenerMethodName - The name of the method on the event source that can be used to de-register an event listener object.
 o EventSetDescriptor
  public EventSetDescriptor(String eventSetName,
                            Class listenerType,
                            Method listenerMethods[],
                            Method addListenerMethod,
                            Method removeListenerMethod) throws IntrospectionException
This constructor creates an EventSetDescriptor from scratch using java.lang.reflect.Method and java.lang.Class objects.
Parameters:
eventSetName - The programmatic name of the event set.
listenerType - The Class for the listener interface.
listenerMethods - An array of Method objects describing each of the event handling methods in the target listener.
addListenerMethod - The method on the event source that can be used to register an event listener object.
removeListenerMethod - The method on the event source that can be used to de-register an event listener object.

Methods

 o getListenerType
  public Class getListenerType()
Returns:
The Class object for the target interface that will get invoked when the event is fired.
 o getListenerMethods
  public Method[] getListenerMethods()
Returns:
An array of Method objects for the target methods within the target listener interface that will get called when events are fired.
 o getAddListenerMethod
  public Method getAddListenerMethod()
Returns:
The method used to register a listener at the event source.
 o getRemoveListenerMethod
  public Method getRemoveListenerMethod()
Returns:
The method used to register a listener at the event source.
 o setUnicast
  public void setUnicast(boolean unicast)
Mark an event set as unicast (or not).
Parameters:
unicast - True if the event set is unicast.
 o isUnicast
  public boolean isUnicast()
Normally event sources are multicast. However there are some exceptions that are strictly unicast.
Returns:
True if the event set is unicast. Defaults to "false".

All Packages  Class Hierarchy  This Package  Previous  Next  Index