مراجعة - نظام ملف تعريف المستخدم

جزء من قسم Object Oriented Programming في رحلة Dart على Coddy — الدرس 29 من 110.

التحدي

سهل

لنقم ببناء نظام ملف تعريف مستخدم كامل يجمع بين جميع مفاهيم سلامة القيم الخالية (null safety) التي تعلمتها في هذا الفصل. ستنشئ نظاماً يدير حسابات المستخدمين بمزيج من المعلومات المطلوبة والتفاصيل الاختيارية.

ستقوم بتنظيم الكود الخاص بك في ملفين:

user_profile.dart: قم بتعريف فئة UserProfile التي تمثل حساب مستخدم. فكر في المعلومات الأساسية (مثل اسم المستخدم) مقابل المعلومات الاختيارية (مثل السيرة الذاتية أو رقم الهاتف). يجب أن تحتوي الفئة الخاصة بك على:
- متغير String username غير قابل للقيمة الخالية - يجب أن يكون لكل مستخدم اسم مستخدم
- متغير String email غير قابل للقيمة الخالية - يجب أن يكون لكل مستخدم بريد إلكتروني
- متغير String? displayName قابل للقيمة الخالية - قد يفضل المستخدمون إظهار اسم مختلف
- متغير String? bio قابل للقيمة الخالية - ليس الجميع يكتب سيرة ذاتية
- متغير int? age قابل للقيمة الخالية - العمر هو معلومة شخصية اختيارية
- منشئ (constructor) يستخدم المعاملات المسماة (named parameters) مع الكلمة المفتاحية required لكل من username و email
- دالة getDisplayIdentity() تعيد الاسم المعروض إذا تم تعيينه، وإلا تعيد اسم المستخدم باستخدام عامل التشغيل ??
- دالة getBioPreview() تعيد أول 20 حرفاً من السيرة الذاتية متبوعة بـ ... إذا كانت السيرة الذاتية موجودة وأطول من 20 حرفاً، أو السيرة الذاتية كاملة إذا كانت 20 حرفاً أو أقل، أو null إذا لم تكن هناك سيرة ذاتية (استخدم ?. للوصول الآمن)
- دالة setDefaultBio() تقوم بتعيين السيرة الذاتية إلى 'Hello, I am new here!' فقط إذا كانت قيمتها الحالية خالية (null) باستخدام عامل التشغيل ??=
- دالة printProfile() تعرض ملف تعريف المستخدم الكامل
main.dart: استورد فئة ملف تعريف المستخدم الخاصة بك وأنشئ عدة مستخدمين لتوضيح النطاق الكامل لميزات سلامة القيم الخالية:
- أنشئ مستخدماً باسم مستخدم 'alice_dev' وبريد إلكتروني 'alice@code.com'، ثم قم بتعيين الاسم المعروض إلى 'Alice'، والسيرة الذاتية إلى 'Software developer passionate about clean code and testing'، والعمر إلى 28
- أنشئ مستخدماً باسم مستخدم 'bob_builder' وبريد إلكتروني 'bob@build.io'، ثم قم بتعيين الاسم المعروض فقط إلى 'Bob'
- أنشئ مستخدماً باسم مستخدم 'charlie99' وبريد إلكتروني 'charlie@mail.net' (اترك جميع الحقول الاختيارية كقيم خالية)
- استدعِ setDefaultBio() لجميع المستخدمين الثلاثة
- لكل مستخدم بالترتيب، استدعِ printProfile()، ثم اطبع Identity: [getDisplayIdentity()]، ثم اطبع Bio preview: [getBioPreview()]

يجب أن تطبع الدالة printProfile() بهذا التنسيق:

===== User Profile =====
Username: [username]
Email: [email]
Display Name: [displayName or "Not set"]
Bio: [bio or "No bio"]
Age: [age or "Not specified"]

لاحظ كيف تظل السيرة الذاتية لـ Alice دون تغيير بعد استدعاء setDefaultBio() لأنها تمتلك قيمة بالفعل، بينما يتم تعيين السيرة الذاتية الافتراضية لـ Charlie. لاحظ أيضاً كيف تقوم معاينة السيرة الذاتية باختصار سيرة Alice الطويلة ولكنها تعرض سيرة Charlie الافتراضية القصيرة بالكامل.

المخرجات المتوقعة:

===== User Profile =====
Username: alice_dev
Email: alice@code.com
Display Name: Alice
Bio: Software developer passionate about clean code and testing
Age: 28
Identity: Alice
Bio preview: Software developer p...
===== User Profile =====
Username: bob_builder
Email: bob@build.io
Display Name: Bob
Bio: Hello, I am new here!
Age: Not specified
Identity: Bob
Bio preview: Hello, I am new here!
===== User Profile =====
Username: charlie99
Email: charlie@mail.net
Display Name: Not set
Bio: Hello, I am new here!
Age: Not specified
Identity: charlie99
Bio preview: Hello, I am new here!

جرّب بنفسك

import 'user_profile.dart';

void main() {
  // TODO: أنشئ المستخدم 'alice_dev' بالبريد الإلكتروني 'alice@code.com'
  // قم بتعيين displayName إلى 'Alice'
  // قم بتعيين bio إلى 'Software developer passionate about clean code and testing'
  // قم بتعيين age إلى 28
  
  // TODO: أنشئ المستخدم 'bob_builder' بالبريد الإلكتروني 'bob@build.io'
  // قم بتعيين displayName فقط إلى 'Bob'
  
  // TODO: أنشئ المستخدم 'charlie99' بالبريد الإلكتروني 'charlie@mail.net'
  // اترك جميع الحقول الاختيارية كـ null
  
  // TODO: استدعِ setDefaultBio() لجميع المستخدمين الثلاثة
  
  // TODO: لكل مستخدم بالترتيب (alice، bob، charlie):
  // 1. استدعِ printProfile()
  // 2. اطبع "Identity: [getDisplayIdentity()]"
  // 3. اطبع "Bio preview: [getBioPreview()]"
}