3.1. Das Jowidgets Toolkit

Die Klasse org.jowidgets.api.toolkit.Toolkit liefert eine Instanz der Schnittstelle org.jowidgets.api.toolkit.IToolkit.

    IToolkit toolkit = Toolkit.getInstance();

Sie stellt den Zugriffspunkt auf die Jowidgets API dar. Die Klasse Toolkit bietet zusätzlich zu der Methode getInstance() statische Abreviation Accessor Methoden für alle Methoden der Schnittstelle org.jowidgets.api.toolkit.IToolkit. Dadurch kann man zum Beispiel anstatt:

    IUiThreadAccess uiThreadAccess = Toolkit.getInstance().getUiThreadAccess();

einfach

    IUiThreadAccess uiThreadAccess = Toolkit.getUiThreadAccess();

schreiben.

Es sei an dieser Stelle darauf hingewiesen, das das Toolkit den Kapselungsmechanismus auf die API darstellt. Eine Aufruf einer Funktion über das Toolkit ist u.U. nicht immer intuitiv. Daher existieren zum Teil auch weitere Abreviation Accessor Klassen, um Zugriffe auf das Toolkit abzukürzen. So kann man zum Beispiel anstatt:

   ITreeExpansionAction action = Toolkit.getDefaultActionFactory().expandTreeAction(tree);

auch

   ITreeExpansionAction action = ExpandTreeAction.create(tree);

schreiben.

Per Konvention hat die Abreviation Accessor Klasse dann meist den Namen der Schnittstelle ohne vorgestelltes I. Handelt es sich um eine Factory Methode heißt diese create(). Existiert ein Builder, erhält man diesen auf der selben Accessor Klasse mit Hilfe der Methode builder(). Bezogen auf die TreeExpandionAction würde dass dann so aussehen:

  ITreeExpansionActionBuilder builder = ExpandTreeAction.builder(tree);

Hinweise auf weitere Abreviation Accesor Klassen werden jeweils in den entsprechenden Abschnitten gegeben.

Im folgenden Text ist, soweit nicht gesondert anders vermerkt, mit Toolkit immer das jowidgets Toolkit org.jowidgets.api.toolkit.Toolkit gemeint.


Siehe auch PDF Version dieses Dokuments, Jowidgets API Spezifikation