ChangeNotifier实现_Flutter在鸿蒙平台实现状态通知机制

作者付文龙红目香薰仓库地址https://gitcode.com/feng8403000/FlutterfromBeginnertoAdvancedForHarmonyOS.git联系邮箱372699828qq.com一、ChangeNotifier简介ChangeNotifier是Flutter自带的可监听对象继承自Listenable是Provider状态管理的核心数据模型。它提供了简单而强大的状态变化通知机制使得状态管理变得非常直观。1.1 ChangeNotifier的设计理念ChangeNotifier的设计理念非常简单当数据发生变化时通知所有监听者。这种设计模式被称为观察者模式Observer Pattern它将数据模型与UI组件解耦使得数据变化可以被多个组件同时监听。1.2 ChangeNotifier的优势特性说明轻量级仅100多行代码性能优秀简单易用API设计简洁易于理解和使用内置支持Flutter SDK自带无需额外依赖灵活扩展支持自定义监听逻辑二、ChangeNotifier核心特性2.1 继承ListenableChangeNotifier继承自Listenable接口提供了基本的监听管理能力addListener(VoidCallback listener)添加监听者removeListener(VoidCallback listener)移除监听者hasListeners检查是否有监听者2.2 notifyListeners()notifyListeners()是ChangeNotifier最核心的方法它会通知所有已注册的监听者数据已变化。当调用此方法时所有监听者的回调函数都会被执行。2.3 dispose()dispose()方法用于清理所有监听者防止内存泄漏。ChangeNotifierProvider会自动调用此方法无需手动管理。2.4 轻量级实现ChangeNotifier的实现非常轻量级主要包含以下几个部分一个列表存储所有监听者添加和移除监听者的方法通知所有监听者的方法清理监听者的方法classChangeNotifierimplementsListenable{ListVoidCallback??_listeners;overridevoidaddListener(VoidCallbacklistener){_listeners??[];_listeners!.add(listener);}overridevoidremoveListener(VoidCallbacklistener){_listeners?.remove(listener);}protectedvoidnotifyListeners(){if(_listeners!null){finallocalListenersListVoidCallback?.from(_listeners!);for(finallistenerinlocalListeners){listener?.call();}}}overridevoiddispose(){_listenersnull;}}三、创建ChangeNotifier数据模型3.1 基本结构创建ChangeNotifier数据模型的基本结构如下classCartProviderextendsChangeNotifier{// 私有字段存储状态数据ListCartItem_items[];double _discount0.0;// 公开getter暴露数据ListCartItemgetitems_items;doublegetdiscount_discount;intgetitemCount_items.length;// 计算属性计算派生数据doublegettotalPrice{return_items.fold(0.0,(sum,item)sumitem.price*item.quantity);}doublegetdiscountedPrice{returntotalPrice*(1-_discount);}// 操作方法修改数据并通知监听者voidaddItem(CartItemitem){_items.add(item);notifyListeners();}voidremoveItem(Stringid){_items.removeWhere((item)item.idid);notifyListeners();}voidupdateQuantity(Stringid,int quantity){finalindex_items.indexWhere((item)item.idid);if(index!-1){_items[index].quantityquantity;notifyListeners();}}voidsetDiscount(double discount){_discountdiscount.clamp(0.0,1.0);notifyListeners();}voidclearCart(){_items.clear();_discount0.0;notifyListeners();}}3.2 CartItem数据模型classCartItem{finalStringid;finalStringname;finaldouble price;int quantity;CartItem({requiredthis.id,requiredthis.name,requiredthis.price,this.quantity1,});CartItemcopyWith({String?id,String?name,double?price,int?quantity,}){returnCartItem(id:id??this.id,name:name??this.name,price:price??this.price,quantity:quantity??this.quantity,);}}四、ChangeNotifier使用要点4.1 私有字段与公开getterChangeNotifier的数据模型应该遵循以下原则字段通常设为私有以_开头通过getter暴露数据禁止外部直接修改这样可以确保数据修改只能通过方法进行便于管理和追踪classCartProviderextendsChangeNotifier{ListCartItem_items[];// 私有字段ListCartItemgetitems_items;// 公开getter}4.2 notifyListeners()的时机调用notifyListeners()的时机非常重要在所有数据修改完成后调用不要在循环中频繁调用批量修改时合并为一次调用voidaddMultipleItems(ListCartItemitems){_items.addAll(items);notifyListeners();// 在所有修改完成后调用}4.3 计算属性使用getter计算派生数据避免重复计算doublegettotalPrice{return_items.fold(0.0,(sum,item)sumitem.price*item.quantity);}doublegetdiscountedPrice{returntotalPrice*(1-_discount);}4.4 生命周期管理ChangeNotifierProvider会自动管理ChangeNotifier的生命周期创建Provider时自动创建ChangeNotifier实例Widget树销毁时自动调用dispose()方法ChangeNotifierProvider(create:(context)CartProvider(),// 创建实例child:constMyApp(),)五、批量更新优化5.1 优化前多次调用notifyListeners()voidaddMultipleItems(ListCartItemitems){for(variteminitems){_items.add(item);notifyListeners();// 不推荐每次循环都调用}}这种方式会导致多次UI重建影响性能。5.2 优化后批量修改后只调用一次voidaddMultipleItems(ListCartItemitems){_items.addAll(items);notifyListeners();// 推荐批量修改后只调用一次}这种方式可以减少UI重建次数提升性能。5.3 复杂操作的批量更新voidupdateCart(ListCartItemnewItems,double discount){_items.clear();_items.addAll(newItems);_discountdiscount;notifyListeners();// 一次调用多次修改}六、ChangeNotifier与其他方案对比6.1 ChangeNotifier vs StateNotifier方案复杂度学习曲线适用场景ChangeNotifier低低中小项目状态管理StateNotifier中中需要不可变状态的项目StateNotifier是Riverpod生态中的状态管理方案它强制使用不可变状态适合需要严格状态控制的项目。6.2 ChangeNotifier vs Bloc方案复杂度学习曲线适用场景ChangeNotifier低低中小项目状态管理Bloc高高复杂业务逻辑Bloc是一个基于流的状态管理方案适合处理复杂的业务逻辑和异步操作。七、高级用法7.1 自定义监听逻辑ChangeNotifier允许自定义监听逻辑例如只在特定条件下通知监听者classCartProviderextendsChangeNotifier{ListCartItem_items[];bool _shouldNotifytrue;voidaddItem(CartItemitem){_items.add(item);if(_shouldNotify){notifyListeners();}}voidpauseNotifications(){_shouldNotifyfalse;}voidresumeNotifications(){_shouldNotifytrue;notifyListeners();// 通知暂停期间的所有变化}}7.2 组合多个ChangeNotifier可以组合多个ChangeNotifier实现状态的分层管理classAppStateextendsChangeNotifier{finalCartProvidercartCartProvider();finalUserProvideruserUserProvider();finalThemeProviderthemeThemeProvider();voidupdateAll(){cart.notifyListeners();user.notifyListeners();theme.notifyListeners();notifyListeners();}}7.3 使用ValueNotifier管理单一值对于单一值的状态管理可以使用ValueNotifierfinalcounterValueNotifierint(0);// 使用ValueListenableBuilder监听变化ValueListenableBuilderint(valueListenable:counter,builder:(context,value,child){returnText(Count:$value);},);八、实际应用场景8.1 购物车状态管理classCartProviderextendsChangeNotifier{ListCartItem_items[];double _discount0.0;ListCartItemgetitems_items;doublegetdiscount_discount;intgettotalQuantity{return_items.fold(0,(sum,item)sumitem.quantity);}doublegettotalPrice{return_items.fold(0.0,(sum,item)sumitem.price*item.quantity);}doublegetdiscountedPrice{returntotalPrice*(1-_discount);}voidaddItem(CartItemitem){finalexistingItem_items.firstWhere((i)i.iditem.id,orElse:()item,);if(existingItemitem){_items.add(item);}else{existingItem.quantityitem.quantity;}notifyListeners();}voidremoveItem(Stringid){_items.removeWhere((item)item.idid);notifyListeners();}voidupdateQuantity(Stringid,int quantity){finalindex_items.indexWhere((item)item.idid);if(index!-1){if(quantity0){_items.removeAt(index);}else{_items[index].quantityquantity;}notifyListeners();}}voidsetDiscount(double discount){_discountdiscount.clamp(0.0,1.0);notifyListeners();}voidclearCart(){_items.clear();_discount0.0;notifyListeners();}}8.2 用户状态管理classUserProviderextendsChangeNotifier{User?_user;bool _isLoadingfalse;String?_error;User?getuser_user;boolgetisLoading_isLoading;String?geterror_error;FuturevoidfetchUser(StringuserId)async{_isLoadingtrue;_errornull;notifyListeners();try{_userawaitUserApi.fetchUser(userId);}catch(e){_errore.toString();}finally{_isLoadingfalse;notifyListeners();}}voidlogout(){_usernull;notifyListeners();}}8.3 主题状态管理classThemeProviderextendsChangeNotifier{bool _isDarkfalse;ThemeModegetthemeMode_isDark?ThemeMode.dark:ThemeMode.light;voidtoggleTheme(){_isDark!_isDark;notifyListeners();}ThemeDatagetthemeData{return_isDark?ThemeData.dark().copyWith(primaryColor:Colors.blue):ThemeData.light().copyWith(primaryColor:Colors.blue);}}九、常见问题与解决方案9.1 问题忘记调用notifyListeners()现象修改了数据但UI没有更新。解决方案确保在所有数据修改完成后调用notifyListeners()。voidaddItem(CartItemitem){_items.add(item);notifyListeners();// 不要忘记调用}9.2 问题在循环中频繁调用notifyListeners()现象性能问题UI卡顿。解决方案合并多次调用为一次。voidaddMultipleItems(ListCartItemitems){_items.addAll(items);notifyListeners();// 合并调用}9.3 问题内存泄漏现象应用内存占用持续增加。解决方案使用ChangeNotifierProvider自动管理生命周期不要手动创建ChangeNotifier实例。// 推荐ChangeNotifierProvider(create:(context)CartProvider(),child:constMyApp(),)// 不推荐finalcartCartProvider();// 手动创建容易忘记dispose9.4 问题并发修改导致状态不一致现象多个异步操作同时修改状态导致数据不一致。解决方案使用互斥锁或队列管理异步操作。classCartProviderextendsChangeNotifier{bool _isUpdatingfalse;finalListvoidFunction()_pendingUpdates[];FuturevoidupdateCart(ListCartItemnewItems)async{if(_isUpdating){_pendingUpdates.add(()updateCart(newItems));return;}_isUpdatingtrue;try{_itemsnewItems;notifyListeners();}finally{_isUpdatingfalse;if(_pendingUpdates.isNotEmpty){finalupdate_pendingUpdates.removeAt(0);update();}}}}十、总结ChangeNotifier是Provider状态管理的核心数据模型它提供了简单而强大的状态变化通知机制。通过合理使用ChangeNotifier可以实现高效的状态管理。在使用ChangeNotifier时需要注意以下几点使用私有字段和公开getter禁止外部直接修改数据在所有数据修改完成后调用notifyListeners()批量修改时合并多次调用为一次使用ChangeNotifierProvider自动管理生命周期对于复杂场景可以考虑使用StateNotifier或Bloc掌握ChangeNotifier的使用方法是学习Provider状态管理的基础。