Cómo descubre el BeanBox las capacidades de Eventos de un Beans

Utilizar la Introspección para Descubrir los Eventos Lanzados por un Bean

Para que un Bean sea la fuente de un evento, debe implementar métodos que añadan y eliminen oyentes para el tipo del objeto. Los patrones de diseño para esos métodos son

public void add<EventListenerType>(<EventListenerType> a)
public void remove<EventListenerType>(<EventListenerType> a)

Para ver los eventos descubiertos utilizando patrones de diseño, arrastra un ejemplar de OurButton dentro del BeanBox y despliega el menú Edit|Events. Esto muestra una lista de interface de eventos que OurButton puede disparar. Observa que el propio OurButton sólo añade dos de esos interfaces; el resto son heredados de la clase base.

Utilizar BeanInfo para Definir los Eventos Lanzados por el Bean

public EventSetDescriptor[] getEventSetDescriptors() {
    try {
        EventSetDescriptor push = new EventSetDescriptor(beanClass,
                    "actionPerformed",
                    java.awt.event.ActionListener.class,
                    "actionPerformed");
 
        EventSetDescriptor changed = new EventSetDescriptor(beanClass,
                    "propertyChange",
                    java.beans.PropertyChangeListener.class,
                    "propertyChange");
 
        push.setDisplayName("button push");
        changed.setDisplayName("bound property change");
     
        EventSetDescriptor[] rv = { push, changed};
        return rv;
    } catch (IntrospectionException e) {
        throw new Error(e.toString());
    }
}

Ver los Eventos de un Bean en el BeanBox

Capturando Eventos en el BeanBox

1. Arrancar el BeanBox.
2. Arrastra un Bean Juggler y dos ejemplares de OurButton en el BeanBox.
3. Selecciona un ejemplar de OurButton. En la hoja de propiedades, cambia la etiqueta a "start".
4. Selecciona el segundo ejemplar de OurButton y cambia su etiqueta a "stop".
5. Seleciona el botón start. elige el menú Edit|Events|action|actionPerformed. Esto hace que aparezca una linea marcada entre el botón start y el cursor. Pulsar sobre el ejemplar de Juggler. Esto trae el EventTargetDialog:

   Esta lista contiene los métodos de Juggler que no toman argumentos, o argumentos del tipo actionPerformed.

6. Selecciona el método startJuggling y pulsa OK. Verás un mensaje indicando que el BeanBox está generando una clase adaptador.
7. repite los dos últimos pasos sobre el botón stop, excepto en elegir el método stopJuggling en el EventTargetDialog.

Si pulsas ahora sobre los botones start y stop se arrancará y parará la ejecución de Juggler. Aquí tienes una descripción general de lo que ha sucedido:

• Los botones start y stop son fuentes de eventos. Las fuentes de eventos lanzan eventos a los destinos de eventos. En este ejemplo el Bean Juggler es el Destino del Evento.
• Cuando se selecciona el botón start y se elige un método de evento (mediante el menú Edit|Event), se está eligiendo el tipo de evento que lanzará la fuente del evento.
• cuando se conecta la línea con otro Bean, estás seleccionando el Bean Destino del evento.
• El EventTargetDialog lista los métodos que pueden aceptar ese tipo de eventos o que no tomen parámetros. Cuando se elige un método en el EventTargetDialog, se está eligiendo el método que recibirá el evento lanzado, y actuará sobre él.

Utiliza el menú File|Save pará grabar este ejemplo en un fichero de tu elección.

Clases Adpatadoras de Eventos

// Automatically generated event hookup file.

package tmp.sunw.beanbox;
import sunw.demo.juggler.Juggler;
import java.awt.event.ActionListener;
import java.awt.event.ActionEvent;

public class ___Hookup_1474c0159e implements
           java.awt.event.ActionListener, java.io.Serializable {

    public void setTarget(sunw.demo.juggler.Juggler t) {
        target = t;
    }

    public void actionPerformed(java.awt.event.ActionEvent arg0) {
        target.startJuggling(arg0);
    }

    private sunw.demo.juggler.Juggler target;
}

El Bean EventMonitor

1. Arrastra ejemplares de OurButton y EventMonitor hasta el BeanBox. Podrías redimensionar el EventMonitor (y el BeanBox) para acomodar la visión de los informes de eventos.
2. Selecciona el ejemplar de OurButton, y elige cualquier método en el menú Edit|Events.
3. Conecta la línea que aparece con el EventMonitor, y elige su initiateEventSourcMonitoring en el EventTargetDialog.
4. Selecciona el Bean OurButton. Estarás viendo un informe de eventos en el EventMonitor

Cuando el primer evento es enviado, EventMonitor analiza el Bean fuente para descubrir todos los eventos que lanza, crea y registra oyentes de eventos para cada tipo de evento, y luego informa siempre que se lance un evento. Esto es útil para depuración, Intenta conectar otros Beans a EventMonitor para observar sus eventos.

Eventos para Propiedades Compartidas y Restringidas

Ozito