Dart: أمان القيم الفارغة في Dart

// غير قابل للفراغ: المترجم يضمن عدم الفراغ
String orderId = 'ORD-001';    // لا يمكن أن يكون فارغاً
// orderId = null;              // خطأ ترجمة!

// قابل للفراغ: يجب فحصه قبل الاستخدام
String? nickname;               // يمكن أن يكون فارغاً
int length = nickname?.length ?? 0;  // وصول آمن

> **الإخراج:** شغّل في 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.

void main() {
  // أنواع غير قابلة للفراغ - لا يمكن أن تحتوي على فارغ
  String name = 'DataPipeline';
  int count = 100;
  double amount = 1500.0;

  // name = null;    // خطأ ترجمة!
  // count = null;   // خطأ ترجمة!

  // أنواع قابلة للفراغ - يمكن أن تحتوي على فارغ
  String? nickname;
  int? maxRetries;
  double? discountRate;

  print(nickname);       // null
  print(maxRetries);     // null
  print(discountRate);   // null

  // الأنواع القابلة للفراغ تتطلب الفحص قبل الاستخدام
  // print(nickname.length);  // خطأ ترجمة! قد يكون فارغاً
  print(nickname?.length);    // null (آمن)
  print(nickname?.length ?? 0); // 0 (مع افتراضي)
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

void main() {
  String? name = 'Bob';

  // قبل الفحص - قابل للفراغ
  // print(name.length);  // خطأ!

  // بعد فحص الفراغ - مرقى إلى غير قابل للفراغ
  if (name != null) {
    print(name.length);   // OK! name مرقى إلى String
    print(name.toUpperCase());  // OK!
  }
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

void main() {
  String? city;

  // الطريقة 1: فحص if-null
  if (city != null) {
    print(city.length);  // مرقى
  }

  // الطريقة 2: عامل coalesce الفراغ ??
  String safeCity = city ?? 'Unknown';
  print(safeCity.length);  // آمن دائماً

  // الطريقة 3: الوصول مع الوعي بالفراغ ?.
  int? length = city?.length;
  print(length);  // null

  // الطريقة 4: تهيئة late
  late String resolvedCity;
  resolvedCity = city ?? 'Unknown';
  print(resolvedCity.length);  // آمن

  // الطريقة 5: assert في وضع التطوير
  assert(city != null, 'City must not be null');
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

class DataPipeline {
  // late - ستتم التهيئته لاحقاً، لكن مضمون قبل الاستخدام
  late String outputPath;
  late final DateTime startTime;

  void configure(String path) {
    outputPath = path;  // التعيين الأول
  }

  void start() {
    startTime = DateTime.now();  // late final - يُعيَّن مرة واحدة
    print('Pipeline started at $startTime');
  }
}

void main() {
  final pipeline = DataPipeline();
  pipeline.configure('/tmp/reports');
  pipeline.start();

  // تهيئة late مع تعبير
  late final int maxRecords = _loadConfig();
  // maxRecords يُحسب فقط عند الوصول الأول
  print('Max records: $maxRecords');
}

int _loadConfig() {
  print('Loading config...');
  return 1000000;
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

class RiskyPipeline {
  late String config;

  void process() {
    // إذا لم يُعيَّن config، يُلقي LateInitializationError
    print(config);  // تحطم محتمل في وقت التشغيل!
  }
}

void main() {
  final pipeline = RiskyPipeline();
  // pipeline.process();  // LateInitializationError!

  // النمط الآمن: التهيئة في المُنشئ
  final safePipeline = SafePipeline('/etc/config.yaml');
  safePipeline.process();  // OK
}

class SafePipeline {
  late String config;

  SafePipeline(String configPath) {
    config = _loadConfig(configPath);
  }

  void process() => print('Config: $config');

  String _loadConfig(String path) => 'Loaded from $path';
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

void main() {
  String? name = 'Bob';

  // عندما تعرف أن القيمة غير فارغة
  print(name!.length);  // 3 - OK لأن name هو 'Bob'

  // خطير: إذا كان فارغاً، يتحطم!
  String? maybeNull;
  // print(maybeNull!.length);  // TypeError وقت التشغيل!

  // بديل آمن: استخدم ?? أو فحص if-null
  print(maybeNull?.length ?? 0);  // 0 - آمن
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

class Order {
  final String id;
  final double amount;
  Customer? customer;  // علاقة اختيارية

  Order({required this.id, required this.amount});

  // استخدم ! عندما يضمن منطق العمل عدم الفراغ
  String get customerName {
    // هذا محفوف بالمخاطر - قد يكون customer فارغاً
    // return customer!.name;  // سيء

    // أفضل: وصول آمن مع افتراضي
    return customer?.name ?? 'Unknown Customer';
  }
}

class Customer {
  final String name;
  Customer(this.name);
}

void main() {
  final order = Order(id: 'ORD-001', amount: 1500.0);
  print(order.customerName);  // Unknown Customer

  // بعد تعيين customer
  order.customer = Customer('Alice');
  print(order.customerName);  // Alice
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

void main() {
  // قائمة بعناصر قابلة للفراغ
  List<String?> names = ['Alice', null, 'Bob', null, 'Charlie'];

  // تصفية الفراغات - تعمل ترقية النوع
  final nonNull = names.whereType<String>().toList();
  print(nonNull);  // [Alice, Bob, Charlie]

  // خريطة بقيم قابلة للفراغ
  Map<String, double?> revenue = {
    'Electronics': 3600.0,
    'Books': null,
    'Clothing': 890.0,
  };

  // تصفية الإدخالات ذات القيم غير الفارغة
  final validRevenue = Map.fromEntries(
    revenue.entries.where((e) => e.value != null),
  );
  print(validRevenue);  // {Electronics: 3600.0, Clothing: 890.0}

  // وصول آمن مع افتراضي
  final booksRevenue = revenue['Books'] ?? 0;
  print(booksRevenue);  // 0
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

class PipelineConfig {
  // الحقول المطلوبة - غير قابلة للفراغ
  final String appName;
  final String version;

  // الحقول الاختيارية - قابلة للفراغ مع افتراضيات
  final String? outputPath;
  final String? logLevel;
  final double? customTaxRate;
  final int? maxRetries;

  // محسوبة من اختيارية - غير قابلة للفراغ
  String get effectiveOutputPath => outputPath ?? '/tmp/datapipeline/output';
  String get effectiveLogLevel => logLevel ?? 'info';
  double get effectiveTaxRate => customTaxRate ?? 0.08;
  int get effectiveMaxRetries => maxRetries ?? 3;

  const PipelineConfig({
    required this.appName,
    required this.version,
    this.outputPath,
    this.logLevel,
    this.customTaxRate,
    this.maxRetries,
  });

  String get summary => '''
$appName v$version
  Output: $effectiveOutputPath
  Log:    $effectiveLogLevel
  Tax:    ${(effectiveTaxRate * 100).toStringAsFixed(1)}%
  Retries: $effectiveMaxRetries
''';
}

void main() {
  // تكوين أدنى - الحقول المطلوبة فقط
  final minimal = PipelineConfig(
    appName: 'DataPipeline',
    version: '1.0.0',
  );
  print(minimal.summary);

  // تكوين كامل
  final full = PipelineConfig(
    appName: 'DataPipeline',
    version: '2.0.0',
    outputPath: '/data/reports',
    logLevel: 'debug',
    customTaxRate: 0.10,
    maxRetries: 5,
  );
  print(full.summary);
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

// ============================================
// معالجة طلبات آمنة الفراغ لخط أنابيب البيانات
// عرض كامل لأنماط أمان القيم الفارغة
// ============================================

class Customer {
  final String name;
  final String? email;
  final Address? address;

  Customer({required this.name, this.email, this.address});

  String get displayName => email ?? name;
  String get city => address?.city ?? 'Unknown City';
}

class Address {
  final String city;
  final String? state;
  final String country;

  Address({required this.city, this.state, required this.country});

  String get fullRegion => state != null ? '$city, $state' : city;
}

class Order {
  final String id;
  final double amount;
  final String status;
  final Customer? customer;
  final String? discountCode;
  final double? discountPercent;

  Order({
    required this.id,
    required this.amount,
    required this.status,
    this.customer,
    this.discountCode,
    this.discountPercent,
  }) : assert(amount > 0, 'Amount must be positive');

  double get effectiveDiscount => discountPercent ?? 0;

  double get discountedAmount => amount * (1 - effectiveDiscount);

  double get tax => discountedAmount * 0.08;

  double get total => discountedAmount + tax;

  String get customerName => customer?.name ?? 'Guest';

  String get customerCity => customer?.city ?? 'Unknown';

  String get formattedTotal =>
      '\$${total.toStringAsFixed(2)} USD';

  @override
  String toString() =>
      'Order($id, $customerName, ${formattedTotal}, $status)';
}

class OrderProcessor {
  final List<Order> _orders = [];
  final List<String> _warnings = [];

  void addOrder(Order order) {
    _orders.add(order);

    // فحوصات آمنة الفراغ مع تحذيرات
    if (order.customer == null) {
      _warnings.add('Order ${order.id}: No customer assigned');
    }
    if (order.discountCode != null && order.discountPercent == null) {
      _warnings.add('Order ${order.id}: Discount code without rate');
    }
  }

  double get totalRevenue =>
      _orders.fold(0.0, (sum, o) => sum + o.total);

  List<Order> get ordersWithCustomers =>
      _orders.where((o) => o.customer != null).toList();

  Map<String, double> revenueByCity() {
    final result = <String, double>{};
    for (final order in _orders) {
      final city = order.customerCity;
      result.update(city, (v) => v + order.total, ifAbsent: () => order.total);
    }
    return result;
  }

  void printReport() {
    print('=== DataPipeline Order Report ===');
    print('Orders: ${_orders.length}');
    print('Revenue: \$${totalRevenue.toStringAsFixed(2)} USD');
    print('With customers: ${ordersWithCustomers.length}');

    print('\nRevenue by City:');
    for (final entry in revenueByCity().entries) {
      print('  ${entry.key}: \$${entry.value.toStringAsFixed(2)} USD');
    }

    if (_warnings.isNotEmpty) {
      print('\nWarnings:');
      for (final w in _warnings) {
        print('  $w');
      }
    }
  }
}

void main() {
  final processor = OrderProcessor();

  processor.addOrder(Order(
    id: 'ORD-001',
    amount: 1500.0,
    status: 'completed',
    customer: Customer(
      name: 'Alice',
      email: 'alice@example.com',
      address: Address(city: 'New York', state: 'NY', country: 'US'),
    ),
    discountPercent: 0.10,
  ));

  processor.addOrder(Order(
    id: 'ORD-002',
    amount: 3200.0,
    status: 'completed',
    // لا يوجد عميل - حقل قابل للفراغ
  ));

  processor.addOrder(Order(
    id: 'ORD-003',
    amount: 890.0,
    status: 'pending',
    customer: Customer(
      name: 'Bob',
      address: Address(city: 'London', country: 'UK'),
    ),
    discountCode: 'SAVE20',
    // discountPercent فارغ - تحذير!
  ));

  processor.printReport();
}

> **الإخراج:** شغّل في DartPad محلي أو عبر `dart run`. جميع الأمثلة في دورة Dart هذه مبنية على Dart 3.x / Flutter 3.x، وقد تختلف النتائج قليلاً حسب إصدار SDK.

=== DataPipeline Order Report ===
Orders: 3
Revenue: $5172.36 USD
With customers: 2

Revenue by City:
  New York: $1458.00 USD
  Unknown: $3456.00 USD
  London: $961.20 USD

Warnings:
  Order ORD-002: No customer assigned
  Order ORD-003: Discount code without rate