再谈 PVState 架构模式

Flutter 有众多的状态管理方案,我除了对 Provider 有一些了解外,其它的一概不熟悉,主要还是因为接触 Flutter 的时间太短。

我目前一直是用的原生的 setState,它已经能很好的满足我的需要了。并且它足够简单。我目前基于自己的业务场景似乎找不到任何去选用其它状态管理库的理由。

我一直认为对于一个库来讲,解决问题并保持简单好用是最重要的。如果背离了这个点,就很有可能导致过度设计。我见过一些人把我认为的最差实践当成了最佳实践,而他们却浑然不知。

当然使用 setState 时,也不是完全的裸用。我做了相当轻量级的封装,只有 110 行代码。我把它称为 PVState 架构模式。它既是一种和传统 MVC、MVP 平辈的架构模式,也是一个轻量级的状态管理方案。我们来一探究竟吧。

PVState 概念介绍

首先我封装了一个 BaseState,所有的 State 都直接或间接地继承了它。它的子类分为两种,P State 和 V State。P State 的全称是 Presenter State,它负责业务逻辑。V State 的全称是 View State,它负责 UI,主要是重写 build 方法建立数据和 Widget 的单向绑定关系。

它们的关系如图所示:

PVState 架构模式

这里有一个很重要的点是 V State 继承了 P State

原则上来讲,所有与业务逻辑相关的方法、变量、表达式均定义在 P State 中。所有与 UI 相关的东西比如约束布局的 id、颜色、buildXXX 系列方法均定义在 V State 中。由于两者的继承关系,V State 可以无缝地访问 P State 中定义的各种方法、变量、表达式。

当要更新 UI 时,只需要在 P State 中调用 setState 即可。业务逻辑和 UI 实现了完全解耦,同时保持了简单

由于这个架构模式很简单,相信你已经听懂了,接下来我们来分析一下我封装的源码。

PVState 源码分析

BaseState 的代码如下:

abstract class BaseState<T extends StatefulWidget> extends State<T> {
  static List<BasePagePStateMixin> pageStack = [];

  @override
  void initState() {
    super.initState();
    if (this is BasePagePStateMixin) {
      if (pageStack.isNotEmpty) {
        (pageStack.last).onPushNext();
      }
      pageStack.add(this as BasePagePStateMixin);
      scheduleMicrotask(() {
        (this as BasePagePStateMixin).onPush();
      });
    }
  }

  P? find<P extends BasePagePStateMixin>() {
    for (final element in pageStack.reversed) {
      if (element is P) {
        return element;
      }
    }
    return null;
  }

  @override
  void dispose() {
    super.dispose();
    if (this is BasePagePStateMixin) {
      (this as BasePagePStateMixin).onPop();
      int index = pageStack.indexOf(this as BasePagePStateMixin);
      pageStack.removeAt(index);
      if (index == pageStack.length - 1 && pageStack.isNotEmpty) {
        scheduleMicrotask(() {
          pageStack.last.onPopNext();
        });
      }
    }
  }
}

BaseState 目前做了两件事情,一是使用静态变量存储了所有的页面型 State,可以用来做路由栈监听,起到了 RouteAware 的作用。

什么是页面型 State 呢?这里我把 State 划分成了三种,分别是页面型 State、对话框型 State 和嵌入型 State。它们分别对应于整个页面的 StatefulWidget、整个对话框的 StatefulWidget 和嵌入到页面内的 StatefulWidget。原则上只有页面型 State 才有路由栈监听的能力,对吧?

不同型的 State 应继承不同型的 BaseState,源码如下:

abstract class BasePState<T extends StatefulWidget> extends BaseState<T> {
  @override
  Widget build(BuildContext context) {
    throw Exception('Do not call super.build()');
  }
}

/// For pages
abstract class BasePagePState<T extends StatefulWidget> extends BasePState<T>
    with BasePagePStateMixin {}

/// For dialogs
abstract class BaseDialogPState<T extends StatefulWidget> extends BasePState<T>
    with BaseDialogPStateMixin {}

/// For embedded widgets
abstract class BaseWidgetPState<T extends StatefulWidget> extends BasePState<T>
    with BaseWidgetPStateMixin {}

mixin BasePagePStateMixin {
  void onPush() {}

  void onPop() {}

  void onPushNext() {}

  void onPopNext() {}
}

mixin BaseDialogPStateMixin {}

mixin BaseWidgetPStateMixin {}

如图所示:

继承结构

此外,BaseState 还提供了 find 方法,用于在路由栈中向前查找 State,比如查找 AppState,进行一些全局的操作。这里可以使用 ValueNotifier 进行多页面的状态共享,我提供了简易方法:

ValueNotifier obs<V>(V? initialValue) {
  return ValueNotifier(initialValue);
}

最后,我提供了一个名为 Stateful 的通用 StatefulWidget,这样你就无需再为每一个 State 定义一个 StatefulWidget 了。源码如下:

class Stateful<T extends BasePState> extends StatefulWidget {
  final T state;
  final Map<String, dynamic>? arguments;

  static Stateful of<S extends BasePState>(
    S newState, {
    Key? key,
    Map<String, dynamic>? arguments,
  }) {
    return Stateful(
      key: key,
      state: newState,
      arguments: arguments,
    );
  }

  const Stateful({
    Key? key,
    required this.state,
    this.arguments,
  }) : super(key: key);

  @override
  State createState() {
    return state;
  }
}

使用方法如下:

void main() {
  runApp(Stateful.of(CounterVState()));
}

它还支持传参,用法如下:

void main() {
  runApp(Stateful.of(CounterVState(), arguments: {
    'initialCount': 0,
  }));
}
abstract class CounterPState extends BasePagePState<Stateful> {
  int count = 0;

  void add() {
    setState(() {
      count++;
    });
  }

  @override
  void initState() {
    super.initState();
    count = widget.arguments!['initialCount'];
  }
}

可以直接在 initState 中获取到参数。这里切记要为 BasePagePState 加上 Stateful 泛型参数。

计数器示例

最后看看用 PVState 架构模式实现的计数器的完整源码吧:

void main() {
  runApp(Stateful.of(CounterVState(), arguments: {
    'initialCount': 0,
  }));
}

abstract class CounterPState extends BasePagePState<Stateful> {
  late int count;

  void add() {
    setState(() {
      count++;
    });
  }

  @override
  void initState() {
    super.initState();
    count = widget.arguments!['initialCount'];
  }
}

class CounterVState extends CounterPState {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter Demo Home Page'),
        ),
        body: ConstraintLayout(
          children: [
            const Text(
              'You have pushed the button this many times:',
            ).applyConstraint(
              centerTo: parent,
            ),
            Text(
              '$count', // Direct access to count
              style: Theme.of(context).textTheme.headline4,
            ).applyConstraint(
              outBottomCenterTo: rId(0),
            ),
            FloatingActionButton(
              onPressed: add, // Widget and logic separation
              child: const Icon(Icons.add),
            ).applyConstraint(
              bottomRightTo: parent.rightMargin(20).bottomMargin(20),
            )
          ],
        ),
      ),
    );
  }
}

结束语

在我的实际使用中,我还为 BaseState 封装了一些其它的能力,比如 showLoading、showToast、sendRequest 等等。你也可以结合实际情况添加一些东西。架构模式的源码已开源到 https://github.com/hackware1993/Flutter_PVState

我是 hackware,关注我(公众号:FlutterFirst),一起成长!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容