آموزش استفاده از sealed classes در زبان برنامه نویسی دارت و فلاتر

دو ویژگی مهم اخیر زبان دارت، sealed classes و pattern matching بوده‌اند – ویژگی‌هایی که به‌طور چشمگیری نحوه‌ی نمایش و مدیریت داده‌ها توسط

از زمان معرفی زبان دارت Dart، کاربرانی که از زبان‌های دیگر به آن مهاجرت می‌کردند، اغلب از کمبود برخی ویژگی‌ها در مقایسه با آنچه به آن عادت داشتند، گلایه می‌کردند.

از آن زمان، تیم Dart سخت در تلاش بوده است تا این زبان را مدرن‌سازی کند.

دو ویژگی مهم اخیر، sealed classes و pattern matching بوده‌اند – ویژگی‌هایی که به‌طور چشمگیری نحوه‌ی نمایش و مدیریت داده‌ها توسط توسعه‌دهندگان در برنامه‌هایشان را بهبود بخشیده‌اند.

این ویژگی‌ها گامی مهم به سوی کدی خواناتر، امن‌تر و با قابلیت نگهداری بالاتر برای توسعه‌دهندگان Dart محسوب می‌شوند.

اما این ویژگی‌ها از کجا آمده‌اند، چرا به آن‌ها نیاز بود و چگونه می‌توان از آن‌ها به طور مؤثر در برنامه‌نویسی مدرن دارت استفاده کرد؟

این مقاله قصد دارد به این سؤالات پاسخ دهد و راهنمایی جامع برای این ساختارهای قدرتمند زبان ارائه کند.

پیش از پرداختن به جنبه‌های فنی، بهتر است درک کنیم که چرا این ویژگی‌ها در وهله اول به دارت اضافه شدند.

مشکلات سلسله‌مراتب کلاس‌های سنتی

قبل از Dart 3، برای مدل‌سازی مجموعه‌ای بسته از انواع (types) مرتبط، معمولاً یک abstract base class (کلاس پایه انتزاعی) با چندین subclass (زیرکلاس) مشخص ایجاد می‌شد.

برای مثال، اگر می‌خواستید اشکال مختلف را در یک برنامه طراحی مدل‌سازی کنید، ممکن بود یک کلاس abstract به نام Shape با پیاده‌سازی‌های مشخصی مانند Circle، Rectangle و Triangle داشته باشید.

double calculateArea(Shape shape) {
  if (shape is Circle) {
    return pi * shape.radius * shape.radius;
  } else if (shape is Rectangle) {
    return shape.width * shape.height;
  } else if (shape is Triangle) {
    return 0.5 * shape.base * shape.height;
  }
  throw UnimplementedError('Unknown shape type');
}

این رویکرد کار می‌کرد، اما چندین ایراد داشت.

مهم‌ترین مشکل این بود که Dart نمی‌توانست تضمین کند که شما هنگام کار با نمونه‌هایی از کلاس پایه، تمام subclass های ممکن را مدیریت کرده‌اید. کدی را در نظر بگیرید که مساحت یک شکل را محاسبه می‌کند:

این رویکرد چندین مشکل داشت:

  1. اگر نوع شکل جدیدی اضافه می‌کردید، compiler (کامپایلر) در مورد عدم مدیریت آن در توابعی مانند calculateArea به شما هشداری نمی‌داد.
  2. نیاز به یک حالت fallback (پیش‌فرض یا بازگشتی) داشتید، حتی اگر از نظر مفهومی نباید نوع دیگری وجود داشته باشد.
  3. مجبور بودید shape را cast کنید تا به خصوصیات (properties) آن دسترسی پیدا کنید، که این کار هم کد را طولانی (verbose) می‌کرد و هم مستعد خطا (error-prone) بود.

این مشکلات به‌ویژه برای برنامه‌هایی که از الگوهای مدیریت وضعیت (state management) مانند Redux یا BLoC استفاده می‌کنند، بسیار دردسرساز بود؛ چرا که در این الگوها، مدیریت صحیح تمام وضعیت‌های ممکن برای صحت عملکرد برنامه حیاتی است.

الهام از زبان‌های دیگر

Dart این ویژگی‌ها را در انزوا توسعه نداده است. هم sealed classes و هم pattern matching تاریخچه‌ی غنی در زبان‌های برنامه‌نویسی دیگر، به‌ویژه در برنامه‌نویسی تابعی (functional programming) دارند.

ریشه‌ی sealed classes را می‌توان در زبان‌هایی مانند ML و Haskell جستجو کرد که دارای انواع داده جبری (algebraic data types یا ADTs) بودند.

این ADTها به توسعه‌دهندگان اجازه می‌دادند مجموعه‌ای بسته از انواع ممکن (variants) را تعریف کنند.

بعدها، زبان‌هایی مانند Scala، Kotlin و Swift این مفهوم را به زبان‌های شیءگرای رایج‌تر آوردند.

Pattern matching حتی تاریخچه‌ی طولانی‌تری دارد و به زبان‌هایی مانند SNOBOL در دهه‌ی ۱۹۶۰ میلادی بازمی‌گردد.

پیاده‌سازی‌های مدرن در زبان‌هایی مانند Rust، Swift و Scala نشان دادند که چگونه pattern matching می‌تواند با یک زبان شیءگرا با سیستم نوع ایستا (static typing) ادغام شود.

تیم دارت و فلاتر از این زبان‌ها، به‌ویژه از sealed classes در Kotlin و pattern matching در Swift الهام گرفت و در عین حال، این ویژگی‌ها را با سینتکس و فلسفه طراحی موجود در زبان دارت تطبیق داد.

زبان دارت 3

تیم زبان برنامه نوسی دارت این ویژگی‌ها را یک شبه اضافه نکرد.

هم sealed classes و هم pattern matching مراحل طولانی بحث‌های طراحی، نمونه‌سازی اولیه (prototyping) و دریافت بازخورد از جامعه توسعه‌دهندگان را پشت سر گذاشتند.

این فرآیند با درک این نیاز آغاز شد که Dart به ابزارهای بهتری برای مدل‌سازی اشیاء دامنه (domain objects) و مدیریت وضعیت در برنامه‌های فلاتر نیاز دارد.

پیش‌نویس‌های اولیه تهیه و با جامعه به اشتراک گذاشته شد و سپس چندین مرحله بازبینی و تکرار بر اساس بازخورد توسعه‌دهندگان صورت گرفت.

تیم همچنین باید اطمینان حاصل می‌کرد که این ویژگی‌ها با سیستم نوع (type system) موجود در Dart، ویژگی null safety (که در Dart 2.12 معرفی شد) به‌خوبی کار می‌کنند و به‌طور کارآمد به کد نیتیو (native code) و JavaScript قابل کامپایل هستند.

پس از چندین سال توسعه، این ویژگی‌ها سرانجام در Dart 3 عرضه شدند و نقطه عطف مهمی در تکامل این زبان رقم زدند.

حال سؤال این است که sealed classes در Dart دقیقاً چه هستند و چگونه مشکلات ذکر شده را حل می‌کنند؟

مفهوم Sealing (محدودسازی یا مهر و موم کردن)

در زبان دارت ، یک sealed class نوع خاصی از abstract class است که مشخص می‌کند کدام کلاس‌ها مجاز به ارث‌بری از آن هستند.

به‌طور خاص، تنها کلاس‌هایی که در همان library (کتابخانه) با sealed class تعریف شده باشند، می‌توانند آن را extend (گسترش دهند) یا implement (پیاده‌سازی کنند).

این محدودیت بسیار حیاتی است، زیرا به compiler دارت اجازه می‌دهد تا در زمان کامپایل (compile time)، تمام subtype های (زیرنوع‌های) ممکن یک sealed class را بشناسد.

این قابلیت به نوبه‌ی خود، امکان بررسی جامع و کامل (exhaustive checking) را در pattern matching و عبارات switch فراهم می‌کند.

نحوه تعریف Sealed Classes

نحوه‌ی تعریف یک sealed class در Dart به این صورت است:

sealed class Shape {
  // Common methods or properties
  String describe();
}

// Concrete implementations must be in the same library
class Circle extends Shape {
  final double radius;
  
  Circle(this.radius);
  
  @override
  String describe() => 'A circle with radius $radius';
}

class Rectangle extends Shape {
  final double width;
  final double height;
  
  Rectangle(this.width, this.height);
  
  @override
  String describe() => 'A rectangle with width $width and height $height';
}

class Square extends Shape {
  final double side;
  
  Square(this.side);
  
  @override
  String describe() => 'A square with side $side';
}

در این مثال، Shape یک sealed class با سه پیاده‌سازی مشخص (concrete implementations) به نام‌های Circle، Rectangle و Square است.

نکته مهم: تمام این کلاس‌ها باید در همان فایل library (فایلی که Shape در آن تعریف شده) تعریف شوند.

محدودیت ارث‌بری مستقیم و فراتر از آن

شایان ذکر است که ویژگی sealed بودن فقط به subclassهای مستقیم اعمال می‌شود. اگر ساختاری مانند زیر داشته باشید:

sealed class Shape {}

class Polygon extends Shape {}

class Triangle extends Polygon {}

class Rectangle extends Polygon {}

Compiler (کامپایلر) Polygon را به عنوان یک subclass مستقیم از Shape می‌شناسد، اما به طور خودکار رابطه بین Polygon و subclassهای آن (Triangle و Pentagon) را ردیابی نمی‌کند.

اگر می‌خواهید بررسی جامع و کامل (exhaustiveness checking) در هر سطح از سلسله‌مراتب ارث‌بری اعمال شود، باید هم Shape و هم Polygon را به صورت sealed تعریف کنید.

مقایسه Sealed Classes و Enums

زبان دارت از قبل enums (شمارشی‌ها) را داشت که آن‌ها نیز مجموعه‌ای بسته از انواع یا مقادیر ثابت (variants) را نشان می‌دهند. پس چه زمانی باید به جای enums از sealed classes استفاده کرد؟

Sealed classes گزینه‌ی مناسب‌تری هستند زمانی که:

  • هر نوع (variant) نیاز به حمل داده‌های متفاوت داشته باشد (مثلاً Circle شعاع دارد، Rectangle طول و عرض).
  • انواع نیاز به رفتار (متدهای) متفاوت داشته باشند.
  • به روابط سلسله‌مراتبی بین انواع نیاز داشته باشید (مانند مثال Polygon بالا).
  • نیاز به استفاده از ارث‌بری (inheritance) یا interface ها داشته باشید.

Enums برای موارد ساده‌تر که فقط به مجموعه‌ای ثابت از مقادیر ثابت نیاز دارید، به‌خوبی کار می‌کنند، به‌خصوص اگر این مقادیر نیازی به حمل داده‌های اضافی نداشته باشند.

Pattern Matching: مکمل ایده‌آل Sealed Classes

Pattern matching (تطبیق الگو) مکمل عالی برای sealed classes است.

این ویژگی راهی فراهم می‌کند تا یک مقدار را در برابر یک الگو (pattern) تست کنید و در صورت تطابق (match)، آن مقدار را به اجزای سازنده‌اش تجزیه (destructure) کنید.

مبانی Pattern Matching

در Dart، pattern matching عمدتاً در دو زمینه به کار می‌رود:

  1. دستورات و عبارات switch (switch statements and expressions)
  2. دستورات if-case (if-case statements)

نحوه‌ی کار pattern matching با عبارات switch به این صورت است:

double calculateArea(Shape shape) {
  return switch (shape) {
    Circle(radius: var r) => 3.14 * r * r,
    Rectangle(width: var w, height: var h) => w * h,
    Square(side: var s) => s * s
  };
}

این روش به طور چشمگیری مختصرتر (concise) و امن‌تر (safer) از رویکرد قبلی مبتنی بر if-else و cast کردن است.

کامپایلر تضمین می‌کند که تمام subclassهای ممکن Shape مدیریت شده‌اند و به طور خودکار propertyهای مربوطه را برای هر case استخراج می‌کند.

قدرت Destructuring (تجزیه ساختار)

یکی از قدرتمندترین جنبه‌های pattern matching، قابلیت destructuring است – یعنی توانایی استخراج اجزاء از یک مقدار پیچیده. Pattern matching در دارت از destructuring برای طیف وسیعی از انواع پشتیبانی می‌کند:

// List patterns
var [first, second, ...rest] = someList;

// Map patterns
var {'name': name, 'age': age} = personMap;

// Record patterns (Dart 3 also introduced records)
var (x, y) = coordinates;

// Object patterns (what we've been using with sealed classes)
if (shape case Circle(radius: var r)) {
  print('Found a circle with radius $r');
}

این قابلیت destructuring کار با ساختارهای داده پیچیده (complex data structures) را بسیار آسان‌تر می‌کند و بسیاری از کدهای تکراری و قالبی (boilerplate code) را که در غیر این صورت برای دسترسی به داده‌ها لازم بود، حذف می‌کند.

الگوهای تو در تو و پیچیده (Nested and Complex Patterns)

الگوها (Patterns) می‌توانند به صورت دلخواه تو در تو باشند، که این امکان را فراهم می‌کند تا منطق تطبیق (matching logic) پیچیده‌ای ایجاد کنید:

var result = switch (httpResponse) {
  SuccessResponse(body: {'user': {'name': var name, 'age': var age}}) => 
    'User $name is $age years old',
  ErrorResponse(statusCode: 404) => 
    'User not found',
  ErrorResponse(statusCode: var code) => 
    'Error: $code',
};

این مثال یک پاسخ HTTP موفق را که حاوی یک آبجکت user است، مطابقت می‌دهد، name و age را استخراج کرده و آن‌ها را در یک رشته فرمت می‌کند.

همچنین، انواع مختلف پاسخ‌های خطا را بر اساس status code مدیریت می‌کند.

Guard ها و عبارت When (Guards and When Clauses)

گاهی اوقات، تطبیق صرفاً بر اساس ساختار کافی نیست.

دارت به شما اجازه می‌دهد یک عبارت when را به یک pattern match اضافه کنید تا شرایط اضافی را مشخص نمایید:

var description = switch (shape) {
  Circle(radius: var r) when r < 1 => 'A tiny circle',
  Circle(radius: var r) when r > 10 => 'A large circle',
  Circle() => 'A medium circle',
  Rectangle(width: var w, height: var h) when w == h => 'Actually a square',
  Rectangle() => 'A rectangle',
  Square() => 'A square'
};

عبارت when به شما امکان می‌دهد فیلترینگ اضافی را فراتر از صرفاً ساختارِ مقداری که در حال تطبیق است، اعمال کنید.

با داشتن درک قوی از این مفاهیم، بیایید بررسی کنیم که چگونه sealed classes و pattern matching می‌توانند در برنامه‌های Dart در دنیای واقعی به کار روند.

مدیریت وضعیت در Flutter (State Management)

یکی از رایج‌ترین کاربردهای sealed classes در برنامه‌های فلاتر، نمایش وضعیت برنامه (application state) است:

sealed class AuthState {}

class Unauthenticated extends AuthState {}

class Authenticating extends AuthState {
  final String username;
  Authenticating(this.username);
}

class Authenticated extends AuthState {
  final User user;
  Authenticated(this.user);
}

class AuthenticationFailed extends AuthState {
  final String error;
  AuthenticationFailed(this.error);
}

// In a Flutter widget
Widget build(BuildContext context) {
  return switch (authState) {
    Unauthenticated() => LoginScreen(),
    Authenticating(username: var name) => LoadingScreen(message: 'Logging in $name...'),
    Authenticated(user: var user) => HomeScreen(user: user),
    AuthenticationFailed(error: var message) => ErrorScreen(message: message)
  };
}

این رویکرد تضمین می‌کند که تمام وضعیت‌های ممکن احراز هویت در UI (رابط کاربری) مدیریت شوند و compiler به شما هشدار خواهد داد اگر وضعیت جدیدی اضافه کنید اما فراموش کنید کد UI را به‌روزرسانی نمایید.

مدل‌سازی موجودیت‌های دامنه (Domain Entities)

Sealed classes همچنین برای مدل‌سازی موجودیت‌های دامنه با انواع (variants) به خوبی تعریف شده، عالی هستند:

sealed class PaymentMethod {
  String get displayName;
  double calculateFee(double amount);
}

class CreditCard extends PaymentMethod {
  final String cardNumber;
  final String expiryDate;
  final String cvv;
  
  CreditCard({required this.cardNumber, required this.expiryDate, required this.cvv});
  
  @override
  String get displayName => 'Credit Card ending in ${cardNumber.substring(cardNumber.length - 4)}';
  
  @override
  double calculateFee(double amount) => amount * 0.03; // 3% fee
}

class BankTransfer extends PaymentMethod {
  final String accountNumber;
  final String routingNumber;
  
  BankTransfer({required this.accountNumber, required this.routingNumber});
  
  @override
  String get displayName => 'Bank Transfer from account ending in ${accountNumber.substring(accountNumber.length - 4)}';
  
  @override
  double calculateFee(double amount) => 1.50; // Flat fee
}

class PayPal extends PaymentMethod {
  final String email;
  
  PayPal({required this.email});
  
  @override
  String get displayName => 'PayPal ($email)';
  
  @override
  double calculateFee(double amount) => amount * 0.02 + 0.30; // 2% + $0.30
}

با این مدل، می‌توانید اطمینان حاصل کنید که هر کدی که متدهای پرداخت را مدیریت می‌کند، تمام انواع ممکن را در نظر می‌گیرد، که این امر برای برنامه‌های مالی بسیار حیاتی است.

تجزیه و پردازش داده (Parsing and Processing Data)

Pattern matching هنگام تجزیه (parsing) و پردازش داده‌های ساختاریافته (structured data)، مانند JSON، بسیار کارآمد است:

sealed class JsonValue {}

class JsonNull extends JsonValue {}

class JsonBoolean extends JsonValue {
  final bool value;
  JsonBoolean(this.value);
}

class JsonNumber extends JsonValue {
  final num value;
  JsonNumber(this.value);
}

class JsonString extends JsonValue {
  final String value;
  JsonString(this.value);
}

class JsonArray extends JsonValue {
  final List<JsonValue> values;
  JsonArray(this.values);
}

class JsonObject extends JsonValue {
  final Map<String, JsonValue> properties;
  JsonObject(this.properties);
}

String prettyPrint(JsonValue json, {int indent = 0}) {
  final spaces = ' ' * indent;
  
  return switch (json) {
    JsonNull() => '${spaces}null',
    JsonBoolean(value: var v) => '${spaces}$v',
    JsonNumber(value: var n) => '${spaces}$n',
    JsonString(value: var s) => '${spaces}"$s"',
    JsonArray(values: var items) => '${spaces}[\n${items.map((item) => prettyPrint(item, indent: indent + 2)).join(',\n')}\n${spaces}]',
    JsonObject(properties: var props) => '${spaces}{\n${props.entries.map((e) => '${' ' * (indent + 2)}"${e.key}": ${prettyPrint(e.value, indent: 0)}').join(',\n')}\n${spaces}}'
  };
}

این مثال یک چاپگر زیبای ساده JSON (JSON pretty-printer) را پیاده‌سازی می‌کند که تمام انواع مقادیر ممکن JSON را مدیریت می‌کند.

Pattern matching باعث می‌شود کد بسیار خواناتر و تمیزتر از حالتی باشد که با دستورات سنتی if-else نوشته می‌شد.

نکات تکمیلی

اکنون که مفاهیم و کاربردها را پوشش دادیم، بیایید به برخی از بهترین شیوه‌ها برای استفاده مؤثر از sealed classes و pattern matching در Dart نگاهی بیندازیم.

چه زمانی از Sealed Classes استفاده کنیم؟

Sealed classes بیشترین فایده را دارند زمانی که:

  • مجموعه‌ای ثابت از انواع (variants) دارید که همگی یک مفهوم واحد را نشان می‌دهند.
  • هر نوع (variant) نیاز به خصوصیات (properties) یا رفتار (behavior) متفاوتی دارد.
  • بررسی جامع (exhaustive checking) برای صحت عملکرد کد اهمیت دارد.
  • می‌خواهید compiler به شما در نگهداری کد در طول زمان کمک کند.

سناریوهای رایج عبارتند از:

  • نمایش وضعیت برنامه (Application state representation)
  • مدل‌سازی دامنه (Domain modeling) با انواع به خوبی تعریف شده
  • انواع نتیجه (Result types) مانند موفقیت/شکست (success/failure)
  • درخت‌های نحو انتزاعی (Abstract syntax trees یا ASTs)
  • پروتکل‌های پیام (Message protocols)

طراحی سلسله‌مراتب خوب برای Sealed Class

هنگام طراحی سلسله‌مراتب sealed class، این اصول را در نظر بگیرید:

  • در صورت امکان، سلسله‌مراتب را کم‌عمق نگه دارید.
  • رفتارهای مشترک را در کلاس پایه sealed قرار دهید.
  • هر نوع (variant) را معنادار و متمایز تعریف کنید.
  • از نام‌های معنادار استفاده کنید که هدف هر نوع را به وضوح بیان کند.
  • اگر می‌خواهید به جای سازنده‌های عمومی، از factory methods استفاده کنید، سازنده‌ها را private تعریف کنید.

Pattern Matching مؤثر

برای بهره‌مندی حداکثری از pattern matching:

  • از قابلیت destructuring برای دسترسی مستقیم به propertyهای مورد نیاز استفاده کنید.
  • برای ساختارهای پیچیده از الگوهای تو در تو (nested patterns) استفاده کنید.
  • عبارت when را برای اعمال شرایط اضافی فراموش نکنید.
  • خوانایی الگوهای خود را در نظر بگیرید – گاهی اوقات چندین الگوی ساده، واضح‌تر از یک الگوی پیچیده است.
  • به یاد داشته باشید که الگوها فقط با sealed classes کار نمی‌کنند – lists، maps و records نیز پشتیبانی می‌شوند.

تست کردن (Testing)

هنگام تست کدی که از sealed classes و pattern matching استفاده می‌کند، حتماً موارد زیر را انجام دهید:

هنگامی که نوع جدیدی اضافه می‌کنید، تمام تست‌های مربوط به آن sealed class را به‌روزرسانی کنید.

هر نوع (variant) از sealed class خود را تست کنید.

تأیید کنید که منطق pattern matching به درستی تمام انواع را مدیریت می‌کند.

اگر از عبارت when استفاده می‌کنید، هر دو حالت (زمانی که شرط true است و زمانی که false است) را تست کنید.


Sealed classes و pattern matching پیشرفت قابل توجهی در بیانگری (expressiveness) و ایمنی نوع (type safety) زبان Dart محسوب می‌شوند.

این ویژگی‌ها مدل‌سازی مفاهیم دامنه، مدیریت وضعیت برنامه و پردازش ساختارهای داده پیچیده را آسان‌تر می‌کنند و همزمان از compiler برای اطمینان از صحت عملکرد کمک می‌گیرند.

مانند هر ویژگی زبانی دیگر، sealed classes و pattern matching ابزارهایی هستند که باید به‌جا و مناسب استفاده شوند.

لزوماً هر سلسله‌مراتب کلاسی نیازی به sealed شدن ندارد و هر منطق شرطی نیازمند pattern matching نیست.

اما هنگامی که در زمینه‌های درست به کار گرفته شوند، این ویژگی‌ها می‌توانند به طور چشمگیری کیفیت کد Dart شما را بهبود بخشند.

دیدگاه‌ها (0)

    دیدگاه خود را بنویسید

    ایمیل شما نمایش داده نمی‌شود. دیدگاه پس از تأیید نمایش داده می‌شود.