Dart: Dart 语言简介 — 从诞生到生态全景

// Shared business logic - runs on CLI, Web, Mobile, Server
class DataPipeline {
  final String name;
  final int maxRecords;

  const DataPipeline({
    required this.name,
    this.maxRecords = 1000000,
  });

  String get summary => '$name: capacity ${maxRecords} records';
}

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

// Non-nullable - compiler guarantees non-null
String name = 'Bob';

// Nullable - must check before use
String? nickname = null;

// Safe access
int length = nickname?.length ?? 0;

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

// Switch expression with pattern matching
String describe(Object value) => switch (value) {
  int i => 'Integer: $i',
  double d => 'Double: $d',
  String s => 'String: $s',
  _ => 'Unknown type',
};

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

sealed class DataSource {}
class ApiSource extends DataSource { final String endpoint; ApiSource(this.endpoint); }
class FileSource extends DataSource { final String path; FileSource(this.path); }
class DatabaseSource extends DataSource { final String connectionString; DatabaseSource(this.connectionString); }

// Exhaustive switch - compiler checks all cases
String describe(DataSource source) => switch (source) {
  ApiSource(:final endpoint) => 'API: $endpoint',
  FileSource(:final path) => 'File: $path',
  DatabaseSource(:final connectionString) => 'DB: $connectionString',
};

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

// pubspec.yaml dependencies for DataPipeline
// dependencies:
//   args: ^2.4.2        # CLI argument parsing
//   http: ^1.2.0        # HTTP client
//   csv: ^6.0.0         # CSV parsing
//   sqlite3: ^2.4.0     # SQLite database
//   path: ^1.9.0        # Path manipulation

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

// DataPipeline project overview
// Input:  1.2M e-commerce orders (CSV / API / Database)
// Process: Filter, aggregate, transform in parallel
// Output: Dashboard-ready reports (JSON / CSV / HTML)

void main() {
  print('DataPipeline v1.0.0');
  print('Processing capacity: 1,000,000+ orders');
  print('Output formats: JSON, CSV, HTML');
}

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

// DataPipeline preview - what you will build
void main() {
  // Step 1: Define data source
  final source = ApiSource('https://api.example.com/orders');

  // Step 2: Create pipeline
  final pipeline = DataPipeline(
    name: 'E-Commerce Analytics',
    maxRecords: 1200000,
  );

  // Step 3: Process and output
  print(pipeline.summary);
  // Output: E-Commerce Analytics: capacity 1200000 records
}

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

// ============================================
// DataPipeline Project Skeleton
// A CLI tool for e-commerce data analytics
// ============================================

// Data source types (sealed class for exhaustive matching)
sealed class DataSource {}

class ApiSource extends DataSource {
  final String endpoint;
  ApiSource(this.endpoint);
}

class FileSource extends DataSource {
  final String path;
  FileSource(this.path);
}

// Core pipeline class
class DataPipeline {
  final String name;
  final int maxRecords;
  DataSource? source; // nullable - may not be configured yet

  DataPipeline({
    required this.name,
    this.maxRecords = 1000000,
  });

  String get summary => '$name: capacity ${maxRecords} records';

  String describeSource() {
    if (source == null) return 'No source configured';
    return switch (source!) {
      ApiSource(:final endpoint) => 'API source: $endpoint',
      FileSource(:final path) => 'File source: $path',
    };
  }
}

// Entry point
void main() {
  final pipeline = DataPipeline(
    name: 'E-Commerce Analytics',
    maxRecords: 1200000,
  );

  pipeline.source = ApiSource('https://api.example.com/orders');

  print('=== DataPipeline ===');
  print(pipeline.summary);
  print(pipeline.describeSource());
}

> **输出：** 在本地 DartPad 或 `dart run` 执行。Dart 课程所有示例基于 Dart 3.x / Flutter 3.x，运行结果会因 SDK 版本略有差异。

=== DataPipeline ===
E-Commerce Analytics: capacity 1200000 records
API source: https://api.example.com/orders