dart 语言范例
该章内容并不全面,只是为喜欢通过示例学习的人们简要介绍了该语言。您可能还需要查看语言和库导览,或 Dart 概要。
Hello World
每个应用都有 main()
函数。要在控制台上显示文本,可以使用顶级 print()
函数:
void main() {
print('Hello, World!');
}
变量
即使在类型安全的 Dart 代码中,由于类型推断,大多数变量也不需要显式类型:
var name = 'Voyager I';
var year = 1977;
var antennaDiameter = 3.7;
var flybyObjects = ['Jupiter', 'Saturn', 'Uranus', 'Neptune'];
var image = {
'tags': ['saturn'],
'url': '//path/to/saturn.jpg'
};
阅读有关 Dart 中变量的更多信息,包括默认值,final
和 const
关键字以及静态类型。
控制语句
Dart 支持通常的控制语句:
if (year >= 2001) {
print('21st century');
} else if (year >= 1901) {
print('20th century');
}
for (var object in flybyObjects) {
print(object);
}
for (int month = 1; month <= 12; month++) {
print(month);
}
while (year < 2016) {
year += 1;
}
阅读有关 Dart 中控制流语句的更多信息,包括 break
和 continue
,switch
和 case
,和 assert
。
函数
我们建议 指定每个函数的参数和返回值的类型:
int fibonacci(int n) {
if (n == 0 || n == 1) return n;
return fibonacci(n - 1) + fibonacci(n - 2);
}
var result = fibonacci(20);
简写 =>
(箭头)语法对于包含单个语句的函数很方便。当将匿名函数作为参数传递时,此语法特别有用:
flybyObjects.where((name) => name.contains('turn')).forEach(print);
除了显示匿名函数(where()
的参数)之外,此代码还显示您可以将函数用作参数: 顶级 print()
函数是 forEach()
的参数。
阅读有关 Dart 中函数的更多信息,包括可选参数,默认参数值和词法范围。
注释
Dart 注释通常以开头 //
。
// This is a normal, one-line comment.
/// This is a documentation comment, used to document libraries,
/// classes, and their members. Tools like IDEs and dartdoc treat
/// doc comments specially.
/*Comments like these are also supported.*/
阅读有关 Dart 中注释的更多信息,包括文档工具的工作方式。
导入
要访问其他库中定义的 API,请使用 import
。
// Importing core libraries
import 'dart:math';
// Importing libraries from external packages
import 'package:test/test.dart';
// Importing files
import 'path/to/my_other_file.dart';
阅读有关 Dart 中库和可见性的更多信息,包括库前缀 show
和 hide
,以及通过 deferred
关键字的延迟加载。
类
这是一个具有三个属性,两个构造函数和一个方法的类的示例。其中一个属性不能直接设置,因此是使用 getter
方法(而不是变量)定义的。
class Spacecraft {
String name;
DateTime launchDate;
// Constructor, with syntactic sugar for assignment to members.
Spacecraft(this.name, this.launchDate) {
// Initialization code goes here.
}
// Named constructor that forwards to the default one.
Spacecraft.unlaunched(String name) : this(name, null);
int get launchYear =>
launchDate?.year; // read-only non-final property
// Method.
void describe() {
print('Spacecraft: $name');
if (launchDate != null) {
int years =
DateTime.now().difference(launchDate).inDays ~/
365;
print('Launched: $launchYear ($years years ago)');
} else {
print('Unlaunched');
}
}
}
您可以使用这样的 Spacecraft
类:
var voyager = Spacecraft('Voyager I', DateTime(1977, 9, 5));
voyager.describe();
var voyager3 = Spacecraft.unlaunched('Voyager III');
voyager3.describe();
阅读有关 Dart 中类的更多信息,包括初始化列表,可选 new
和 const
,重定向构造函数,factory
构造函数,getter,setter 等。
遗产
Dart 具有单一继承。
class Orbiter extends Spacecraft {
double altitude;
Orbiter(String name, DateTime launchDate, this.altitude)
: super(name, launchDate);
}
阅读有关 扩展类,可选 @override
注释等的更多信息。
混入
Mixins 是在多个类层次结构中重用代码的一种方式。以下类可以充当 mixin:
class Piloted {
int astronauts = 1;
void describeCrew() {
print('Number of astronauts: $astronauts');
}
}
要将 mixin 的功能添加到类中,只需使用 mixin 扩展类即可。
class PilotedCraft extends Spacecraft with Piloted {
// ···
}
PilotedCraft
现在具有 astronauts
字段和 describeCrew()
方法。
阅读有关 mixin 的更多信息。
接口和抽象类
Dart 没有 interface
关键字。相反,所有类都隐式定义一个接口。因此,您可以实现任何类。
class MockSpaceship implements Spacecraft {
// ···
}
阅读有关 隐式接口的更多信息。
您可以创建要由具体类扩展(或实现)的抽象类。抽象类可以包含抽象方法(具有空主体)。
abstract class Describable {
void describe();
void describeWithEmphasis() {
print('=========');
describe();
print('=========');
}
}
任何扩展类 Describable
都具有 describeWithEmphasis()
方法,该方法调用扩展程序的实现 describe()
。
阅读有关 抽象类和方法的更多信息。
异步
避免陷入回调地狱,您可以使用 async
和 await
来提高代码的可读性。
const oneSecond = Duration(seconds: 1);
// ···
Future<void> printWithDelay(String message) async {
await Future.delayed(oneSecond);
print(message);
}
上面的方法等效于:
Future<void> printWithDelay(String message) {
return Future.delayed(oneSecond).then((_) {
print(message);
});
}
如下例所示,async
和 await
有助于使异步代码易于阅读。
Future<void> createDescriptions(Iterable<String> objects) async {
for (var object in objects) {
try {
var file = File('$object.txt');
if (await file.exists()) {
var modified = await file.lastModified();
print(
'File for $object already exists. It was modified on $modified.');
continue;
}
await file.create();
await file.writeAsString('Start describing $object in this file.');
} on IOException catch (e) {
print('Cannot create description for $object: $e');
}
}
}
您还可以使用 async*
,它为您提供了一种很好的,易于阅读的方式来构建流。
Stream<String> report(Spacecraft craft, Iterable<String> objects) async* {
for (var object in objects) {
await Future.delayed(oneSecond);
yield '${craft.name} flies by $object';
}
}
阅读更多 关于异步支持,包括 async
功能 Future
,Stream
和异步循环(await for)。
异常
要引发异常,请使用 throw
:
if (astronauts == 0) {
throw StateError('No astronauts.');
}
要捕获异常,请使用 try
带有 on
或 catch
(或两者)的语句:
try {
for (var object in flybyObjects) {
var description = await File('$object.txt').readAsString();
print(description);
}
} on IOException catch (e) {
print('Could not describe object: $e');
} finally {
flybyObjects.clear();
}
注意上面的代码是异步的; try
适用于同步代码和 async
函数中的代码。
阅读有关异常的更多信息,包括堆栈跟踪 rethrow
,和错误与异常之间的区别。
其他话题
更多的代码示例在 语言示例 和 库示例 中。另请参阅 Dart API 参考, 其中通常包含示例。