Creating a Bean Event Set

  1. In the Explorer window, find the class for your bean, expand its node, and right-click Bean Patterns.

  2. In the contextual menu, choose New Unicast Event Source or New Multicast Event Source. Use the Unicast option to add an event set deliverable to only one listener. Use Multicast for an event set deliverable to more than one listener.

    The New Unicast (or Multicast) Event Set dialog box appears, enabling you to customize the code to be generated for the event set.

  3. In the Type field, either type in a fully qualified listener interface name (event class type) or use the combo box to select one. The listener interface must extend java.util.EventListener.

  4. Select one of these options for how the event set is implemented:
  5. If you selected Generate Empty, skip to Step 7.

  6. If you specified a nonempty implementation in the Step 4, the Generate Event Firing Methods box is enabled. Select this checkbox to generate event firing methods for all listeners. A method is generated for every method in the listener interface.

  7. If you selected Generate Event Firing Methods, the Pass Event as Parameter option is enabled. Select this checkbox to add the event as a parameter to each event firing method. The event is passed to the listeners in the body of the firing method.

    If you do not select the Pass Event as Parameter option, each firing method has the same parameters as the constructor of the event object class. The constructor is called in the body of the firing method, and then the newly created event is passed to the listeners. If there are multiple constructors for the event class, the code generator behaves as if the Pass Event as Parameter option is enabled.

  8. Click OK to generate an addEventNameListener method and a RemoveEventNameListener method to your source code, along with firing methods if you specified them.

You can find information about unicast and multicast event delivery and APIs referenced above in the JavaBeans specification found at http://java.sun.com/beans/docs/spec.html.

See also
Creating a Bean

Creating a Bean Property

Deleting a Property or Event Set

Generating BeanInfo

Legal Notices