Extensions for DSL building in Kotlin

Introduction

Extensions let you add new features to existing code easily. For DSLs, they help make code look simple and natural, like a special language just for your task.

When you want to create a simple and readable way to build complex objects.

When you want to add new functions to classes without changing their original code.

When you want to write code that looks like a small language for a specific job.

When you want to organize code clearly for building things step-by-step.

When you want to improve code readability by using natural language style.

Syntax

Kotlin

fun ReceiverType.extensionFunctionName(params) {
    // function body
}

ReceiverType is the class you add the function to.

This function can be called as if it belongs to the receiver object.

Examples

Adds a new function shout to String that makes text uppercase and adds an exclamation.

Kotlin

fun String.shout() = this.uppercase() + "!"

Adds a function to add the same number twice to a list of integers.

Kotlin

fun MutableList<Int>.addTwice(value: Int) {
    this.add(value)
    this.add(value)
}

Adds a new jump action to the Robot class without changing its code.

Kotlin

class Robot {
    fun move() = println("Moving")
}

fun Robot.jump() = println("Jumping")

Sample Program

This program shows how to add a new jump function to the Robot class using an extension. The robot can move and jump.

Kotlin

class Robot {
    fun move() = println("Moving")
}

fun Robot.jump() = println("Jumping")

fun main() {
    val robot = Robot()
    robot.move()
    robot.jump()
}

Important Notes

Extensions do not actually change the original class; they just add new functions you can use.

If an extension function has the same name as a member function, the member function is called instead.

Extensions help make DSLs by letting you write code that reads like natural instructions.

Summary

Extensions add new functions to existing classes without changing them.

They help create simple and readable DSLs by making code look like a special language.

Use extensions to organize code and improve clarity when building complex objects.