Dart 学习笔记

阅读 language-tour 时做的一些笔记。
Important concepts
- Dart 中一切皆对象,除了 null 之外,所有对象都继承自 Object
- Dart 是强类型语言,但是类型标注是可选的,因为 Dart 中存在类型推断的机制,使用
var关键字后编译器可以推断出具体的类型 - 当开启了空安全(dart ≧ v2.12)之后,对于可为空的值必须明确指出(用
?),可为空的值转换成不为空的值时使用! - 当需要接收任意对象时使用
Object? - Dart 支持泛型,比如
List<int> - Dart 支持顶层函数和局部函数,同样也支持顶层变量
- 标识符可以以字母或者
_开头,Dart 中_开头的方法表示私有方法 - Dart 中也分为表达式 expressions 和声明 statements,表达式有返回值而声明无返回值
- Dart 工具提供了两种类型的问题:警告和错误。警告表示代码可能无法正确执行,错误分为编译期错误和运行时错误,编译期错误会导致程序无法执行,而运行时错误是代码执行过程中抛出的异常。
Variables
1 | |
变量保存了引用,上面的例子中,name 变量包含了一个引用,该引用指向了一个值为 Bob 的 String 对象。
当使用 var 关键字时,变量的类型可以自动被推断出来,当然你也可以显式指出对象的类型。除此之外,如果你不想限定变量的类型,则可以使用 Obejct 或者 dynamic。
默认值
如果没有开启空安全 (dart ≧ v2.12),则所有未被初始化的变量都会被初始化为 null,哪怕是数字型的变量,因为 Dart 中一切都是对象。但是,如果开启了空安全,则所有不可为空的变量会被要求先初始化才能使用。
Late 变量
Dart 2.12 之后添加了 late 修饰符,主要有两种用途:
- 声明不可为空的顶层变量或者成员变量而不直接初始化值
- 延迟初始化变量(使用到时才初始化)
第一种情况很好理解,因为如果开启了空安全,则顶层变量和成员变量必须要在声明的同时进行初始化,否则编译期无法保证空安全,所以引进 late 之后表明我们不想立马初始化该变量,但是它会在稍后被初始化。
第二种情况则适用于,一个变量对于程序来说是非必须的,或者性能消耗比较大,则可以用 late 修饰,这样,只有在使用到该变量时程序才会初始化它。比如:
1 | |
final 和 const
final 修饰的变量只能被赋值一次,并且 final 修饰的顶层变量会在第一次被使用时初始化。
1 | |
const 变量是编译期常量(同时也是 final 的)。如果 const 修饰的是成员变量,则需要用 static const。
1 | |
final 和 const 的不同之处在于,final 修饰的对象不能被修改,但是其属性可以被修改;而 const 修饰的对象和属性都不能被修改,它们是不可变的。
Build-in types
Numbers
int 和 double 都是 num 的子类,num 类型的数据包含了基本的操作符,比如加减乘以及 abs(), ceil(), floor(), 位运算等。
Strings
- Dart 中使用 String 可以用单引号或者双引号。不过,在单引号中的 String 对象中需要对
'进行转义。 - 我们可以使用
${expression}在 String 中引用变量或者表达式。 - 我们可以用
==比较两个 String 的值是否一致。 - 我们可以在 String 值之前加
r来表示原始类型 (raw) 的 String,这样就不需要转义。 - 我们可以使用三个单引号或者双引号来创建多行 String,同样不需要在其中使用转义符。
- 我们可以使用字符相乘,但是字符必须在乘数系数的左边,如
🔥 * 3。 - 我们可以使用字符填充方法,比如
paddingLeft和paddingRight。
Booleans
Dart 中使用 bool 表示布尔类型的值。
Lists
Dart 中数组是用 List 表示的。可以用如下的方式创建数组:
1 | |
Dart 2.3 之后添加了扩展运算符 (...) 和空值敏感的扩展运算符 (...?):
1 | |
Dart 3.8 之后添加了 null-aware elements,我们在集合中判断元素是否为空的写法变得更简洁:
1 | |
Dart 中还有提供了集合 if 和集合 for 的操作:
1 | |
关于其它常见的 API 见 collections。
Sets
Dart 中同样用 Set 类型表示无序且唯一的集合。
1 | |
Set 和 List 一样,支持扩展运算符、集合 if 和集合 for 的操作。
Maps
Map 是包含了 key 和 value 集合,其中 key 必须唯一。Dar 中的 Map 同样使用花括号 {} 表示,而且优先级比集合 Set 更高:
1 | |
Records
Records 是 Dart 3.0 之后新添加的数据类型,它可以让我们更灵活地操作数据。它的语法很简单,用一个圆括号包起来的数据类型,如下:
1 | |
以上创建的变量初看有点乱,其实是四部分的数据组成的,每部分由,分割,因此一共代表 4 个参数,每个参数可以有自定义的参数名,也可以省略。因此,我们可以这样访问这个变量中的各个部分:
1 | |
可以看到,变量中省略命名的部分,我们可以使用 $ + 下标来访问。不过,特殊的地方在于,只有不具名的参数才会自动生成下标,而且下标是从 1 开始的。
Record types
下面来看下如何确定一个 Record 的类型。在同一个作用域内使用 Record 的时候通常可以省略类型,但是有时候我们不确定会在哪里使用到我们定义好的 Record,所以就需要定义 Record 类型。由于每个 Record 内部可以有多个数据类型,因此它的“形状” (shape) 是由它内部的数据类型及其具名参数来共同决定的。
我们可以不给参数命名,此时 Record 中出现的参数就是可选位置参数,比如:
1 | |
上面这个变量它的类型就是 (String, int),我们可以给它内部的数据类型添加可选的名字:
1 | |
这样一来,我们就知道了上面这个方法返回的 Record 的数据类型是是字符串+ int 的组合,并且代表的含义是名字和数量。
不过,可选参数的命名完全是标记性质的,只是为了方便阅读代码,并不会改变它的实际类型。
1 | |
如上所示,groupA 和 groupB 的类型注解看似不同,但实际上都表示 (String, int),因此当它们内部数据的值相等时,它们也被判定为相等,我们甚至可以将 groupA 的值赋给 groupB。
Named fields
在定义 Record 类型时,我们也可以为其内部的数据类型添加固定参数名,也叫具名参数:
1 | |
如上面的例子所示,假如使用显式的 Record 类型注解,那么只需要用大括号将具名参数包起来就可以了,而且具名参数必须位于可选位置参数之后。这点和 Record 表达式不同,因为表达式中并没有这种限制。
我想,这种设计可能是为了防止使用时出现混乱吧。因为当我们为一个类型注解添加具名参数之后,可选位置参数就可以使用下标进行访问,从 1、2、3… 开始,对应的就是 Record 中第 1、2、3… 个数据,而之后的具名参数可以直接通过对应的名字访问,这样就能避免在 Record 内部有一长串数据时使用出错。
除此之外,具名参数还有一个关键的不同,它也属于类型注解的一部分,也就是说它也参与决定了 Record 的“形状”。
1 | |
以上两个变量,recordAB 和 recordXY 的数据类型并不相同。
Restructure
Record 类型的值也支持解构语法,如下:
1 | |
需要注意的是,可选位置参数是以出现顺序来结构的,比如:
1 | |
此时,具名参数的解构不需要担心顺序的问题,但是,可选位置参数则是根据参数的出现顺序来依次解构的。
Runes and grapheme clusters
Dart 中,使用 Runes 表示字符串的 Unicode 字符集。我们可以使用 characters 包下的类来操作字符。
1 | |
Dart 中的字符串使用 UTF-16 编码,如果要用字符串表示 Unicode 字符则需要使用 \uXXXX 的语法。
1 | |
Symbols
Dart 中使用 Symbol 对象表示操作符或者标识符,用 # + 修饰符表示。
Functions
Dart 中一切都是对象,函数的类型用 Function 表示,而且函数也可以作为变量或者作为方法的参数进行传递。
1 | |
参数
Dart 中的函数除了可以有普通的参数,还可以是具名参数或者可选位置参数。如果使用了 Sound null safety (sdk ≧ 2.12),且没有指明默认值,则这两种类型参数都必须是可为空的,即参数后跟 ?。
具名参数
具名参数 (Named parameters) 是必须写出名字的参数。
1 | |
Dart 2.17 之后,可选具名参数的位置可以在普通参数之前:
1 | |
可选位置参数
可选位置参数 (Optional positional parameters) 和普通的参数唯一的不同之处是它是可选的😅。用 [] 圈起来的参数即可选位置参数。比如:
1 | |
main() 函数
每个应用都有一个 main() 函数作为应用的入口。main() 函数通常返回空,并且可以有数组作为参数。
1 | |
匿名函数
Dart 中的匿名函数和其它语言中类似,可以有多个参数或者没有参数,后跟方法体,形式如下:
1 | |
如果只有单个的表达式或者只有返回值,可以使用箭头表达式:
1 | |
Lexical scope
Dart 同样是具有词法作用域或静态作用域的语言,即只要还在代码作用域内的值,都能访问到。
1 | |
Lexical closures
词法闭包也叫函数闭包,和 JS 中的闭包概念类似,即定义在函数中的函数,同时使得该函数能够访问其它函数作用域中的变量。
1 | |
Operators
Dart 中支持的操作符表,见 Operators。
Cascade notation
1 | |
Control flow statements
If-case statement
Dart 的 if 语句中支持使用 case 来进行模式匹配:
1 | |
比如,我们可以直接判断一段 json 数据是否符合目标格式:
1 | |
这里可以使用的匹配模式可以是任意的数据类型,包括 Map/List/Records 等,具体见 Pattern types。
switch and case
1 | |
Exceptions
Dart 中所有异常都是 unchecked exceptions,意味着 Dart 不会强制你去捕捉异常。
Catch
Dart 中的 try catch 语法:
1 | |
Classes
Dart 中一切皆对象,除了 null 之外,所有对象都是某个类的实例。除了可以继承类之外,Dart 还提供了一种基于 mixin 的继承,也就是说可以通过 with 关键字继承某个没有构造器的类来扩展功能,还可以使用扩展函数。
Using class members
所有对象都由成员变量和方法构成,使用 . 的语法访问对象的属性或者方法,使用 ?. 访问可为空对象的属性和方法。
Using constructors
Dart 中创建构造器除了可以使用类名,也可以使用 类名.构造器名() 的形式。
1 | |
Getting an object’s type
我们可以使用 runtimeType 获得对象的类型 Type。
1 | |
Instance variables
- 所有未初始化可为空的实例变量都会被初始化为 null。
- 所有实例变量都会默认自带 getter 函数,非 final 的实例变量和不带初始化器的 late final 实例变量会自动生成 setter 函数。
- 非延迟初始化的实例变量的值会在对象创建之后,构造器和初始化器列表执行之前,就被赋值。可为空的赋值为 null,不可为空的赋值为初始值。
- 实例变量可以是 final 的,但是必须在构造器或者初始化列表中进行赋值。
Class variables and methods
Dart 中的类同样可以使用静态变量和常量,以及静态方法。
1 | |
Constructors
Dart 中类的构造器和其它语言类似:
1 | |
不过,Dart 提供了一种语法糖的写法:
1 | |
具名构造器
我们可以通过具名构造器 (Named constructors) 为一个类实现多个构造器。不过具名构造器不能被继承,如果想在子类中使用和父类相同的构造器,只能为子类单独实现。
1 | |
构造器初始化列表
除了调用父类构造器之外,我们还可以在构造器方法体执行之前初始化成员变量,称为 Initializer list。
1 | |
初始化起列表中,调用父类构造器必须放到最后。
初始化顺序
默认情况下,子类会先调用父类中的默认构造函数(未定义的话会生成一个无参构造器),如果存在构造器初始化列表 (Initializer list) 则会先调用它们。所以,当使用默认构造函数创建对象时,构造器的初始化顺序为:
- 构造器初始化列表
- 父类无参构造器
- 子类无参构造器
如果父类未定义默认构造器,则子类实现构造器时必须先调用父类的某个具名构造器。
另外,假如定义了构造器方法体,它总是最后才被执行,且此时所有字段必须都已完成初始化。
重定向构造器
1 | |
常量构造器
当你想要创建的对象是编译期常量时(比如用于创建注解),可以使用 const 修饰构造器:
1 | |
使用常量构造器 (Constant Constructors) 初始化对象时,使用相同的值的对象只会在第一次创建时被初始化,也就是说相同值的对象只会初始化一次。
工厂构造器
使用 factory 关键字的构造器,适用于不需要每次创建新对象的情况,比如使用了缓存。另一个使用场景是通过 JSON 数据初始化对象。
1 | |
Concise constructor syntax
从 Dart 3.13 开始,我们在创建生成式或者工厂构造器时,可以省略类名,直接使用 new 或者 factory 关键字:
1 | |
Primary Constructors
从 Dart 3.13 开始,正式引入了 Primary Constructors:一种省略声明字段和传参,在声明 class 时就通过主构造器关联字段和构造器参数的做法。由于这一变化算是比较明显的语言改动,所以单独开一节来详细记录。
1 | |
为了区别主构造器,所有其他构造器现在都可以被叫做*类内构造器 (in-body constructors)*。当使用了主构造器之后,为了保证所有主构造器都能在类初始化时被调用,所有类内构造器都必须重定向到主构造器。
1 | |
另外,在使用了主构造器之后,所有的重定向构造器都不允许有方法体。
Declaring parameters
在前面的例子中,当我们使用 final 或 var 修饰符来创建主构造器中的参数时,这种做法叫做参数声明 (Declaring parameters),它会默认为我们创建并关联对应的字段。假设不使用修饰符,那么,该参数不会关联任何字段。
1 | |
上面的这个 Point 类中,我们只能访问到 x 和 y,而 color 只是作为主构造器的参数传入。
也正是这个原因,我们从现在起将无法将这两个关键字用在其它地方的参数声明上,比如顶层方法或者 setter 的参数声明。
1 | |
Named primary constructors
主构造器也可以用自定义的名字,如下所示:
1 | |
Initialize private fields
Dart 从 3.12 开始支持在构造器中直接创建私有参数,结合主构造器的写法,我们可以这样创建一个类:
1 | |
Primary constructor scopes
前面提到过,主构造器中的参数会自动生成字段,但是其作为参数本身也是有作用域的,主要体现在字段的初始化、初始化列表和构造器方法体中。具体见下面这个来自官网的例子:
1 | |
上面这个例子也揭示了我们可以使用 this 关键字为主构造器创建初始化列表和方法体,也可以用于验证参数。
不过,需要注意的是,主构造器的参数不能在初始化列表中再次被初始化。在上面的例子中,x 不能在初始化列表中再次被赋值,但是可以在方法体中被修改,因为它使用了 var 修饰符。
Constant primary constructors
主构造器也可以是 const 的,但是有如下限制:
1 | |
- 很明显,所有字段必须都是
final的; - 不能有构造器方法体;
- 实例变量初始化的值必须是潜在常量 (Potentially constant)。
其他
在引入主构造器之后,还产生了一些有趣的新写法以及对应的限制,比如:
- 我们可以直接创建一个不带任何字段和方法的“空”类:
1 | |
- 在继承类时,主构造器中可以像类内构造器一样,使用 super 传递参数。
1 | |
- 主构造器可以大大提高声明 enum 类时的可读性:
1 | |
另外,在 enum 类中,主构造器默认是 const 的,因此可以省略不写。
- 主构造器中的参数不能使用
late或者external修饰。 - 主构造器中的参数需要避免和类中的其他字段或方法重名。
- 主构造器中的参数可以是
covariant的,但同时也必须使用var修饰符。
Getters and setters
我们可以利用 getters 和 setters 方法定义一些需要通过计算得到的值,或者限制某些字段访问方式。
1 | |
Abstract classes
Dart 中的抽象类同样无法被直接实例化,如果需要实例化可以通过工厂构造器。
1 | |
Implicit interfaces
Dart 中所有的类都可以作为接口被实现 (通过 implement 关键字):
1 | |
我们可以使用直接继承获得所有父类的实现,也可以使用 implements 将类作为接口实现,此时子类必须提供所有父类的属性和方法的实现:
1 | |
Extending a class
Dart 中所有类都可以被继承,使用 extends 关键字继承父类,使用 super 引用父类。
Dart 2.17 之后允许在构造器中使用 super 语法:
1 | |
这样就不需要调用父类构造器,写出 super(…) 这样的模板代码了。
Enumerated types
Dart 中的枚举类和 Java 中类似。
1 | |
Dart 2.17 之后允许在 enum 类中使用成员变量:
1 | |
枚举类有以下限制:
- 无法继承、实现或者混用 (mixin) 枚举类
- 无法直接实例化
sealed class
密封类的作用和枚举类相似,都可以提供可枚举的子类型,在使用时 switch 语法时保证所有子类型都被检查到(Exhaustiveness checking)。它与枚举类所不同的是,枚举类每种类型只能有一个实例,而每个密封类的实现类可以创建多个实例。如下:
1 | |
Extension methods
和 Kotlin 类似,在 Dart 中我们同样可以通过扩展函数扩充函数库。
1 | |
Extension types
扩展类型是一种编译时抽象机制,它通过一种仅包含静态方法的接口来“封装”现有的类型。由于无需创建实际的封装结构,它们便能轻松修改现有类型的接口,而这对于各种类型的互操作来说至关重要,因此也是静态 JS 互操作功能中的重要组成部分。
扩展类型的语法如下:
1 | |
- 扩展类型
TypeName的底层类型为int,且引用对象的名称为i。 - 类似于主构造器,这隐式声明了字段
i的 getter 方法和构造函数TypeName(int i) : i = i。
Adding features to a class: mixins
Dart 中还提供了另外一种复用代码的方式 mixin,我们可以把可复用的代码放到 mixin 类中。子类使用 with 关键字进行关联。
1 | |
除此之外,我们还可以限制 mixin 的使用范围 (on),以及像接口一样使用逗号 (,) 分割继承多个 mixin:
1 | |
在某些特殊情况下,还可以创建 mixin 类,如下:
1 | |
此时,该类既可以被当做一个普通类来使用,也可以作为 mixin 来使用。
Class modifiers
除了以上提到的关键字,可以用来修饰类的还有以下这些:
base:表示该类是基类,子类实现该类时,必须在base/final/sealed选择其一。final: 表示该类不允许被继承或实现。interface:表示该类是接口,通常使用abstract interface来定义一个类,和抽象类的区别是,不允许被当前 library 以外的类继承。其他方面基本和抽象类用法一致。
默认创建的类或者 mixin (也就是不带任何修饰符) 都具有以下属性:
- 可以创建新的实例;
- 可以继承别的类来创建子类;
- 可以实现类或者
mixin的接口(见 Implicit interfaces); - 可以混合新的 mixin 和 mixin 类。
各个修饰符混用后的作用效果对比表格见:modifier-reference。
Generics
Dart 中的泛型(参数化类型)和 Java 以及 Kotlin 等语言非常相似,使用 <> 表示泛型。
为什么使用泛型
使用泛型一般有两个目的:
- 指明泛型类型之后,减少代码出错。比如在集合中加入不该加入的值。
- 使用泛型减少复制粘贴的代码。比如持有某个对象的类,当需要改变持有的对象而其它部分不发生变化时,如果使用了泛型就不用重新复制一个新的类。
Using collection literals
即在使用集合时定义集合类型,形式如 <type>[] or <type>{} or <keyType, valueType>{}。
1 | |
泛型集合及其类型
Java 中,由于泛型存在类型擦除,所以是无法确定集合的确切类型的。但是,Dart 中的泛型是 reified 的,也就是说在运行时也能得到集合的类型信息。
1 | |
泛型参数类型的限制
Dart 中限制泛型参数边界同样使用 extends 关键字。
1 | |
Libraries and visibility
Dart 中,我们可以通过 import 和 library 指示符创建模块化的、可共享的代码库。另外,即使不使用 library 指示符,每个 dart app 都是一个 library。
导入一个 library 的语法:
1 | |
其它库可以使用文件路径或者 package: 命名空间:
1 | |
指定库的前缀
如果两个库有相同的名称,可以通过 as 指定前缀解决冲突。
1 | |
部分导入
如果只使用到库的一部分,可以使用部分导入的语法,通过 show 和 hide 做到。
1 | |
实现 libraries
Asynchrony support
Dart 中有很多返回 Future 和 Stream 对象的函数,我们可以使用它们编写出异步的代码。除此之外,Dart 还提供了 async 和 await 关键字,让你可以像 JS 一样,更方便地写出一些更具易读性的异步代码。
常见的用法如下:
1 | |
Stream 和 Future 的不同之处在于,它可以连续接收多个异步事件。我们可以通过 StreamBuilder 对持续发生变化的数据流进行监听,比如通过 WebSocket 获取数据:
1 | |
另外,我们还可以通过 Stream 实现事件总线的功能,比如 event_bus 就是基于 Stream 实现的。
Generators
Dart 中的 Generator 函数和 ES6 中相似,如果你想要延迟生成一系列值,可以考虑使用生成器。Dart 中的 Generator 函数分为两种:
1 | |
Callable classes
我们可以通过给某个类实现 call() 方法,使得该类可以像方法一样被调用。
1 | |
Isolates
与其它语言的并发机制不同,Dart 中并没有采用共享状态的并发机制 (shared-state concurrency),而是使用了 isolates。所有的代码都运行在自己的 isolate 中,每个 isolate 都有自己的内存堆,保证了相互独立性。
更多资料见:Isolates。
Typedefs
Dart 中,一切皆是对象,函数也是对象,但是函数对象的信息在运行时往往会被丢失,比如下面这个例子:
1 | |
typedef 就是为了解决上面这个问题而出现的,我们可以给方法类型一个别名,这样,当方法被赋值到一个变量上时就能保留其类型信息:
1 | |
typedef 也可以使用泛型:
1 | |
Metadata
通过元信息注解,我们可以为类和方法提供额外的信息。Dart 中自带的注解有 @deprecated 和 @override,除此之外,你也可以自定义注解,只要在类的构造器上使用 const 关键字就可以了:
1 | |
Comments
Dart 支持三种类型的注释:单行注释、多行注释和文档注释。
1 | |