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 

Ein Container kann eine Liste mit beliebig vielen Datensätzen (BeanItems) aufnehmen. RapidClipse bietet mit dem XdevLazyEntityContainer und dem XdevBeanItemContainer 2 verschiedene Container-Varianten.

Image Removed

...

Der XdevBeanItemContainer ist der Standard Daten-Container für benutzerdefinierte Queries. 

• Bietet kein vollautomatisiertes Lazy-Loading zwischen Datenbank und Server, 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) möglich.
• Wird von RapidClipse verwendet, wenn bei einer UI-Komponente in den Properties Entity > Data > findAll selektiert ist.
  Image Removed

Summary:

...

table.setContainerDataSource(productContainer);

...

• XdevTable
• XdevComboBox
• XdevListSelect
• XdevTwinColSelect
• XdevTree
• XdevTreeTable

...

XdevBeanItemContainer<Product> productContainer = table.getContainerDataSource();

Examples:

Abfrageergebnis in XdevBeanItemContainer speichern

...

GUI-Komponente wie die Grid oder der Binder können programmatisch mit einem Entity verknüpft werden.

Liste an GUI-Komponente, welche Databinding benötigen:

• Grid
• Binder
• CheckboxGroup
• RadioButtonGroup
• ComboBox
• Select
• ListBox

Databinding mit CheckboxGroup, RadioButtonGroup, ComboBox, Select oder ListBox:

• Zuerst muss die Komponente typisiert werden, dazu im GUI-Builder die Komponente anwählen und dann in den Properties auf Property > Object > Type Arguments klicken z.B. java.lang.String
• Im folgenden Dialog den Typ auswählen, welchen Sie anzeigen wollen.
• Danach können Sie auswählen, welche Information pro Eintrag angezeigt werden soll. 

Um die Komponente jetzt zu befüllen, können Sie folgenden Code schreiben:

...

ProductDAO selectProducts = new ProductDAO();
List<Product> productList = selectProducts.findAll();

...

this.theComponent.setItems(myListWithItems);

Im Hintergrund erstellt Vaadin dann für die übergebene Liste einen DataProvider. Wenn ein Element also in der Liste geupdated wird, muss diese dann auch der DataProvider geupdated werden:

...

XdevBeanItemContainer<Product> productContainer = new XdevBeanItemContainer<Product>(Product.class); 
productContainer.addAll(productList);

Primary-Keys - Gibt eine Liste (Collection) aller Primary-Keys zurück.

Collection<?> itemIds = table.getContainerDataSource().getItemIds();

...

this.theComponent.getDataProvider().refreshItem(itemFromTheListThatChanged);

Falls Sie ein Element löschen oder neu hinzufügen, müssen Sie die refreshAll-Methode aufrufen:

...

this.theComponent.getDataProvider().refreshAll();

...

XdevBeanItemContainer leeren

table.getContainerDataSource().removeAll();

...

Der XdevLazyEntityContainer wird nur von RapidClipse verwendet, wenn bei einer UI-Komponente in den Properties Entity > Auto query data selektiert ist.

Image Removed

• 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. 

...

Summary:

...

BeanItem<Product> itemDataSource = fieldGroup.getItemDataSource();

...

• XdevFieldGroup

...

setItemDataSource

...

BeanItem einer UI-Komponente zuweisen

...

fieldGroup.setItemDataSource(product);

Model für:

• XdevFieldGroup

Examples:

BeanItem instanzieren

Mit getValue() können Sie nach den ausgewählte(n) Elemente abfragen.

Databinding mit Binder:

Dafür einfach ein Entity per Drag and Drop auf den GUI-Builder ziehen. Danach öffnet sich ein Dialog, wo Sie die Attribute auswählen können, die angezeigt werden sollen.

Ein Entity kann jetzt wie folgt gebunden werden:

this.binder.writeBean(myBean);

Jetzt sind die Werte des Beans in die Felder des Binders übertragen worden.

Die Werte können jetzt wie folgt wieder geholt werden:

...

Selektierte Zeile aus XdevTable auslesen

BeanItem<Product> product = table.getSelectedItem();

...

...

BeanItem<Product> product = new BeanItem<Product>(null);

this.binder.readBean(myBean);

Databinding mit Grid:

Das Grid lässt sich ähnlich wie CheckboxGroup etc. binden. Zuerst das Entity per Drag and Drop in den GUI-Builder ziehen. Danach öffnet sich aber ein komplexerer Dialog. Dort können Sie die Attribute auswählen, die angezeigt werden sollen. Sie können aber auch Column per Code einfügen wie folgt:

Property

Eine Property kann nur einen einzelnen Wert (Datenfeld) aufnehmen.   

...

Summary:

...

Property<?> propertyDataSource = this.label.getPropertyDataSource();

...

• XdevTextField
• XdevPasswordField
• XdevInlineDateField
• XdevPopupDateField
• XdevNativeSelect
• XdevRichTextArea 
  
• XdevLabel
• XdevCheckBox

...

setPropertyDataSource

...

Wert einer UI-Komponente zuweisen.

...

label.setPropertyDataSource("text");

Model für: 

• XdevTextField
• XdevPasswordField
• XdevInlineDateField
• XdevPopupDateField
• XdevNativeSelect
• XdevRichTextArea 
  
• XdevLabel
• XdevCheckBox

Exmaples: 

Property instanzieren 

...

fieldGroup.setItemDataSource(product);

this.grid.addColumn(Customer::getAddress).setHeader("Addressen").setAutoWidth(true);

Es müssen aber nicht Methoden des Entities genutzt werden:

...

Property<String> productName = new ObjectProperty<String>("Chai");

...

Datenfeld aus einer selektierten Zeile einer XdevTable auslesen

Property<String> productName = product.getItemProperty("productname");

...

• 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

Image Removed

...

this.grid.addColumn(customer -> "Address is: " + customer.getAddress()).setHeader("Addressen").setAutoWidth(true);

Die Items, sowie das Refreshen des Dataproviders ist identisch zu der CheckboxGroup etc.