عرض مصدر Kotlin/object declarations

<noinclude>{{DISPLAYTITLE:التصريح عن الكائنات (Object Declarations) وتعابيرها (Expressions) في لغة Kotlin}}</noinclude>
قد تحتاج في بعض الأحيان لإنشاء كائنٍ بإجراء تعديلاتٍ طفيفةٍ على أحد الأصناف (classes) بدون التصريح عن صنفٍ فرعيٍّ (subclass) له؛ تعالج لغة Java مثل هذه الحالات بالاعتماد على الأصناف الداخليّة المجهولة (anonymous inner classes)، وتُعمِّمها لغة Kotlin من خلال طرح مفهوم التصريح عن الكائنات وتعابيرها.

== تعابير الكائنات (Object Expressions) ==
لإنشاء كائنٍ من صنفٍ مجهولٍ (anonymous) يرِث من نوعٍ أو أكثر تكون الشيفرة بالشكل:<syntaxhighlight lang="kotlin">
window.addMouseListener(object : MouseAdapter() {
    override fun mouseClicked(e: MouseEvent) {
        // ...
    }

    override fun mouseEntered(e: MouseEvent) {
        // ...
    }
})
</syntaxhighlight>وإن كان للصنف الأعلى (superclass) بانٍ (constructor)، فيجب أن تُمرَّر له متحولاتٌ مناسبةٌ، وتُحدَّد كثير من الأنواع الأعلى (supertypes) كقائمةٍ (يٌفصَل بين عناصرها بالفاصلة <code>,</code>) تُكتب بعد النقطتين الرأسيتيّن <code>:</code>، كما في الشيفرة الآتية:<syntaxhighlight lang="kotlin">
open class A(x: Int) {
    public open val y: Int = x
}

interface B {...}

val ab: A = object : A(1), B {
    override val y = 15
}
</syntaxhighlight>أما عند الحاجة لكائنٍ وحسب بدون تعقيدات الأنواع الأعلى، تصبح الشيفرة ببساطةٍ كالآتي:<syntaxhighlight lang="kotlin">
fun foo() {
    val adHoc = object {
        var x: Int = 0
        var y: Int = 0
    }
    print(adHoc.x + adHoc.y)
}
</syntaxhighlight>وقد تُستخدَم الكائنات المجهولة (anonymous objects) كأنواع  في حالة التصريحات المحليّة (local) أو الخاصّة (private) فقط، وإذا ما استُخدم الكائن كنوعٍ مُعادٍ في دالةٍ عامّةٍ أو كنوع خاصيّةٍ (property) عامٍة فإن النوع الفعليّ لتلك الدالة أو الخاصّيّة سيكون بحسب النوع الأعلى للكائن المجهول، أو من النوع <code>Any</code> إذا لم يُعرَّف أيُّ نوعٍ أعلى، ولن يُتاح الوصول إلى العناصر المٌضافة في الكائن المجهول كما في الشيفرة الآتية:<syntaxhighlight lang="kotlin">
class C {
    // الدالة خاصّة لذلك فإن النوع المعاد هو نوع الكائن المجهول
    private fun foo() = object {
        val x: String = "x"
    }

    // الدالة عامّة وبالتالي فإن النوع المُعاد هو Any
    fun publicFoo() = object {
        val x: String = "x"
    }

    fun bar() {
        val x1 = foo().x        // شيفرة صحيحة وتعمل
        val x2 = publicFoo().x  // شيفرة خاطئة إذ لا يمكن الوصول عبر المرجعية x
    }
}
</syntaxhighlight>وكما هو الحال في الأصناف الداخليّة المجهولة (anonymous inner classes) في Java فإن شيفرة تعابير الكائنات تستطيع الوصول لكافّة المتحوّلات الواقعة في نفس النطاق المحيط (enclosing scope) (وهذا لا يقتصر على المتحولات من النوع <code>final</code> كما في Java)، مثل الشيفرة الآتية:<syntaxhighlight lang="kotlin">
fun countClicks(window: JComponent) {
    var clickCount = 0
    var enterCount = 0

    window.addMouseListener(object : MouseAdapter() {
        override fun mouseClicked(e: MouseEvent) {
            clickCount++
        }

        override fun mouseEntered(e: MouseEvent) {
            enterCount++
        }
    })
    // ...
}
</syntaxhighlight>

== التصريح عن الكائنات (Object Declarations) ==
يُستفاد من نموذج Singelton التصميميّ في حالاٍت كثيرةٍ، وتجعل Kotlin (من بعد Scala) من التصريح عن Singelton أمرًا سهلًا كما في الشيفرة:<syntaxhighlight lang="kotlin">
object DataProviderManager {
    fun registerDataProvider(provider: DataProvider) {
        // ...
    }

    val allDataProviders: Collection<DataProvider>
        get() = // ...
}
</syntaxhighlight>وهذا ما يُدعَى بالتصريح عن الكائن (object declaration)، ودائمًا يُتبع بالتسمية بعد الكلمة المفتاحيّة <code>object</code>، وكما في التصريح عن المتحولات لا يُعدُّ هذا التصريح تعبيرًا، ولا يمكن استخدامه على الجانب الأيمن من تعليمة الإسناد، أمّا تهيئته الأولية (initialization) فهي خالية من المشاكل التفرعيّة (thread-safe) (أي لا تنتُج مشاكلٌ برمجيّةٌ في التهيئة التفرعيّة عبر threads مختلفة) 

ويٌشار للكائن باستخدام اسمه بشكلٍ مباشرٍ، مثل:<syntaxhighlight lang="kotlin">
DataProviderManager.registerDataProvider(...)
</syntaxhighlight>وقد يكون لهذا النوع من الكائنات أنواعٌ أعلى (supertypes) مثل:<syntaxhighlight lang="kotlin">
object DefaultListener : MouseAdapter() {
    override fun mouseClicked(e: MouseEvent) {
        // ...
    }

    override fun mouseEntered(e: MouseEvent) {
        // ...
    }
}
</syntaxhighlight>'''ملاحظة:''' لا يُمكن أن يكون التصريح عن الكائنات محليًّا (local) (كأن يكون واقعًا في دالةٍ ما)، ولكن يمكن إدخالها (nested) في التصريحات عن كائناتٍ أخرى أو أيّ أصناف غير داخليّة (non-inner).

== الكائنات المُرافِقة (Companion Objects) ==
تُضاف الكلمة المفتاحية <code>companion</code> قبل التصريح عن الكائن إن كان واقعًا داخل الصنف، مثل:<syntaxhighlight lang="kotlin">
class MyClass {
    companion object Factory {
        fun create(): MyClass = MyClass()
    }
}
</syntaxhighlight>إذ تُستدعى عناصر الكائن المرافق من خلال اسم الصنف كمُقيِّد (qualifier)، مثل:<syntaxhighlight lang="kotlin">
val instance = MyClass.create()
</syntaxhighlight>كما ويمكن الاستغناء عن اسم الكائن المرافق ليُستخدَم الاسم <code>Companion</code> عوضًا عنه، مثل:<syntaxhighlight lang="kotlin">
class MyClass {
    companion object {
    }
}

val x = MyClass.Companion
</syntaxhighlight>وعلى الرغم من أن عناصر الكائن المرافق تماثِل العناصر الستاتيكيّة في لغات البرمجة الأخرى، ولكنها تبقى عناصر كائنيّة عاديّة أثناء التنفيذ (runtime)، وبالتالي فإنها تستطيع تعريف استخدام (implement) الواجهات (interfaces)، مثل:<syntaxhighlight lang="kotlin">
interface Factory<T> {
    fun create(): T
}


class MyClass {
    companion object : Factory<MyClass> {
        override fun create(): MyClass = MyClass()
    }
}
</syntaxhighlight>ولكن من الممكن توليد عناصر الكائنات المرافقة في JVM كتوابع (methods) وحقول (fields) ستاتيكيّةٍ حقيقيّةٍ وذلك باستخدام التوصيف (annotation)‏ ‎<code>@JvmStatic</code>.

== الفوارق الدِلاليّة بين التصريح عن الكائنات وتعابيرها ==
هناك فرقٌ أساسيّ واحدٌ ما بينهما يتلخص بالنقاط:
* تُنفَّذ (وتُهيَّأ) تعابير الكائن في المكان الذي تُستخدَم به فوريًا
* تكون التهيئة من النمط الكسول (lazy) في التصريح عن الكائنات عند الوصول إليها للمرّة الأولى
* يُهيَّأ الكائن المرافق (companion object) عند تحميل (load) الصنف الموافق له، مماثلًا بذلك عمليات التهيئة الستاتيكيّة في Java.

== مصادر ==
* [https://kotlinlang.org/docs/reference/object-declarations.html صفحة التصريح عن الكائنات وتعابيرها في التوثيق الرسميّ للغة Kotlin]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Objects]]
[[تصنيف:Kotlin Classes]]
[[تصنيف:Kotlin Expressions]]
[[تصنيف:Kotlin Declarations]]