Flutter Control is complex library to maintain App and State management.
Library merges multiple functionality under one hood. This approach helps to tidily bound separated logic into complex solution.
import 'package:control_core/core.dart';
Flutter Control Core
Control
Main static class. InitializesControlFactory
that serves as Service Locator with Factory and object initialization.ControlFactory
Is responsible for creating and storing givenfactories
andentries
. Then locating this services and retrieving on demand.
Factory has own Storage. Objects in this storage are accessible via custom key or Type. Best practice is to use Type as a key.ControlModule
holds all resources for custom extension. Factory will load thesemodules
and stores dependencies.
Control.initControl(
entries: {
CounterListControl: CounterListControl(),
},
factories: {
CounterModel: (_) => CounterModel(),
CounterDetailControl: (args) => CounterDetailControl(model: Parse.getArg<CounterModel>(args)),
},
modules: [
LocalinoModule(LocalinoOptions()),
],
initAsync: () async {
await loadAppConfig();
},
);
-
ControlModel
is base class to maintain Business Logic parts.
BaseControl
is extended version of ControlModel with more functionality. Mainly used for robust Logic parts.
BaseModel
is extended but lightweight version of ControlModel. Mainly used to control smaller logic parts.\ -
ControlObservable
andControlSubscription
are core underlying observable system and abstract base for other concrete robust implementations - mainly ActionControl and FieldControl.
WithControlBuilder
andControlBuilderGroup
on the Widget side (flutter_control
library). These universal builder widgets can handle all possible types of Notifiers. -
ActionControl
is one type of Observable used in this Library. It's quite lightweight and is used to notify listeners about value changes.
Has tree main variants - Single (just one listener), Broadcast (multiple listeners) and Empty (null).
4th variant is provider that subscribe to global BroadcastProvider.
On the Widget side isControlBuilder
to dynamically build Widgets. It's also possible to useControlBuilderGroup
to group values of multiple Observables.
Upon dismiss of ActionControl, everyControlSubscription
is closed.
final counter = ActionControl.broadcast<int>(0);
counter.subscribe((value) => printDebug(value));
void add() => counter.value++;
FieldControl
is more robust Observable solution aroundStream
andStreamController
. Primarily is used to notify Widgets and to provide events about value changes.
Can listenStream
,Future
or subscribe to another FieldControl with possibility to filter and convert values.
FieldControl comes with pre-build primitive variants asStringControl
,NumberControl
, etc., where is possible to use validation, regex or value clamping. And alsoListControl
to work with Iterables.
FieldSink
orFieldSinkConverter
provides Sink of FieldControl.
Upon dismiss of FieldControl, everyFieldSubscription
is closed.
final counter = FieldControl<int>(0);
counter.subscribe((value) => printDebug(value));
void add() => counter.value++;
Global Event System
ControlBroadcast
Event stream across whole App. Default broadcaster is part ofControlFactory
and is stored there.
Every subscription is bound to it'skey
andType
so notification to Listeners arrives only for expected data.
WithBroadcastProvider
is possible to subscribe to any stream and send data or events from one end of App to the another, even to Widgets and their States. Also custom broadcaster can be created to separate events from global/default stream.
BroadcastProvider.subscribe<int>('on_count_changed', (value) => updateCount(value));
BraodcastProvider.broadcast('on_count_changed', 10);