Kotlinのgetter・setterのカスタマイズ方法をわかりやすく解説！初心者向け完全ガイド

1. getterとsetterとは？

1. getterとsetterとは？

getter（ゲッター）は「値を取り出すときの動作」、setter（セッター）は「値を入れるときの動作」です。どちらも“プロパティに触れた瞬間に呼ばれる小さな関数”と考えるとイメージしやすく、Kotlinではプロパティとセットで扱われます。

例えば「年齢」という変数があったとして、取り出す（読む）ときはgetter、代入する（書く）ときはsetterが働きます。ただ値を読む・書くだけでなく、必要なら「チェック」や「加工」「記録」を差し込めるのがポイントです。

家にたとえると、「冷蔵庫（プロパティ）」から「ジュース（値）」を取り出す前に温度を確かめるのがgetter、しまう前にラベルを貼ったり賞味期限を確認するのがsetter──という感覚です。入口と出口にルールを置くことで、データを安全・きれいに保てます。

まずは“読むと呼ばれるのがgetter”、“書くと呼ばれるのがsetter”という関係だけ覚えればOKです。次のサンプルは、特別な設定をしなくても読み書きのタイミングがあることを体験するための最小コードです。

class Box {
    var item: String = "Apple" // Kotlinは自動でgetter/setterを用意する
}

fun main() {
    val b = Box()
    println(b.item)      // ← 取り出し（getterが使われる）
    b.item = "Orange"    // ← 代入（setterが使われる）
    println(b.item)
}

この段階では「読み書きの入口・出口に仕組みがある」と理解できれば十分です。どんな場面でチェックや加工を入れるのか、どう書けばよいのかは後ほど具体例で見ていきます。

2. Kotlinではプロパティに自動でgetter・setterがついている

2. Kotlinではプロパティに自動でgetter・setterがついている

Kotlinで変数（プロパティ）を定義すると、特別な設定をしなくても自動でgetterとsetterが用意されます。つまり、値を読む・書くという普段の操作が、そのまま裏側で小さな関数呼び出しになっているイメージです。

ポイントは、varには「読み取り（getter）＋書き込み（setter）」が、valには「読み取り（getter）のみ」が自動生成されること。まずは次の最小サンプルで“読むとき・書くとき”に仕組みが働く流れを確認しましょう。

class User {
    var age: Int = 20   // 読み書きできる（getter + setter）
    val id: String = "U001" // 読み取り専用（getterのみ）
}

fun main() {
    val user = User()
    println(user.age)   // ← 読み取り：自動生成されたgetterが使われる
    user.age = 25       // ← 書き込み：自動生成されたsetterが使われる
    println(user.age)

    println(user.id)    // ← 読み取りはOK（getter）
    // user.id = "U002" // ← コンパイルエラー：valは書き込み不可
}

このように、user.ageと書けば裏でgetterが呼ばれ、user.age = 25と書けばsetterが働きます。まずは「varなら読み書き」「valは読み取り専用」と覚えておけば十分です。カスタマイズは後の章で扱いますが、ここでは“自動で用意されている”ことを押さえておきましょう。

3. getterをカスタマイズする方法

3. getterをカスタマイズする方法

getterをカスタマイズすると、プロパティを「読み取る瞬間」に好きな処理を差し込めます。難しいことをしなくても、実際に値を返す前にひと言だけ変換やチェックを入れられるイメージです。

例えば、名前を小文字で保存しておき、画面に表示するときだけきれいな大文字に変えることができます。「保存する値はそのまま」「取り出すときだけ加工」という柔軟な使い方ができるので、初心者でも実践しやすいです。

class Person {
    var name: String = "taro"
        get() {
            // 取り出すたびに大文字に変換
            return field.uppercase()
        }
}

fieldはプロパティの中身そのものを表す特別なキーワードで、箱の中に入っている値そのものだと思っておくと分かりやすいです。

fun main() {
    val person = Person()
    println(person.name)  // 画面に表示するときだけ大文字に変わる
}

TARO

このようにgetterをカスタマイズするだけで、データの見せ方を統一したり、出力を自動整形したりできます。特に入力そのものは変更したくないけれど、外へ見せるときだけ整えておきたいケースで役立ちます。

4. setterをカスタマイズする方法

4. setterをカスタマイズする方法

setterでは、値が代入されるときに条件をチェックしたり、自動的に加工して保存することができます。以下は、マイナスの年齢が入らないように制限する例です。

class Member {
    var age: Int = 0
        set(value) {
            field = if (value >= 0) value else 0
        }
}

fun main() {
    val member = Member()
    member.age = -5
    println(member.age)
}

0

このように、setterで条件をつけることで、不正な値が入らないように安全に管理できます。

5. getter・setterの両方をカスタマイズする例

5. getter・setterの両方をカスタマイズする例

getterとsetterを同時にカスタマイズすれば、保存するときと取り出すときに別々の処理を入れることもできます。以下の例では、値を保存するときは小文字に変換、取り出すときは大文字にして返すようにしています。

class UserName {
    var name: String = ""
        get() = field.uppercase()
        set(value) {
            field = value.lowercase()
        }
}

fun main() {
    val user = UserName()
    user.name = "Sakura"
    println(user.name)
}

SAKURA

このように、Kotlinのプロパティではgetter・setterをカスタマイズすることで、データの整形や検証が簡単にできるのが大きな特徴です。

6. Kotlinでのfieldとは？初心者でもわかる解説

6. Kotlinでのfieldとは？初心者でもわかる解説

fieldというキーワードは、getter・setterの中で使われる特別なものです。これはそのプロパティ自体の「中身の値」を表します。

例えると、nameという引き出しの中に入っているメモ用紙そのものがfieldです。getterではこのメモを取り出して読む、setterではこのメモを書き換える、というイメージです。

7. Kotlinでプロパティに対するアクセス制限をつけるには？

7. Kotlinでプロパティに対するアクセス制限をつけるには？

Kotlinでは、getterとsetterに対してアクセス制限（privateやpublic）を個別に設定できます。以下はsetterだけをprivateにして、外から変更できないようにする例です。

class Score {
    var points: Int = 0
        private set
}

このようにすることで、値の読み取りは可能でも、外部から変更できない安全なプロパティを作れます。

まとめ

まとめ

Kotlinにおけるgetterとsetterのカスタマイズは、単に値の取得や設定を行うだけでなく、データの整形や検証、安全性の確保といった目的でも活躍します。特にKotlinは、プロパティに対してデフォルトでgetter・setterを自動生成してくれるため、初学者でも気軽に使い始めることができます。この記事では、自動生成の基本から始まり、getterの加工処理、setterによる条件チェック、さらに両方を組み合わせた応用例までを丁寧に解説してきました。

実務でも、入力チェックや表示形式の統一、ロジックの共通化などに使われることが多いため、覚えておくと非常に便利です。例えばユーザー名を入力する際に、保存時は小文字、表示時は大文字に変える処理をgetter・setterで自然に記述できます。また、マイナスの値や不正な値を防ぐガードとしても強力です。

fieldという特別なキーワードについても紹介しましたが、これはgetter・setterの内部でのみ使える「実際の値そのもの」を指す重要な存在です。このfieldを使って、無限ループを防ぎながら値を操作できるため、getter・setterをカスタマイズする際には欠かせません。

さらに、アクセス制限を活用することで、getter・setterの片方にだけprivateを付けたりして、外部からのアクセスをコントロールすることも可能です。たとえば、得点やIDなど外部から書き換えられては困るデータを、読み取り専用にすることで安全性が保たれます。

以下は、記事内容の総まとめとして、簡単なgetter・setterの応用例です。

class Product {
    var price: Int = 0
        set(value) {
            field = if (value >= 0) value else 0
        }

    var label: String = "sample"
        get() = field.replaceFirstChar { it.uppercaseChar() }
}

fun main() {
    val p = Product()
    p.price = -100
    p.label = "banana"
    println("価格：${p.price}円")
    println("商品名：${p.label}")
}

価格：0円
商品名：Banana

この例では、マイナスの価格が入らないようにしつつ、商品ラベルの最初の文字だけを大文字に変換しています。getterとsetterの両方の機能を活かして、安全で見やすいデータ管理を行う構成になっています。

Kotlinのgetter・setterは、表面的にはシンプルに見えますが、活用すればするほど便利な存在です。初心者のうちから意識的に取り入れておくことで、コードの品質を高める力になります。小さな工夫が将来の大きな差になりますので、ぜひ手を動かして慣れていってください。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

Kotlinのgetterとsetterって何のために使うんですか？

Kotlinのgetter（ゲッター）とsetter（セッター）は、変数の値を取得・代入するときに処理を追加できる仕組みです。たとえば、値を取り出す前に加工したり、代入時にチェックを入れたりできます。

Kotlinでは変数を宣言するだけでgetterとsetterが使えるのは本当ですか？

はい、Kotlinではvarやvalで変数（プロパティ）を定義すると、デフォルトでgetterとsetterが自動生成されます。明示的に書かなくても裏で動作しています。