스코프 확장과 컴패니언 확장
확장의 가시성을 제한하고 companion object에 확장을 추가해 보세요.
스코프 확장과 컴패니언 확장은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
확장의 범위를 제한하는 이유
기본적으로 확장은 가져온 곳 어디에서나 표시됩니다. 범위를 제한하면 클래스, 파일 또는 문맥 안에서만 보이게 할 수 있어 네임스페이스 오염을 줄이고 쉽게 찾을 수 있습니다.
파일 비공개 확장
파일 수준에서 확장 함수에 private를 지정하면 해당 파일에서만 사용할 수 있습니다.
private fun String.shout() = uppercase() + "!"
fun main() {
println("hello".shout()) // HELLO!
}내부 가시성
internal을 사용하면 확장을 현재 모듈로 제한할 수 있습니다. 외부에서 사용하도록 만든 것이 아닌 라이브러리 내부 기능에 적합합니다.
internal fun List<Int>.sumIfPositive(): Int = filter { it > 0 }.sum()
fun main() {
println(listOf(-1, 2, 3, -4).sumIfPositive()) // 5
}멤버 확장 함수
클래스 내부에 확장을 선언하면 해당 클래스의 인스턴스가 범위 안에 있을 때만 사용할 수 있습니다. 디스패치 수신자(클래스)와 확장 수신자(대상)라는 두 수신자가 있습니다.
class StringHelper(val prefix: String) {
fun String.withPrefix() = prefix + this
fun build(): String = "world".withPrefix() // calls extension via instance
}
fun main() {
println(StringHelper("hello ").build()) // hello world
}멤버 확장의 가시성
멤버 확장은 디스패치 클래스 외부에서 접근할 수 없습니다. 캡슐화에 유용합니다.
class Repo {
fun List<Int>.allPositive() = all { it > 0 }
fun check(xs: List<Int>) = xs.allPositive()
}
fun main() {
val r = Repo()
println(r.check(listOf(1, 2, 3))) // true
// listOf(1).allPositive() // ERROR — no access
}컴패니언 객체에 대한 확장
클래스의 컴패니언 객체에 확장을 추가합니다. 호출자에게는 정적 메서드처럼 보이지만 실제로는 클래스 외부에 있습니다.
class Greeter {
companion object
}
fun Greeter.Companion.morning() = "Good morning!"
fun main() {
println(Greeter.morning())
}컴패니언 확장을 사용하는 이유
원래 클래스를 수정하지 않고도 외부에서 팩토리 메서드나 도우미를 추가할 때 유용합니다.
class User(val name: String) {
companion object
}
fun User.Companion.guest() = User("Guest")
fun User.Companion.system() = User("System")
fun main() {
println(User.guest().name)
println(User.system().name)
}비어 있더라도 컴패니언이 필요합니다
컴패니언 확장을 연결하려면 클래스가 컴패니언 객체를 선언해야 합니다(비어 있어도 됩니다). 그렇지 않으면 확장의 대상이 존재하지 않습니다.
class Box {
companion object // required, even if empty
}
fun Box.Companion.create(): Box = Box()
fun main() {
println(Box.create())
}가져오기를 통한 범위 지정 확장
특정 파일에서만 확장을 가져와 확장 사용 범위를 제한할 수 있습니다. 가져오지 않은 파일에서는 확장을 볼 수 없습니다.
// File A:
// fun String.shout() = uppercase()
// File B imports:
// import com.example.shout
// Only File B can call shout()
fun String.shout() = uppercase() + "!"
fun main() { println("hi".shout()) }범위 함수를 통한 확장 함수
with 또는 apply를 사용하여 객체를 일시적으로 범위 안으로 가져온 뒤 확장을 사용할 수 있습니다.
class StringTools {
fun String.greet() = "Hello, $this!"
fun process(name: String) = with(this) {
name.greet()
}
}
fun main() {
println(StringTools().process("Ada"))
}컴패니언의 확장 프로퍼티
컴패니언 확장도 프로퍼티가 될 수 있으므로, 클래스 외부에서 이름이 지정된 상수를 추가할 수 있습니다.
class HttpStatus {
companion object
}
val HttpStatus.Companion.OK_CODE: Int get() = 200
val HttpStatus.Companion.NOT_FOUND: Int get() = 404
fun main() {
println(HttpStatus.OK_CODE)
println(HttpStatus.NOT_FOUND)
}권장 사항
파일 내부에서만 사용하는 도우미에는 private를, 모듈 전용 API에는 internal을 사용하십시오. 캡슐화에는 멤버 확장을 사용하고, 외부에서 팩토리와 같은 도우미를 추가할 때는 컴패니언 확장을 사용하십시오.
class StringUtils {
companion object
}
fun StringUtils.Companion.isAlpha(s: String) = s.all { it.isLetter() }
fun main() {
println(StringUtils.isAlpha("hello"))
println(StringUtils.isAlpha("hi5"))
}빠른 확인
외부에서 클래스에 컴패니언 확장을 추가하려면 클래스에 무엇이 필요합니까?
복습
클래스 내부에서 private, internal 또는 멤버 확장으로 확장의 범위를 제한하십시오. 클래스에 선언된 컴패니언 객체에 연결하면 외부에서 컴패니언 확장(함수 또는 프로퍼티)을 추가할 수 있습니다. 네임스페이스 오염을 줄이면서 코드를 모듈화할 수 있습니다.
AI 튜터와 함께 Kotlin을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 51
- 레슨
- 203
자주 묻는 질문
“스코프 확장과 컴패니언 확장” 강의는 무료인가요?
네 — “스코프 확장과 컴패니언 확장” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“스코프 확장과 컴패니언 확장”에서 뭘 배우나요?
확장의 가시성을 제한하고 companion object에 확장을 추가해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“스코프 확장과 컴패니언 확장” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.