空安全：
Dart从2.12版本开始支持了空安全，通过空安全开发人员可以有效避免null错误崩溃。空安全性可以说是Dart语言的重要补充，它通过区分可空类型和非可空类型进一步增强了类型系统。
引入空安全的好处
- 可以将原本运行时的空值引用错误将变为编辑时的分析错误；
- 增强程序的健壮性，有效避免由Null而导致的崩溃；
- 跟随Dart和Flutter的发展趋势，为程序的后续迭代不留坑；
空安全最小必备知识：
- 空安全的原则
- 引入空安全前后Dart类型系统的变化
- 可空（?）类型的使用
- 延迟初始化（late）的使用
- 空值断言操作符（!）的使用
/// 在使用了空安全的Flutter或Dart项目中你会经常看到?.、!、late的大量应用
class CommonModel {
String? firstName; //可空的成员变量
int getNameLen(String? lastName /*可空的参数*/) {
int firstLen = firstName?.length ?? 0;
int lastLen = lastName?.length ?? 0;
return firstLen + lastLen;
}
}
// !还有一个常见的用处：
bool isEmptyList(Object object) {
// if (!(object is List)) return false;
if (object is! List) return false;
return object.isEmpty;
}
当程序启用空安全后，类的成员变量默认是不可空的，所以对于一个非空的成员变量需要指定其初始化方式：
class CommonModel {
List names=[];//定义时初始化
final List colors;//在构造方法中初始化
late List urls;//延时初始化
CommonModel(this.colors);
}
Widget的空安全适配
- 可空的属性：通过?进行修饰
- 不可空的属性：在构造函数中设置默认值或者通过required进行修饰
class WebView extends StatefulWidget {
String? url;
final String? statusBarColor;
final String? title;
final bool? hideAppBar;
final bool backForbid;
WebView(
{this.url,
this.statusBarColor,
this.title,
this.hideAppBar,
this.backForbid = false})
}
State的空安全适配
State的空安全适配主要是根据它的成员变量是否可空进行分类：
- 可空的变量：通过?进行修饰
- 不可空的变量：可采用以下两种方式进行适配
定义时初始化
使用late修饰为延时变量
class _TravelPageState extends State<TravelPage> with TickerProviderStateMixin {
late TabController _controller; //延时初始
List<TravelTab> tabs = []; //定义时初始化
...
@override
void initState() {
super.initState();
_controller = TabController(length: 0, vsync: this);
...
}}
数据模型Model空安全适配。
数据模型（Model）空安全适配主要以下两种情况：
- 含有命令构造函数的模型
- 含有命名工厂构造函数的模型
///旅拍页模型
class TravelItemModel {
late int totalCount;
List<TravelItem>? resultList;
//命名构造方法
TravelItemModel.fromJson(Map<String, dynamic> json) {
totalCount = json['totalCount'];
if (json['resultList'] != null) {
resultList = new List<TravelItem>.empty(growable: true);
json['resultList'].forEach((v) {
resultList!.add(new TravelItem.fromJson(v));
});
}
}
Map<String, dynamic> toJson() {
final Map<String, dynamic> data = new Map<String, dynamic>();
data['totalCount'] = this.totalCount;
data['resultList'] = this.resultList!.map((v) => v.toJson()).toList();
return data;
}
}
- 对于一定会下发的字段我们通过late来修饰为延迟初始化的字段以方便访问
- 对于不能保证一定会下发的字段，我们通过?将其修饰为可空的变量
含有命名工厂构造函数的模型
class CommonModel {
final String? icon;
final String? title;
final String url;
final String? statusBarColor;
final bool? hideAppBar;
CommonModel(
{this.icon, this.title, required this.url,
this.statusBarColor, this.hideAppBar});
//命名工厂构造函数必须要有返回值，类似static 函数无法访问成员变量和方法
factory CommonModel.fromJson(Map<String, dynamic> json) {
return CommonModel(
icon: json['icon'],
title: json['title'],
url: json['url'],
statusBarColor: json['statusBarColor'],
hideAppBar: json['hideAppBar']
);
}
}
- 对于可空的字段通过?进行修饰
- 对于不可空的字段，需要在构造方法中在对应的字段前面添加required修饰符来表示这个参数是必传参数
单例的空安全适配。
class HiCache {
SharedPreferences? prefs;
static HiCache? _instance;
HiCache._() {
init();
}
HiCache._pre(SharedPreferences prefs) {
this.prefs = prefs;
}
static Future<HiCache> preInit() async {
if (_instance == null) {
var prefs = await SharedPreferences.getInstance();
_instance = HiCache._pre(prefs);
}
return _instance!;
}
static HiCache getInstance() {
if (_instance == null) {
_instance = HiCache._();
}
return _instance!;
}
void init() async {
if (prefs == null) {
prefs = await SharedPreferences.getInstance();
}
}
setString(String key, String value) {
prefs?.setString(key, value);
}
setDouble(String key, double value) {
prefs?.setDouble(key, value);
}
setInt(String key, int value) {
prefs?.setInt(key, value);
}
setBool(String key, bool value) {
prefs?.setBool(key, value);
}
setStringList(String key, List<String> value) {
prefs?.setStringList(key, value);
}
remove(String key) {
prefs?.remove(key);
}
T? get<T>(String key) {
var result = prefs?.get(key);
if (result != null) {
return result as T;
}
return null;
}
}
核心适配的地方主要有两点：
- 因为是懒汉模式的单例，所以单例instance设置成可空
- getInstance中因为会有null时创建单例，所以返回instance时将其转换成非空
空安全适配常见问题。
type 'Null' is not a subtype of type 'String'.
导致此问题的主要原因将一个null值传递给了一个不能为null的参数，常见在使用model时.
解决方案
- 如果控制台有输出具体报错行数，则可以跳转到具体的代码行进行解决
- 如果控制台没有出入具体的代码行数，则可以通过debug方式在代码的catch或catchError节点下打个断点，然后当查看catch中具体的报错信息
