Ein eigenes TreeModel schreiben: Unterschied zwischen den Versionen

Aus Byte-Welt Wiki
Zur Navigation springenZur Suche springen
K (getRoot()-Methode implementieren)
K
Zeile 43: Zeile 43:
 
public BicycleTreeModel implements TreeModel {
 
public BicycleTreeModel implements TreeModel {
  
 +
  @Override
 
   public Object getChild(Object parent, int index) {
 
   public Object getChild(Object parent, int index) {
  
 
   }
 
   }
  
 +
  @Override
 
   public int getChildCount(Object parent) {
 
   public int getChildCount(Object parent) {
  
 
   }
 
   }
  
 +
  @Override
 
   public int getIndexOfChild(Object parent, Object child) {
 
   public int getIndexOfChild(Object parent, Object child) {
  
 
   }
 
   }
  
 +
  @Override
 
   public Object getRoot() {
 
   public Object getRoot() {
  
 
   }
 
   }
  
 +
  @Override
 
   public boolean isLeaf(Object node) {
 
   public boolean isLeaf(Object node) {
  
 
   }
 
   }
  
 +
  @Override
 
   public void addTreeModelListener(TreeModelListener l) {
 
   public void addTreeModelListener(TreeModelListener l) {
  
 
   }
 
   }
  
 +
  @Override
 
   public void removeTreeModelListener(TreeModelListener l) {
 
   public void removeTreeModelListener(TreeModelListener l) {
  
 
   }
 
   }
  
 +
  @Override
 
   public void valueForPathChanged(TreePath path, Object newValue) {
 
   public void valueForPathChanged(TreePath path, Object newValue) {
  
Zeile 93: Zeile 101:
 
   [...]
 
   [...]
  
 +
  @Override
 
   public void addTreeModelListener(TreeModelListener l) {
 
   public void addTreeModelListener(TreeModelListener l) {
 
       listeners.remove(TreeModelListener.class, listener);
 
       listeners.remove(TreeModelListener.class, listener);
 
   }
 
   }
  
 +
  @Override
 
   public void removeTreeModelListener(TreeModelListener l) {
 
   public void removeTreeModelListener(TreeModelListener l) {
 
       listeners.add(TreeModelListener.class, listener);
 
       listeners.add(TreeModelListener.class, listener);

Version vom 3. Februar 2022, 10:50 Uhr

TreeModels enthalten die Daten, die ein JTree darstellen soll. In diesem Artikel werden wir uns damit befassen, wie man Schritt für Schritt ein eigenes dynamisches TreeModel aufbaut. Nach der Lektüre dieses Artikels sollte der Leser in der Lage sein, selbstständig eigene TreeModels zu entwickeln.

Überblick

Damit der JTree das darzustellende Datenformat verstehen kann, muss dieses einem entsprechenden Standard genügen. Den kleinsten gemeinsamen Nenner bildet hier das TreeModel.

Im Gegensatz zu JTable existiert für den JTree keine abstrakte Standardimplementierung seines Datenmodells. JTable bietet hier die Klasse AbstractTableModel welche das Interface TableModel implementiert an. Diese Klasse enthält bereits eine einfache Verarbeitung von TableModelEvents, reagiert also auf Veränderungen im TableModel. AbstractTableModel wird schließlich von DefaultTableModel beerbt, mit dem Tabellen mit Standard-Datentypen wie bspw. Integer, Double, Float, Boolean, String, Icon erzeugt werden können.

Mehr zu all dem im großen JTable (Tutorial)©.

Eine vergleichbare Klasse AbstractTreeModel gibt es in der Java-API nicht. Für eigene baumartig strukturierte Datentypen muss hier ein eigenes TreeModel geschrieben werden. Mit DefaultTreeModel gibt es schon eine Standardimplementierung eines TreeModels. Die Daten des Baums werden mit Hilfe von Objekten, die das Interface TreeNode implementieren, dargestellt. Veränderbare Daten erfordern den Einsatz von MutableTreeNode. Eine Standardimplementierung wird bereits mit DefaultMutableTreeNode von der Java-API mitgeliefert.

Mehr dazu im großen JTree (Tutorial)©.

Das Interface TreeModel

Das Interface TreeModel schreibt Methoden vor, die eine Klasse implementieren muss, wenn ein JTree die in ihr enthaltenen Daten grafisch darstellen können soll.

public interface TreeModel {
   void addTreeModelListener(TreeModelListener l);

   Object getChild(Object parent, int index);

   int getChildCount(Object parent);

   int 	getIndexOfChild(Object parent, Object child);

   Object getRoot();

   boolean isLeaf(Object node);

   void	removeTreeModelListener(TreeModelListener l);

   void valueForPathChanged(TreePath path, Object newValue);
}

Dynamisches TreeModel implementieren

Nehmen wir an, wir hätten bereits eine eigene Datenstruktur, die die Produktion von Fahrrädern speichert und die wir im JTree präsentieren und zur Laufzeit auch verändern wollen.

Um ein eigenes TreeModel zu implementieren, müssen wir nun also erstmal das TreeModel-Interface implementieren und damit alle von ihm vorgeschriebenen Methoden überschreiben:

public BicycleTreeModel implements TreeModel {

   @Override
   public Object getChild(Object parent, int index) {

   }

   @Override
   public int getChildCount(Object parent) {

   }

   @Override
   public int getIndexOfChild(Object parent, Object child) {

   }

   @Override
   public Object getRoot() {

   }

   @Override
   public boolean isLeaf(Object node) {

   }

   @Override
   public void addTreeModelListener(TreeModelListener l) {

   }

   @Override
   public void removeTreeModelListener(TreeModelListener l) {

   }

   @Override
   public void valueForPathChanged(TreePath path, Object newValue) {

   }
}

TreeModelListener verwalten

Komponenten wie der JTree interessieren sich für das Geschehen in einem TreeModel und lauschen auf Ereignisse, die sich durch Benutzeraktionen ergeben. Das kann z. B. das Hinzufügen, Ändern oder Löschen von Datenelementen im TreeModel sein.

Damit ein Ereignis-Interessent (TreeModelListener) die Benachrichtigungen über TreeModelEvents abonieren kann, muss er sich als Abonent registrieren.

Mit der Klasse EventListenerList gibt es in Java bereits eine fertige Ereignis-Lauscher-Liste, die für alle möglichen [...]ModelListener-Typen eingesetzt werden kann.
Im Folgenden kümmern wir uns also darum, dass wir diese EventListenerList in unser TreeModel einbauen und auch die Möglichkeit schaffen, dass sich Interessenten für die Benachrichtigung über TreeModelEvents an unserem "Abo-Dienst" anmelden und auch von ihm wieder abmelden können.

Zeit, um den bereits implementierten Methoden addTreeModelListener(TreeModelListener l) und removeTreeModelListener(TreeModelListener l) sinnvollen Code zu geben!

public BicycleTreeModel implements TreeModel {

   private final EventListenerList listeners;

   [...]

   @Override
   public void addTreeModelListener(TreeModelListener l) {
      listeners.remove(TreeModelListener.class, listener);
   }

   @Override
   public void removeTreeModelListener(TreeModelListener l) {
      listeners.add(TreeModelListener.class, listener);
   }

   [...]
}

Ein Konstruktor für unser TreeModel

Wie wir oben bereits angenommen haben, haben wir vielleicht schon eine Datenstruktur, die die Produktion von Fahrrädern verwaltet und speichert. Dann sollte unser Konstruktor per Parameter diese Datenstruktur auch übernehmen, um sie dann in unserem TreeModel weiter auslesen, und beschreiben zu können. Vorteil hier; ohne unsere Datenstruktur anpassen zu müssen, können wir diese nun auch über den JTree verwalten und vor allem darstellen.

public BicycleTreeModel implements TreeModel {

   private final EventListenerList listeners;
   private final BicycleProduction production;

   public BicycleTreeModel(BicycleProduction production) {
      listeners = new EventListenerList();
      this.production = production;
   }

   [...]
}

getRoot()-Methode implementieren

Weiter geht es mit der Implementierung der TreeModel-Methoden. Schrittweise werden wir nun die Methoden mit sinnvollem Code füllen.

Die getRoot()-Methode soll den Wurzelknoten des Baumes zurückgeben. Die Verknüpfung von Elementen aus unserer bestehenden Datenstruktur mit einem Baumknoten kann recht einfach wie komfortabel über die von der API bereitgestellten Klasse DefaultMutableTreeNode erledigt werden. Mehr dazu im großen JTree (Tutorial)©.

public BicycleTreeModel implements TreeModel {

   private final EventListenerList listeners;
   private final BicycleProduction production;
   private final DefaultMutableTreeNode root;

   public BicycleTreeModel(BicycleProduction production) {
      listeners = new EventListenerList();
      this.production = production;
      root = new DefaultMutableTreeNode(production.getPeriod());
      for (Bicycle bicycle : production.getBicycleList()) {
         root.add(new DefaultMutableTreeNode(bicycle));
      }
   }

   /**
    * @see javax.swing.tree.TreeModel#getRoot()
    */
   @Override
   public Object getRoot() {
      return root;
   }

   [...]
}
Baustelle.png Dieser Beitrag wird derzeit noch bearbeitet. Der Text ist deshalb unvollständig und kann Fehler oder ungeprüfte Aussagen enthalten.