// routing_provider.dart — 可配置分流档案(GET/POST /v1/me/routing)状态层。 // // 仿 account_providers.dart:DevicesNotifier 的 AsyncNotifier + invalidateSelf 范式, // 但变更类操作(addRule/removeRule/reorder/setMode)采用「本地乐观更新 → 落盘」: // 先改 state 再 saveRoutingProfile,失败则把 state 还原到变更前并 rethrow(不静默吞, // 由调用方 catch 后提示用户;仿 DevicesNotifier.remove/rename 等「失败即抛」范式)。 // // 注:不用 `state = AsyncError(...).copyWithPrevious(...)` 手动挂错误 —— // Riverpod AsyncNotifier 的 `state=` setter 内部 asyncTransition() 总会用 // **当前已存的 state**(此时已是乐观更新后的 next)重新 copyWithPrevious 一次, // 会把我们想还原的旧值又覆盖回 next,达不到「回退」效果。故失败时直接整体 // `state = AsyncData(previous)`(纯回退,无错误标记)+ rethrow 传递异常。 import 'dart:async'; import 'package:flutter_riverpod/flutter_riverpod.dart'; import '../models/routing_profile.dart'; import 'account_providers.dart'; import 'auth_provider.dart'; import 'connection_provider.dart'; /// 当前账户的分流档案。未登录返回默认档案(不打后端)。 class RoutingProfileNotifier extends AsyncNotifier { @override Future build() async { final auth = ref.watch(authProvider); if (!auth.isLoggedIn) return const RoutingProfile(); return ref.read(accountApiProvider).routingProfile(); } /// 显式保存当前 state(供批量编辑后统一保存的场景;单条变更类方法已自带保存)。 Future save() async { final profile = state.valueOrNull; if (profile == null) return; await _persist(profile, previous: profile); } /// 切换分流模式(rule/global/direct)。 Future setMode(String mode) => _mutateAndSave((p) => p.copyWith(mode: mode)); /// 切换内置分流开关。 Future setBuiltin(Builtin builtin) => _mutateAndSave((p) => p.copyWith(builtin: builtin)); /// 追加一条自定义规则(默认追到末尾,规则命中顺序 = 列表顺序)。 Future addRule(RoutingRule rule) => _mutateAndSave((p) => p.copyWith(rules: [...p.rules, rule])); /// 删除第 index 条规则。 Future removeRule(int index) => _mutateAndSave((p) { final rules = [...p.rules]..removeAt(index); return p.copyWith(rules: rules); }); /// 替换第 index 条规则(如切换 enabled / 编辑字段)。 Future updateRule(int index, RoutingRule rule) => _mutateAndSave((p) { final rules = [...p.rules]; rules[index] = rule; return p.copyWith(rules: rules); }); /// 拖拽排序(语义对齐 Flutter `ReorderableListView.onReorder`:newIndex 是移除 /// oldIndex 之前的目标下标)。 Future reorder(int oldIndex, int newIndex) => _mutateAndSave((p) { final rules = [...p.rules]; var target = newIndex; if (oldIndex < newIndex) target -= 1; final item = rules.removeAt(oldIndex); rules.insert(target, item); return p.copyWith(rules: rules); }); /// 重置为出厂默认档案(模式/内置开关/自定义规则/final 全部还原),但保留当前只读的 /// [RoutingProfile.systemLockedDomains] 回显不丢——它不是用户可改的档案内容,只是 /// 服务端下发的账户相关信息,与「重置」无关。复用 [_mutateAndSave]/[_persist]: /// 乐观更新 + 失败回滚 rethrow + 存成功后连接态 on 则自动重连,同 addRule。 Future resetToDefault() => _mutateAndSave( (p) => RoutingProfile.defaults().copyWith(systemLockedDomains: p.systemLockedDomains), ); Future _mutateAndSave(RoutingProfile Function(RoutingProfile) transform) async { final prev = state.valueOrNull ?? const RoutingProfile(); final next = transform(prev); state = AsyncData(next); // 乐观更新,UI 立即反映 await _persist(next, previous: prev); } /// 落盘;失败回退 state 到 [previous] 并 rethrow(不静默吞,由调用方 catch 提示)。 Future _persist(RoutingProfile profile, {required RoutingProfile previous}) async { try { await ref.read(accountApiProvider).saveRoutingProfile(profile); } catch (_) { state = AsyncData(previous); rethrow; } _reconnectIfConnected(); // Task 9:保存成功且已连接 → 重连使新规则生效 } /// 用 ref.read(非 watch)单向读取 connectionProvider:仅本 notifier 在保存成功后 /// 顺带触发一次重连,不建立「connectionProvider 依赖 routingProfileProvider」的反向 /// 引用,provider 依赖图仍是单向(routing → connection),不成环。off 态不触发—— /// 下次连接本就会按最新档案渲染配置。重连失败由 connection_provider 自身状态承接 /// (沿用其既有错误提示),不 rethrow 到这里,不影响「保存」这个操作本身的成败。 void _reconnectIfConnected() { if (ref.read(connectionProvider).phase == VpnPhase.on) { unawaited(ref.read(connectionProvider.notifier).reapplyRoutingProfile()); } } } final routingProfileProvider = AsyncNotifierProvider(RoutingProfileNotifier.new);