Skip to content

확장 함수 ​

이 챕터에서는 코드를 더욱 간결하고 가독성 높게 만들어 주는 특별한 Kotlin 함수를 살펴봅니다. 이러한 함수가 효율적인 디자인 패턴을 사용하여 프로젝트를 한 단계 발전시키는 데 어떻게 도움이 되는지 알아보세요.

확장 함수 ​

소프트웨어 개발에서는 원래 소스 코드를 변경하지 않고도 프로그램의 동작을 수정해야 하는 경우가 자주 발생합니다. 예를 들어, 서드파티 라이브러리의 클래스에 추가 기능을 덧붙이고 싶을 수 있습니다.

이러한 작업은 클래스를 확장하는 _확장 함수(extension functions)_를 추가하여 수행할 수 있습니다. 확장 함수는 마침표 .를 사용하여 클래스의 멤버 함수를 호출하는 것과 동일한 방식으로 호출합니다.

확장 함수의 완전한 문법을 소개하기 전에, 먼저 수신 객체(receiver)가 무엇인지 이해해야 합니다. 수신 객체란 함수가 호출되는 대상을 의미합니다. 즉, 정보가 공유되는 위치 또는 대상을 가리킵니다.

An example of sender and receiver

이 예제에서 main() 함수는 리스트의 첫 번째 요소를 반환하기 위해 .first() 함수를 호출합니다. .first() 함수는 readOnlyShapes 변수에 대해 호출되므로, readOnlyShapes 변수가 수신 객체가 됩니다.

확장 함수를 만들려면 확장하려는 클래스의 이름 뒤에 .과 함수의 이름을 작성합니다. 그런 다음 매개변수와 반환 타입을 포함하여 나머지 함수 선언을 이어 작성합니다.

예를 들어:

kotlin
fun String.bold(): String = "<b>$this</b>"

fun main() {
    // "hello"가 수신 객체입니다
    println("hello".bold())
    // <b>hello</b>
}

이 예제에서:

  • String은 확장된 클래스입니다.
  • bold는 확장 함수의 이름입니다.
  • .bold() 확장 함수의 반환 타입은 String입니다.
  • String의 인스턴스인 "hello"가 수신 객체 역할을 합니다.
  • 본문 내부에서는 키워드인 this를 통해 수신 객체에 접근합니다.
  • 문자열 템플릿($)을 사용하여 this의 값에 접근합니다.
  • .bold() 확장 함수는 문자열을 받아 굵은 텍스트를 위한 <b> HTML 요소로 감싸서 반환합니다.

확장 지향적 설계 ​

확장 함수는 어디에서나 정의할 수 있으므로 확장 지향적 설계(extension-oriented design)를 구현할 수 있습니다. 이러한 설계는 핵심 기능과 유용하지만 필수적이지는 않은 기능을 분리하여 코드를 더 쉽게 읽고 유지 관리할 수 있게 해줍니다.

좋은 예로 네트워크 요청을 수행하는 Ktor 라이브러리의 HttpClient 클래스가 있습니다. 이 클래스의 핵심 기능은 HTTP 요청에 필요한 모든 정보를 전달받는 단일 함수 request()입니다.

kotlin
class HttpClient {
    fun request(method: String, url: String, headers: Map<String, String>): HttpResponse {
        // 네트워크 코드
    }
}

실제로는 GET 또는 POST 요청이 가장 널리 사용되는 HTTP 요청입니다. 따라서 라이브러리가 이러한 일반적인 사용 사례에 대해 더 짧은 이름을 제공하는 것이 합리적입니다. 그러나 이를 위해 새로운 네트워크 코드를 작성할 필요는 없으며, 단지 특정한 요청 호출만 있으면 됩니다. 즉, 이들은 별도의 .get() 및 .post() 확장 함수로 정의하기에 아주 적합합니다.

kotlin
fun HttpClient.get(url: String): HttpResponse = request("GET", url, emptyMap())
fun HttpClient.post(url: String): HttpResponse = request("POST", url, emptyMap())

이러한 .get() 및 .post() 함수는 HttpClient 클래스를 확장합니다. 이 함수들은 수신 객체로서 HttpClient 클래스의 인스턴스에 대해 호출되기 때문에, HttpClient 클래스의 request() 함수를 직접 사용할 수 있습니다. 이러한 확장 함수를 사용하면 적절한 HTTP 메서드로 request() 함수를 호출할 수 있어 코드가 단순해지고 이해하기 쉬워집니다.

kotlin
class HttpClient {
    fun request(method: String, url: String, headers: Map<String, String>): HttpResponse {
        println("Requesting $method to $url with headers: $headers")
        return HttpResponse("Response from $url")
    }
}

fun HttpClient.get(url: String): HttpResponse = request("GET", url, emptyMap())

fun main() {
    val client = HttpClient()

    // request()를 직접 사용하여 GET 요청 보내기
    val getResponseWithMember = client.request("GET", "https://example.com", emptyMap())

    // get() 확장 함수를 사용하여 GET 요청 보내기
    // client 인스턴스가 수신 객체입니다
    val getResponseWithExtension = client.get("https://example.com")
}

이러한 확장 지향적 접근 방식은 Kotlin의 표준 라이브러리 및 기타 라이브러리에서 널리 사용됩니다. 예를 들어, String 클래스에는 문자열 작업을 돕는 다양한 확장 함수가 마련되어 있습니다.

확장 함수에 대한 자세한 내용은 확장(Extensions)을 참고하세요.

실습 ​

정수가 양수인지 확인하기

정수를 받아 양수인지 확인하는 isPositive라는 확장 함수를 작성하세요.

kotlin
fun Int.// 여기에 코드를 작성하세요

fun main() {
    println(1.isPositive())
    // true
}
Example solution {...}
kotlin
fun Int.isPositive(): Boolean = this > 0

fun main() {
    println(1.isPositive())
    // true
}
문자열을 소문자로 변환하기

문자열을 받아 소문자로 변환된 버전을 반환하는 toLowercaseString이라는 확장 함수를 작성하세요.

힌트
String 타입의 .lowercase() 함수를 사용하세요.
kotlin
fun // 여기에 코드를 작성하세요

fun main() {
    println("Hello World!".toLowercaseString())
    // hello world!
}
Example solution {...}
kotlin
fun String.toLowercaseString(): String = this.lowercase()

fun main() {
    println("Hello World!".toLowercaseString())
    // hello world!
}