Property Reference in Kotlin

Introduction

Property Reference is a fundamental concept every Kotlin developer should understand. Reflection inspects types, properties, and functions at runtime — useful for serialization libraries, DI frameworks, and testing utilities.

Property references access metadata of properties. In this tutorial you will learn the syntax, walk through a complete example program, study the sample output, and review best practices so you can apply the concept confidently in your own projects.

Definition

• Property references access metadata of properties.
• Syntax ClassName::propertyName or obj::propertyName.
• Used in delegates and reflection-based libraries.

Syntax

val prop = MyClass::name

Property Reference in Kotlin Example Program in Kotlin

class Config(var appName: String)

fun main(args: Array<String>) {
    val config = Config("Demo")
    val property = Config::appName
    property.set(config, "Kotlin App")
    println(config.appName)
}

Sample Output

Kotlin App

When to use

Use reflection sparingly for frameworks and generic utilities; prefer compile-time type safety when possible.

How it works

1. The program starts with a main function — the entry point that runs when you execute the file.

2. val config = Config("Demo") assigns or updates a value used later in the program.

3. val property = Config::appName assigns or updates a value used later in the program.

4. The println(config.appName) statement writes a line to the console — this produces part of the sample output below.

5. Property references access metadata of properties.

6. Run the program in IntelliJ IDEA, Android Studio, or with the Kotlin command-line compiler (kotlinc / kotlin). Compare your console output with the sample output shown below.

Best Practices

• Understand the core idea: property references access metadata of properties.
• Prefer readable names and small functions so examples map directly to real projects.
• Run and modify the example — change values and observe how the output changes.

Common Mistakes

• Skipping the example and only reading the definition — hands-on practice cements the concept.
• Copying syntax without understanding nullable vs non-nullable types or scope rules.
• Ignoring compiler warnings that often point to safer alternatives.

Key Points

• Property references access metadata of properties.
• Syntax ClassName::propertyName or obj::propertyName.
• Used in delegates and reflection-based libraries.
• Test the example locally and verify the output matches the sample.
• Experiment by changing input values to see how behaviour changes.

Notes

• Semicolons at the end of statements are optional in Kotlin.