jnex Einführung

1. jnex Einführung Dipl. El. Ing. ETH Marcel Baumann 2003 Präsentationsunterlagen für die Softwareentwickler Schulung

2. Ziele des Kurses • Erlernen des Umgangs mit den wichtigsten Klassen von jnex • Anhand einfacher Beispiele Zusammenhänge verstehen • Sinn des Frameworks verstehen • Erfolgserlebnisse provozieren

3. Model View Controller Design Pattern (MVC)

4. Model View Controller bei jnex DataModelListener dataModelChangeValue Viewable 0..n 1 DataViewer setValue SimpleViewer StructViewer DataModel DataModelMethod ArrayViewer SimpleModel ContainerModel ButtonViewer StructModel ArrayModel

5. Model View Controller // create a string model and initialize its value to "Hello World!" DataModel model = new StringModel("Hello World!"); // create a viewer for the model (produces a JLabel by default) DataViewer viewer = factory.createViewer(model, false); // create an editor for the same model (produces a JTextField by default) DataViewer editor = factory.createViewer(model, true); // access the Swing JComponents JComponent viewerComponent = viewer.getJComponent(); JComponent editorComponent = editor.getJComponent(); model.setText(“Test”); String value = model.getText();

6. Das Management DefaultViewerMap ViewerMap DataModelClass 0..n ViewerFactory Erzeugt einen passenden Editor oder Viewer eines DataModel ViewerMapEntry ViewerCreator DataLayout DataViewer createViewer(DataModel)

7. Properties (Mehrsprachigkeit) ABCApplication.properties Number=Nr. LastName=Name FirstName=Vorname FirstName.tip=einer oder mehrere… Sex=Geschlecht Telephone=Telefonnummer Country=Land Department=Abteilung Birthdate=Geburtstag File=Datei Exit=Beenden Cancel=Abbrechen

8. Hello World! ViewerFactory factory = ViewerFactory.getDefaultInstance("HelloWorld"); DataModel model = new StringModel("Hello World!"); DataModelCommand resetCommand = new ResetCommand(); model.appendMethod(resetCommand); DataViewer viewer = factory.createViewer(model, false); DataViewer editor = factory.createViewer(model, true); DataViewer resetViewer = factory.createViewer(resetCommand, true); JComponent viewerComponent = viewer.getJComponent(); JComponent editorComponent = editor.getJComponent(); JComponent resetComponent = resetViewer.getJComponent();

9. Verschachtelte Datenmodelle (StructModel) • Die Klasse StructModel ist ein Behälter für andere DataModel • Die Methode append(DataModel) fügt ein Member (Kind) in die Struktur ein. Kinder von Strukturen sollten immer einen eindeutigen Feldnamen haben. • Die Kinder können per Feldname (getChild(String FieldName)) angesprochen werden können • Grosskinder können mit getChild(„Kind;Grosskind“) erreicht werden.

10. Jedes DataModel sendet DataModelEvents, falls sich sein Wert ändert Die Events werden in einer verschachtelten Struktur jeweils zum Vater weitergereicht Es gibt eine vorgefertigte Klasse DataModelAdaptor, die alle Listener Funktionen als leere Methoden enthält DataModelListener einrichten

11. public class DataModelAdaptor implements DataModelEditListener { public void dataModelChangeValue(DataModelEvent event) { } public void dataModelChangeStructure(DataModelEvent event) { } public void dataModelGrabFocus(DataModelEvent event) { } public void dataModelEdit(DataModelEvent event) { } }

12. Calculator

13. Fixe Layout Definition für Strukturen • Eine Struktur wird per default mit einem StructEditor dargestellt. Der StructEditor ist in der Lage, irgend ein StructModel so darzustellen, dass alle Felder des Models erfasst werden können. • Mit einem StructureLayoutItem kann die Position, die Grösse und das Aussehen der einzelnen Mitglieder der Struktur definiert werden. • Ein StructureLayoutItem enthält StructureFieldLayout Einträge, die mit der Methode append(DefaultLayoutItem) eingetragen werden. Jeder Eintrag erwirkt die Darstellung eines Mitglieds (Kind) des StructModel

14. Structure Layout Item import com.nexirius.framework.layout.*; import com.nexirius.framework.dataviewer.*; public class CalculatorLayout extends StructureLayoutItem { public CalculatorLayout() { append(new StructureFieldLayout(„Operator1", 0, 0, 50, 30, null, null, false, null, null)); append(new StructureFieldLayout(„Operand1", 60, 0, 150, 30, null, null, false, null, null)); append(new StructureFieldLayout(„Operator2", 0, 40, 50, 30, null, null, false, null, null)); append(new StructureFieldLayout(„Operand2", 60, 40, 150, 30, null, null, false, null, null)); //… } } child x, y, w, h

15. Layout Positionen und Grössen berechnen int width = 300; int height = 150; int woperator = 100; int gap = 5; int woperand = width - 3 * gap - woperator; int hline = (height - 6 * gap) / 5; int x = gap; int y = gap; append(new StructureFieldLayout("Reset", x, y, woperator, hline, …)); x += woperator + gap; append(new StructureFieldLayout("Operand1", x, y, woperand, hline, …)); x = gap; y += hline + gap; append(new StructureFieldLayout("Operator1", x, y, woperator, hline, …)); x += woperator + gap; append(new StructureFieldLayout("Operand2", x, y, woperand, hline, …));

16. Application • Eine Applikation besteht aus einem JFrame Fenster • In diesem Fenster gibt es am oberen Rand ein Pulldown Menü und gleich darunter ein Toolbar (Symbolleiste). In der Mitte befindet sich der applikationsspezifische Hauptbereich (Main Panel) und am unteren Rand befindet sich eine Statuszeile Pulldown Menü Toolbar Main Panel Status Line

17. Hello World Application • Definition der Methoden public HelloWorldApplication(String argv[]) { super(argv); } public DataModel getApplicationModel() { return mainModel; } public String getApplicationName() { return "HelloWorldApplication"; } public void preInit() { //prepare main model } public void init() { // create JComponents in main panel // use -> getMainPanel() // use -> getFactory() }

18. Viewer Creator Map • Die ViewerCreatorMap verknüpft Datenmodelle mit ViewerCreator und mit DefaultLayoutItem Instanzen. • Es gibt immer die Möglichkeit für ein Model einen ViewerCreator, der Editoren erzeugt und einen ViewerCreator, der Viewer erzeugt zu registrieren. Das gleiche gilt für das zugeordnete Layout. • Die vordefinierten Modelltypen sind bereits mit ViewerCreator Instanzen verknüpft! ViewerCreatorMap map = getFactory().getViewerCreatorMap(); map.register(MainModel.class, new MainLayout(), true); map.register(MemberModel.class, new TabbedEditorCreator()); map.register(MemberModel.class, new MemberLayout(), true); map.register(PersonModel.class, new PersonLayout(), true); map.register(AddressModel.class, new AddressEditorLayout(), true); map.register(AddressModel.class, new AddressViewerLayout(), false);

19. Array Model • Ein ArrayModel besteht aus einer beliebigen Anzahl Einträgen, wobei die Einträge vom gleichen Typ sind und per Index angesprochen werden. • Ein ArrayModel wirft ein Value Change Event, wenn sich seine Dimension ändert. • Ein ArrayModel wird per default als Tabelle dargestellt

20. Der Ablauf eines Popup Fensters kopie = original.duplicate(); DataModel kopie; DataModel original; createViewer(kopie); original.dropData(copy.dragData()); return true; return false;