Dart基础: 构造函数
Dart的构造函数比较变化多端, 我们可以在不同的场景下合理声明和调用一个class
的构造函数. 在实际开发过程中, 其实会遇到各种不同的情况, 需要我们合理使用构造函数. 因此我们需要对构造函数有充分的了解才可以做出合理的选择.
声明 & 调用
首先假设我们有一个class
如下
class Person {
int id;
int age;
String name;
}
--
直接指向变量名的声明方式
// 参数分别指向`Person`对应的变量, 都是必填项.
Person(this.id, this.age, this.name);
调用:
// 调用的时候, 函数参数没有形式参数名
var person = Person(0, 18, 'name_of_person');
这种情况下:
- 可以确保参数都有传入.
- 参数传入顺序和声明时候的顺序要保持一致.
- 在缺少参数的情况下会导致编译失败.
- 没有明确参数名称, 当参数较多的时候代码可读性不高.
--
可选参数声明方式1
/*
用花括号把可选参数包裹
同样是指向`Person`对应的变量, 都是可选参数.
*/
Person({this.id, this.age, this.name});
调用:
Person(id: 0, name: 'name_of_person', age: 18);
// 或
Person(id: 0);
// 或
Person(name: 'name_of_person');
这种情况下:
- 有明确的参数名称, 在参数较多的时候仍然可以保持较高可读性.
- 传入参数的顺序可以不固定, 只需要对应其参数名即可.
- 可以跳过部分参数不传入.
- 有导致对象初始化后部分变量为
null
.
--
可选参数声明方式2
// 用方括号把可选参数包裹
Person([this.id, this.age, this.name]);
调用:
Person();
// 或
Person(0, 18);
// 或
Person(0, 18, 'name_of_person');
这种情况下:
- 调用的时候不会显示参数名.
- 传参顺序必须按照声明顺序.
- 传参的时候不能跳过可选参数中间的某个参数, 比如上述例子, 不可以传入
id
和name
而跳过age
.
--
使用@required
关键字的可选参数声明方式:
// `id`参数被声明`@required`, 在调用的时候必须传入.
Person({@required this.id, this.name, this.age});
调用:
Person(id: 0, name: 'name_of_person')
// 如果不传`id`会引起编译警告
Person(age: 18, name: 'name_of_person')
这种情况下:
- 通过编译器警告提示使用者需要传入必须的参数.
- 只能修饰花括号声明方式下的可选参数.
- 仅有提示作用, 即使不传入参数也可以编译通过.
--
带默认参数的声明方式
// `name`的值默认为'unnamed'
Person({this.id, this.age, this.name = 'unnamed'});
这种情况下:
- 一个变量在没有传参的情况下, 初始化的值就是其默认值.
- 默认值的声明方式只可以用在可选型参数上.
- 默认值必须是静态的.
--
可选参数声明的方式看起来很美好, 但是它有一个局限性:
它可以绑定到class
的公共变量, 但是无法绑定私有变量.
那我们又想在构造函数里完成对私有变量的赋值, 又想把这个参数设置成可选的, 是不是就没有办法了?
这个问题是可以解决的, 下面将会提到.
--
以上几种声明方式可以混合使用:
Person(this.id, {@required this.age, this.name = 'unnamed'});
调用:
Person(0, age: 18);
Person(0, name: 'name_of_person', age: 18);
这种情况下:
- 在声明时必传参数必须都声明在前.
- 调用的时候, 传参顺序: 先按照必传参数的声明顺序传入, 然后才可以传可选型参数.
- 可选型参数的顺序可以任意.
--
我们可以发现, 以上几种声明方式都是在构造函数中直接把值绑定到class
的变量.
而这样调用构造函数, 我们必须在之前就把全部参数都处理完毕. 这样往往会导致我们每次创建一个对象前都先做一堆处理, 而我们很多时候并不希望这样.
我们更希望构造函数自身可以完成这些处理. dart其实也提供了这种声明方式:
Person(Map map)
: this.id = map['id'],
this.name = map['name'],
this.age = map['age'];
这样我们就可以通过传入一个Map
对象的方式实现Person
的初始化. 客户端和服务端数据请求之后对http响应数据做转换的时候, 我们面对的就是这种场景.
而上面提到过的私有变量作为可选参数的问题, 就可以通过这个声明方式解决. 假设我们增加一个私有变量_deposit
, 我们可以用这个形式做声明:
class Person {
int id;
int age;
String name;
int _deposit;
/*
其余几个参数会自动绑定, _deposit通过人为手动赋值, 实现required可选参数
*/
Person({
this.id,
this.age,
this.name,
@required int deposit,
}) : this._deposit = deposit;
}
--
而实际上, 有时候我们需要做的处理会更加复杂, 用上面这个方式做变量赋值就满足不了我们了. 这个时候我们还有一种声明方式:
Person(Map map) {
this.id = int.parse(map['id'].toString()) ?? 0;
this.age = int.parse(map['age'].toString()) ?? 0;
var nameInMap = map['name'];
this.name = nameInMap is String ? nameInMap : 'unnamed';
}
这种声明方式可以在构造函数中做较复杂的数据处理, 但是有一种情况下并不好使:
用final
修饰的变量
如果我们的Person
类型做出以下调整:
class Person {
final int id;
int age;
String name;
}
那么这个id
变量就无法在构造函数的函数体内做赋值操作, 我们只能通过之前的两种声明方式来对它赋值.
--
然后这个时候我们可能会碰到一个问题:
如果我们需要通过Map
对象的构造函数, 同时也需要直接传参的构造函数, 我们发现我们同时声明这两种函数, 会得到一个编译器的警告
The default constructor is already defined.
Try giving one of the constructors a name.
嗯, 对的. 我们上面说了那么多种声明方式, 在dart
语言里面, 都等于是声明了一个默认构造函数. 而实际上, 其实我们不另外声明构造函数的话, dart
确实就会给Person
提供一个构造函数.
调用dart
默认构造函数:
Person();
当我们需要同时拥有多个构造函数的时候, 我们需要使用别的方式.
就拿这个Map
的创建方式举例:
// 用`.` + 构造函数名 的方式声明构造函数
Person.fromMap(Map map)
: this.id = map['id'],
this.name = map['name'],
this.age = map['age'];
// 或者
Person.fromMap(Map map) {
this.id = int.parse(map['id'].toString()) ?? 0;
this.age = int.parse(map['age'].toString()) ?? 0;
var nameInMap = map['name'];
this.name = nameInMap is String ? nameInMap : 'unnamed';
}
调用方式:
// 用`.`的方式调起构造函数
Person.fromMap(someMap);
这种情况下:
- 参数声明的规则和默认构造函数的规则是一致的.
- 可以根据不同情况选用不同的构造函数.
- 对于
final
修饰的变量, 同样无法在构造函数的函数体内进行赋值.
选用原则
从上我们已经可以看出, dart
的构造函数声明方式有非常多种. 我的使用选择主要依从以下几个原则:
- 调用的时候一眼可以看出需要传递什么参数.
- 参数在2个以上的时候选择
@required
的显式参数. - 避免调用前需要做过多的数据处理, 直接传入其他类型, 在构造函数中做处理.
- 通过其他类型初始化的要使用有名字的构造函数.
- 通过直接变量赋值的使用默认构造函数.
更加简单地概括, 就是两个:
- 利用编译器和命名做尽量多的提示.
- 在构造函数中包揽尽量多的工作.