Da sich die UI-Komponenten in ihrer Fähigkeit Daten anzuzeigen zum Teil stark unterscheiden, stehen in RapidClipse 3 verschiedene Daten-Container Typen zur Verfügung:
- Container (Tabelle) - Kann eine Liste mit Datensätzen (Items) speichern.
- Item (Datensatz) - Kann 1 Datensatz bestehend aus mehreren Properties speichern. BeanItem ist eine Erweiterung von Item.
- Property (Einzelner Wert) - Kann nur 1 einzelnen Wert speichern.
...
Ein Container kann eine Liste mit beliebig vielen Datensätzen (BeanItems) aufnehmen. RapidClipse bietet mit dem XdevLazyEntityContainer und dem XdevBeanItemContainer 2 verschiedene Container-Varianten.
...
XdevBeanItemContainer
Anchor |
---|
...
|
...
|
...
Der XdevLazyEntityContainer ist eine Erweiterung von Container.
...
Wird i.d.R. nur von RapidClipse intern verwendet, wenn Property > Auto query data selektiert wird.
XdevBeanItemContainer ist der Standard Daten-Container für benutzerdefinierte Queries.
- Bietet kein vollautomatisiertes Lazy-Loading zwischen Datenbank und Server. Es werden immer nur so viele Datensätze zwischen Datenbank und Server übertragen, wie vom Client durch Scrollen oder Paging angefordert werden.Nimmt keine dynamischen SQLs entgegen (automatisch immer SELECT * FROM ...), sondern lediglich zwischen Server und Client. Das gesamte Abfrageergebnis wird im XdevBeanItemContainer zwischengespeichert. Das Abfrageergebnis muss eigenständig mit Hilfe gängiger Abfragebedingungen minimiert werden.
- Manuelles Hinzufügen von Datensätzen (BeanItems nicht ) möglich.
Model für:
- XdevTable
- XdevComboBox
- XdevListSelect
- XdevTwinColSelect
- XdevTree
- XdevTreeTable
...
...
Der XdevBeanItemContainer ist eine Erweiterung, die von Container ableitet.
- Wird von RapidClipse automatisch verwendet, wenn Property > Data > findAll oder eine eigene Query-Methode ausgewählt wird.
- Bietet kein Lazy-Loading zwischen Datenbank und Server. Das Abfrageergebnis wird vollständig an den XdevBeanItemContainer (Server) übertragen.
- Manuelles Hinzufügen von Datensätzen (BeanItems) möglich.
Examples:
- Entity programmatisch zuweisen Wird von RapidClipse verwendet, wenn bei einer UI-Komponente in den Properties Entity > Data > findAll selektiert ist.
Examples:
Container Instanzieren
Code Block language java theme Confluence table.setContainerDataSource(productsContainerXdevBeanItemContainer<Products> productsContainer = new XdevBeanItemContainer<Products>(Products.class);
Container von XdevTabel zurückgeben lassen
Code Block language java theme Confluence XdevBeanItemContainer<Products> productsContainer = table.getContainerDataSource();
Container InstanzierenEntity programmatisch zuweisen - Die Zuweisung erfolgt mit der Methode setContainerDataSource.
Code Block language java theme Confluence XdevBeanItemContainer<Products> productsContainer = new XdevBeanItemContainer<Products>(Products.class);
BeanItem
...
table.setContainerDataSource(productsContainer);
XdevLazyEntityContainer
Anchor | ||||
---|---|---|---|---|
|
Der XdevLazyEntityContainer wird nur von RapidClipse verwendet, wenn bei einer UI-Komponente in den Properties Entity > Auto query data selektiert ist.
Bietet vollautomatisiertes Lazy-Loading zwischen Datenbank, Server und Client. Es werden immer nur so viele Datensätze zwischen Datenbank und Server übertragen, wie vom Client durch Scrollen oder Paging angefordert werden.
- Nimmt keine dynamischen SQLs entgegen (automatisch immer SELECT * FROM ...)
- Manuelles Hinzufügen von BeanItems nicht möglich.
Model für:
- XdevTable
- XdevComboBox
- XdevListSelect
- XdevTwinColSelect
- XdevTree
- XdevTreeTable
Item
Ein Item kann eine Liste mit Properties (einzelne Werten) und damit nur 1 Datensatz aufnehmen. RapidClipse verwendet standardmäßig die Item Erweiterung BeanItem.
Chai | 10 boxes x 20 bags | 18 | 39 | 0 | false | 10 |
Model für:
- XdevTextField
...
Examples:
BeanItem instanzieren
Code Block language java theme Confluence BeanItem<Products> product = new BeanItem<Products>(null);
Häufiger Anwendungsfall:
...
Selektierte Zeile aus XdevTable auslesen
Code Block language java theme Confluence BeanItem<Products> product = table.getSelectedItem();
Zuweisung:
...
Datensatz einem Formular zuweisen - Die Zuweisung erfolgt mit der Methode setItemDataSource.
Code Block language java theme Confluence fieldGroup.setItemDataSource(product);
Property
Eine Property kann nur einen einzelnen Wert (Datenfeld) aufnehmen.
Chai |
Model für:
- XdevTextField
- XdevPasswordField
- XdevInlineDateField
- XdevPopupDateField
- XdevNativeSelect
- XdevRichTextAreaInstanzierung:
...
Exmaples:
Property instanzieren
Code Block language java theme Confluence Property<String> productName = new ObjectProperty<String>("Chai");
Häufiger Anwendungsfall:
...
Datenfeld aus einer selektierten Zeile einer
...
XdevTable auslesen
Code Block language java theme Confluence Property<String> productName = product.getItemProperty("productname");
- Wert einem XdevTextField zuweisen
Zuweisung
...
mit der Methode setPropertyDataSource:
Code Block language java theme Confluence textField.setPropertyDataSource(productName);
...
Zuweisung mit der Methode setValue
...
:
...
Code Block language java theme Confluence textField.setValue(productName);
...
Workflow von Daten-Eingang bis Visualisierung