【Dart】语言概述

// 导入(import)
// 导入核心库

//导入外部库
import 'package:test_api/test_api.dart';

// 导入文件
//import 'path/test.dart';

// 每个应用都有一个 main() 函数
void main() {
  // 你好，世界
  // 使用顶层函数 print() 来将一段文本输出显示到控制台
  print('Hello, World!');

  // 变量
  // 虽然 Dart 是代码类型安全的语言，但是由于其支持类型推断，因此大多数变量不需要显式地指定类型
  var name = '天空之城';
  var year = 1977;
  var antennaDiameter = 3.7;
  var flybyObjects = ['木星', '土星', '天王星', '海王星'];
  var image = {
    'tags': ['木星'],
    'url': '//path//ex.jpg',
  };

  // 流程控制语句
  // Dart 支持常用的流程控制语句
  if (year >= 2001) {
    print('21世纪');
  } else if (year >= 1901) {
    print('20世纪');
  }

  for (var object in flybyObjects) {
    print(object);
  }

  for (var month = 1; month <= 12; ++month){
    print(month);
  }

  while (year < 2016) {
    year += 1;
  }

  // 调用函数
  var result = fibonacci(20);
  print(result);

  // =>(胖箭头)
  // 这种简写语法用于仅包含一条语句的函数。该语法在将匿名函数作为参数传递时非常有用
  flybyObjects.where((name) => name.contains('土星')).forEach(print);

  // 注释
  // 这是一个普通的单行注释。
  /// 这是一个文档注释。
  /// 文档注释用于为库、类以及类的成员添加注释。
  /// 像 IDE 和 dartdoc 这样的工具可以专门处理文档注释。这很重要！
  /* 也可以像这样使用单斜杠和星号的注释方式 */

  // 使用类
  var voyager = Spacecraft('旅行者一号', DateTime(1977, 5, 5));
  voyager.describe();

  var voyager3 = Spacecraft.unlaunched('旅行者三号');
  voyager3.describe();

}

// 函数
// 建议为每个函数的参数以及返回值都指定类型
int fibonacci(int n) {
  if (n == 0 || n == 1) return n;
  return fibonacci(n - 1) + fibonacci(n - 2);
}

// 类
// 展示了一个包含三个属性、两个构造函数以及一个方法的类。其中一个属性不能直接赋值，因此它被定义为一个 getter 方法（而不是变量）。
class Spacecraft {
  String name;
  DateTime launchDate;

  // 构造函数，带有可以直接为成员变量赋值的语法糖
  Spacecraft(this.name, this.launchDate) {
    // 实现初始化代码
  }

  // 命名构造函数，转发到默认构造函数
  Spacecraft.unlaunched(String name) : this(name, null);

  // 只读的非final的属性
  int get launchYear => launchDate?.year;

  // 方法
  void describe() {
    print('宇宙飞船：$name');
    if (launchDate != null) {
      int years = DateTime.now().difference(launchDate).inDays ~/ 365;
      print('发射时间：$launchYear ($years years ago)');
    } else {
      print('尚未发射！');
    }
  }

}

// 继承类，Dart支持单继承
class Orbiter extends Spacecraft {
  num altitude;
  Orbiter(String name, DateTime launchDate, this.altitude) : super(name, launchDate);
}

// Mixins， 它是一种在多个类层次结构中重用代码的方法
class Piloted {
  int astronauts = 1;
  void describeCrew() {
    print('宇航员人数：$astronauts');
  }
}

// 使用 Mixin 的方式继承这个类就可将该类中的功能添加给其它类
class PilotedCraft extends Spacecraft with Piloted {
  //
}

// 接口和抽象类
// Dart 没有 interface 关键字。相反，所有的类都隐式定义了一个接口。因此，任意类都可以作为接口被实现。
class MockSpaceship implements Spacecraft {
  //
}
// 创建一个被任意具体类扩展（或实现）的抽象类。抽象类可以包含抽象方法（不含方法体的方法）。
abstract class Describable {
  void describe();
  void describeWithEmphasis() {
    print('=========');
    describe();
    print('=========');
  }
}

// 异步
// 使用 async 和 await 关键字可以让你避免回调地狱（Callback Hell）并使你的代码更具可读性
const oneSecond = Duration(seconds: 1);
// ...
Future<void> printWithDelay(String message) async {
  await Future.delayed(oneSecond);
  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('文件$object已经存在，它上一次修改时间为 $modified。');
        continue;
      }
      await file.create();
      await file.writeAsString('开始在此文件中描述 $object。');
    } on IOException catch (e) {
      print('不能为 $object 创建描述：$e');
    }
  }
}

// 也可以使用 async* 关键字，其可以为你提供一个可读性更好的方式去生成 Stream。
Stream<String> report(Spacecraft craft, Iterable<String> objects) async* {
  for (var object in objects) {
    await Future.delayed(oneSecond);
    yield '${craft.name} 由 $object 飞行。';
  }
}

// 异常
// 使用 throw 关键字抛出一个异常
if (astronauts == 0) {
  throw StateError('没有宇航员');
}
// 使用 try 语句配合 on 或 catch（两者也可同时使用）关键字来捕获一个异常
try {
  for (var object in flybyObjects) {
    var description = await File('$object.txt').readAsString();
    print(description);
  }
} on IOException catch (e) {
  print('无法描述该对象：$e');
} finally {
  flybyObjects.clear();
}

// 上述代码是异步的；同步代码以及异步函数中得代码都可以使用 try 捕获异常。