简单状态管理器
GetxController
有一个 update 方法,用于触发更新操作。
类似于 ChangeNotifier 中的 notifyListeners 方法
源码
abstract class GetxController extends DisposableInterface
with ListenableMixin, ListNotifierMixin {
void update([List<Object>? ids, bool condition = true]) {
if (!condition) {
return;
}
if (ids == null) {
refresh();
} else {
for (final id in ids) {
refreshGroup(id);
}
}
}
}
@protected
void refresh() {
assert(_debugAssertNotDisposed());
/// This debounce the call to update.
/// It prevent errors and duplicates builds
// if (_microtask == _version) {
// _microtask++;
// scheduleMicrotask(() {
// _version++;
// _microtask = _version;
_notifyUpdate();
// });
// }
}
// 从 _updaters 取出所有的回调函数,一一执行
void _notifyUpdate() {
for (var element in _updaters!) {
element!();
}
}
GetBuilder
初始化的时候,会向 Controller 添加回调函数(订阅),这个回调函数的作用就是 setState 更新当前 GetBuilder 组件。
部分源码
class GetBuilderState<T extends GetxController> extends State<GetBuilder<T>>
with GetStateUpdaterMixin {
T? controller;
@override
void initState() {
super.initState();
controller = widget.init;
_subscribeToController();
}
// 向 controller 添加当前 GetBuilder 的一个回调
void _subscribeToController() {
_remove?.call();
_remove = (widget.id == null)
? controller?.addListener(
_filter != null ? _filterUpdate : getUpdate,
)
: controller?.addListenerId(
widget.id,
_filter != null ? _filterUpdate : getUpdate,
);
}
...
}
mixin GetStateUpdaterMixin<T extends StatefulWidget> on State<T> {
void getUpdate() {
if (mounted) setState(() {});
}
}
添加订阅的方法是在 GetxController 中,即向绑定的 controller 的 _updaters 列表中添加当前 GetBuilder 的回调,以便 controller 执行 update() 方法时,通过此回调更新当前 GetBuilder
相关源码
@override
Disposer addListener(GetStateUpdate listener) {
assert(_debugAssertNotDisposed());
_updaters!.add(listener);
return () => _updaters!.remove(listener);
}
使用示例:
代码
class Controller extends GetxController {
int counter = 0;
void increment() {
counter++;
update(); // 当调用增量时,使用update()来更新用户界面上的计数器变量。
}
}
// 在你的Stateless/Stateful类中,当调用increment时,使用GetBuilder来更新Text。
GetBuilder<Controller>(
init: Controller(), // 首次启动
builder: (_) => Text(
'${_.counter}',
),
)
在 GetBuilder 之外可以通过 Get.find() 获取,但是无法在值变化时自动更新当前组件
class Controller extends GetxController {
/// 你不需要这个,我推荐使用它只是为了方便语法。
/// 用静态方法:Controller.to.increment()。
/// 没有静态方法的情况下:Get.find<Controller>().increment();
/// 使用这两种语法在性能上没有区别,也没有任何副作用。一个不需要类型,另一个IDE会自动完成。
static Controller get to => Get.find(); // 添加这一行
int counter = 0;
void increment() {
counter++;
update();
}
}
FloatingActionButton(
onPressed: () {
Controller.to.increment(),
}
child: Text("${Controller.to.counter}"),
),
注:通过 Get.find() 获取,并且需要监听值更新,可以使用 Obx
Obx(() => Text("${controller.name}"));
使用技巧
为 GetBuilder 定义 id,controller 中可以根据 id 进行更新
GetBuilder<Controller>(
id: 'text', //这里
init: Controller(), // 每个控制器只用一次
builder: (_) => Text(
'${Get.find<Controller>().counter}', //here
),
),
update(['text']);
// 还可以设置另外的条件
update(['text'], counter < 10);
响应的状态管理器
区别:不需要在 controller 中执行 update() 方法,相关组件也会自动更新
将变量或对象变成可观察的 observable
示例:
final name = ''.obs;
final isLogged = false.obs;
final count = 0.obs;
final balance = 0.0.obs;
final number = 0.obs;
final items = <String>[].obs;
final myMap = <String, int>{}.obs;
// 自定义类 - 可以是任何类
final user = User().obs;
使用 Getx 监听相关变量 observer
示例:
// 视图
GetX<Controller>(
builder: (controller) {
print("count 1 rebuild");
return Text('${controller.count1.value}');
},
),
更新 observable 变量
可以直接更新,也可以调用 obs变量的 update 方法进行局部更新
示例:
// 使用 value 去更新
controller.count.value++
// model
// 我们将使整个类成为可观察的,而不是每个属性。
class User{
User({this.name = '', this.age = 0});
String name;
int age;
}
// controller
final user = User().obs;
//当你需要更新user变量时。
user.update( (user) { // 这个参数是你要更新的类本身。
user.name = 'Jonny';
user.age = 18;
});
// 更新user变量的另一种方式。
user(User(name: 'João', age: 35));
// view
// 可以不使用.value来访问模型值。
user().name;
2333
