DEPRECATED Ch9 Data Binding

No more, since Vaadin 8

Property

• Typed
• get/setValue()
• addValueChangeListener()
• built-in Properties
  • MethodProperty / NestedMethodProperty
  • ObjectProperty
• Connect property to Viewer / Editor
  • setPropertyDatasource()
  • ObjectProperty - simply implementation of Property that stores any Java object
• Converter & ConverterFactory
  • there is Application-wide converter factory
  • can expand default converter factory and register with application; see example
• Implementing Property interface

Item

• collection of properties identified by PID (property ID)
• usage: table (row), tree (node), form (field)
• built-in
  • PropertysetItem : manually adds name and Property
  • BeanItem : wrapping beans
  • add MethodProperty
  • add NestedMethodProperty
  • Form (implements Item)
  • events

Creating Forms

• FieldGroup – grouping fields and also provides buffering / validation; facility class, not UI
  • simple binding:
    1. form.addComponent(component)
    2. FieldGroup binder = new FieldGroup(item)
    3. binder.bind(component, "name")
       • bind(Field, “name”) - binds field UI with name of item source
    • buildAndBind(“Caption”, “name”) - build field UI with a factory and then bind the UI with the name of the item source; the UI is still needed to be added to a layout manually
    • bindMemberFields() - create bindings automatically, optionally use @PropertyId to annotate member
    • buffering – commit() runs validation and only write back to data source on success / discard()
    • setBuffered() - true by default
    • validation – Java Bean Validation with annotation; annotation / validation / localization of messages
    • BeanFieldGroup – for binding component field
• Extends CustomComponent

Container

• Basic usage
  • container.addContainerProperty("name", String.class, "none");
  • add items...
    • Object itemId = container.addItem() : get automatic ID and then set item
    • some container allow adding item by ID : Item item = container.addItem("agivenid"); then set the Item's properties
  • table.setContainerDataSource(container);
  • sub interfaces (Container.XXX)
    • Filterable
    • Hierarchical
    • Indexed – allow access by index number
    • Ordered
    • SimpleFilterable
    • Sortable
  • IndexedContainer (for table, allow ID)
  • BeanContainer
  • nested properties : addNestedContainerProperty()
  • if ID resolver is set by setBeanIdResolver() or setBeanIdProperty() : addBean(), addBeanAfter(), addBeanAt() and addAll() can be used then
• BeanItemContainer
  • each bean is wrapped in BeanItem
  • properties determined by automatically inspecting getter and putters
  • SQLContainer
  • JPAContainer (commercial)
  • HierarchicalContainer (for trees, allow ID)
• Iterating over container
  • getItemIds().iterator();
  • while iterating, cannot modify container
• Filterable containers
  • addContainerFilter(Filter)
  • Filter interface and built-in implementations
    • Atomic filter
      • defines a single condition
      • some built-in filters are provided
    • Composite filter
      • build on result based on other filters: AND OR NOT