زبان برنامه‌نویسی

چیت‌شیت Kotlin

راهنمای Kotlin برای نوع‌ها، null safety، کلاس داده، مجموعه‌ها و coroutineها. نوع nullable را با ? بیان کنید و با safe call، Elvis و smart cast مسیرهای null را کنترل کنید. data class برای دادهٔ مقداری مناسب است. توابع collection خروجی تازه تولید می‌کنند؛ برای پردازش تنبل از Sequence و extensionهای کوچک و نام‌گذاری‌شده استفاده کنید. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.

NOVIN SKILLS / DIGITAL STUDIO

Safe call و Elvis

مقدار null را نزدیک محل مصرف به خروجی جایگزین تبدیل کنید.

1fun displayName(user: User?): String =2    user?.name?.takeIf { it.isNotBlank() } ?: "Guest"

Data class

data class برابری مقداری، copy و destructuring می‌دهد.

1data class Product(2    val id: Long,3    val name: String,4    val price: Double5)

Sealed class و when

sealed hierarchy امکان مدل‌سازی حالت‌ها و when exhaustive را می‌دهد.

1sealed interface Result<out T>2data class Success<T>(val value: T) : Result<T>3data class Failure(val message: String) : Result<Nothing>45fun label(result: Result<*>): String = when (result) {6    is Success<*> -> "success"7    is Failure -> result.message8}

Filter و map

زنجیرهٔ کوتاه انتخاب و تبدیل را بیان می‌کند.

1val names = users2    .filter { it.isActive }3    .map { it.name }4    .sorted()

Group by

groupBy یک map از کلید به فهرست عضوها می‌سازد.

1val usersByCity: Map<String, List<User>> =2    users.groupBy { it.city }

Sequence برای پردازش تنبل

Sequence می‌تواند تخصیص مجموعه‌های میانی را در زنجیره‌های بزرگ کاهش دهد.

1val firstLongNames = users.asSequence()2    .map { it.name }3    .filter { it.length > 10 }4    .take(5)5    .toList()

Suspend function

suspend امکان توقف غیرمسدودکنندهٔ coroutine را می‌دهد.

1suspend fun loadUser(id: Long): User {2    return api.fetchUser(id)3}

کار مستقل با async/await

async را در coroutine scope اجرا و نتیجه را با await دریافت کنید.

1suspend fun loadDashboard(): Dashboard = coroutineScope {2    val profile = async { api.profile() }3    val alerts = async { api.alerts() }4    Dashboard(profile.await(), alerts.await())5}

لغو و cleanup

در finally cleanup کنید و CancellationException را بی‌صدا نبلعید.

1suspend fun observe() {2    try {3        repository.events().collect(::handleEvent)4    } finally {5        releaseResources()6    }7}

برای استفاده در پروژه

نکات کلیدی

۱
مقدار ثابت را با val و متغیر را با var تعریف کنید.
۲
نوع nullable را با ? مشخص کنید و از ?. یا ?: آگاهانه بهره ببرید.
۳
برای مقداردهی امن از let یا guard روشن استفاده کنید؛ !! را محدود کنید.
۴
داده ساده را با data class مدل کنید.
۵
از when برای شاخه‌بندی و پوشش حالت‌های محدود استفاده کنید.
۶
توابع extension را برای رفتارهای مرتبط و قابل‌کشف تعریف کنید.
۷
از List فقط‌خواندنی و MutableList در جای مناسب استفاده کنید.
۸
عملیات ناهمگام را با coroutine و scope دارای چرخه عمر روشن اجرا کنید.
۹
خطا را در مرز API مدیریت و context لغو را حفظ کنید.
۱۰
کد را با formatter و تست‌های مربوط به null، حالت‌های مرزی و coroutine بررسی کنید.
۱۱
برای حالت‌های نتیجهٔ محدود از sealed type استفاده کنید تا when بتواند کامل‌بودن شاخه‌ها را بررسی کند.
۱۲
coroutine را در scope دارای lifecycle اجرا کنید و cancellation را نبلعید؛ آن را به فراخواننده منتقل کنید.

چیت‌شیت Kotlin

1sealed interface Result<out T>2data class Success<T>(val value: T) : Result<T>3data class Failure(val message: String) : Result<Nothing>45fun label(result: Result<*>): String = when (result) {6 is Success<*> -> "success"7 is Failure -> result.message8}