[Feature] Introduce Binding DSL

nbrugger-tgm commented 3 years ago

Why introducing now?

It is a breaking change as the API will be completely different, and as the switch to V4 (modularization) already contains many major changes and reworks it is better to release now than later.

What would the DSL (Domain Specific Language) look like?

Not specified yet, something like

public createBindings(ReactiveBinder<Person> binder){
    binder.call(textfield::setText).with(Person::getName);
    binder.call(Person::setName).with(textfield::getText).when(textChanges(textfield));

    //or
    binder.bind(textfield::setText).to(convert(Person::getAge).with(Integer::toString));

    //binder
    binder.set(textfield:setText).to(Person::getName);
}

Operations

[x] Converting
[x] Method reference use
[x] Reacting to Model property changes
[x] Conditional bindings
[x] ~dual-way bindings~ (not required anymore due to DSL structure)

Concept : Lists

(Most likely needs an internal diff operation)

binder.list(Person::getAddresses)
    .onAdd(addressPanel::add)
    .onRemove(addressPanel::remove)
    .useComponent(AddressView::new)

~List as Model~
~List as Property of Model~
[x] List Diff
[x] List Diff compliant proxy

Further requirements

[x] Unit-test coverage > 95%
[x] Every public method documented

nbrugger-tgm commented 3 years ago

Grammer/syntax design:

binding_dsl

The white triangles are the entry points

nbrugger-tgm commented 3 years ago

Progress

The DSL syntax has changed quite a bit

All functionality is implemented

Missing

[ ] Documentation
[x] Unit Test Cases

nbrugger-tgm commented 3 years ago

Status update

https://github.com/nbrugger-tgm/reactj/pull/49#issuecomment-945280768

nbrugger-tgm commented 3 years ago

Blocked by #53

nbrugger-tgm commented 3 years ago

Requirement

All "nodes" of the DSL should be extenable/expandable by users so new methods may be added by 3rd party code.

handled in #53

nbrugger-tgm commented 2 years ago

With completion of #53 and #44 #54 a big leap was done.

The DSL is completed and implemented for all modules, the missing thigs that will be implemented in #49 are

[x] > 70% coverage
[x] > 85% coverage
[x] JavaDoc for all new interfaces in API module
[x] Fixing the 100rd minors/issues/codesmells

nbrugger-tgm / reactj