Třídy událostí, listenerů a adaptérů

Události JavaBeans jsou signalizovány, jakmile dojde k aktivitě, jako je např. stisknutí tlačítka nebo zavření okna. Vizuální editor pro prostředí Java zobrazuje události v pohledu Java Beans a vy můžete tento pohled použít k přidání a odebrání událostí.

Seznam definovaných událostí pro objekt JavaBean je popsán v jeho třídě BeanInfo, která také řídí obvykle používané nebo upřednostňované události.

Je možné, že budete chtít přidat událost do objektu JavaBean, chcete-li, aby se při generování JavaBean provedla nějaká činnost, jako například aktualizace databáze při stisknutí tlačítka. Objekt Java Bean, který vyvolává událost, je zdrojový kód a objekt, který je vyvolán zpět při vyvolání události, je označován jako listener. Každý objekt JavaBean má rozhraní, které mu umožňuje oznámit listenery pro každou událost, stejně jako metody pro přidání a odebrání listenerů.

Obvykle platí, že pokud má zdrojový objekt JavaBean metodu XXX, existuje k němu rozhraní listeneru, XXXListener a dvě metody. Je důležité, aby XXXListener rozšiřoval java.util.EventListener. Pokud tomu tak není a pokud není poskytnut specifický objekt BeanInfo, událost nebude zjištěna.

• addXXXListener(XXXListener aListener)
• removeXXXListener(XXXListener aListener)

Metody na rozhraní XXXListener jsou závislé na sémantice události, ale pravidlo je takové, že jejich podpis je void <eventOccurenceMethodName>(<EventStateObjectType> evt);. Je důležité, aby XXXListener rozšiřoval java.util.EventObject. Pokud tomu tak není a pokud není poskytnut specifický objekt BeanInfo, událost nebude zjištěna.

Příkladem události je objekt JavaBean java.awt.Component, který vyvolává události, pokud se přes něj přejede myší. Rozhraní listeneru java.awt.event.MouseMotionListener implementuje následující dvě metody:

• void mouseDragged(MouseEvent evt);
• void mouseMoved(MouseEvent evt);

Pro přidání listeneru myši má java.awt.Component následující dvě metody:

• public void addMouseListener(MouseListener evt);
• public void removeMouseListener(MouseListener listener);

Druhý styl události je generován objektem JavaBean při změně hodnoty vlastnosti. Příkladem je vlastnost "zpřístupněno" na javax.swing.JButton. Vlastnost, která spouští událost při změně její hodnoty se označuje jako vlastnost vazby. Namísto samostatného rozhraní listeneru pro každou vlastnost vazby je použito obecné rozhraní listeneru java.beans.PropertyChangeListener, které má jednoduchou metodu zpětného volání void propertyCanged(PropertyChangeEvent evt); Argument PropertyChangeEvent má tři metody, které mohou být dotazovány příjemcem této metody:  

Pro registraci sledování změny vlastností objektu JavaBean existují dvě metody: void addPropertyChangeListener(PropertyChangeListener listener); void addPropertyChangeListener(String propertyName, PropertyChangeListener listener);

První z těchto metod je vždy přítomná na objektu JavaBean, který má vlastnosti vazby. Avšak druhá je volitelná a závisí na stylu registrace události, použitém autorem JavaBean. Například komponenty AWT používají první styl registrace změn vlastností, zatímco komponenty Swing používají oba styly.

Pro použití události existují tři objekty:

1. Objekt JavaBean, který vyvolává událost (zdrojový kód).
2. Třída, která přijímá upozornění od zdrojového kódu (listener).
3. Třída, která implementuje logiku vyskytující se při zpětném volání listeneru.

Poslední dva uvedené objekty jsou obvykle kombinovány, aby třída provádějící logiku implementovala rozhraní listeneru přímo nebo s použitím vnitřní třídy. Styly kódu, který rozpoznává a generuje vizuální editor pro jazyk Java jsou popsány v oddíle o generování kódů událostí.

javaBean.addFocusListener(new java.awt.event.FocusListener() {      
    public void focusGained(java.awt.event.FocusEvent e) {          
        doFocusGainedCode();      
     }          
        public void focusLost(java.awt.event.FocusEvent e) {      
     }  
});

javaBean.addFocusListener(new java.awt.event.FocusAdapter() {     
     public void focusGained(java.awt.event.FocusEvent e) {          
         doFocusGainedCode();      
         }  
   });