セッタか否か調べる方法

Question

解らないこと

プログラミング経験のない初心者です。
今、kotlinでandroidアプリ開発に挑戦していて、勉強をしています。

ある書籍で（kotlin対応）

　setOnClickLIstener()メソッドはonClickListenerプロパティのセッタではない。
リスナ設定メソッドは、setOnItemClickListener()のようにプロパティのセッタとなっているものと、
setOnClickLIstener()のように通常のメソッドとなっているものがあります。

との記載がありました。
そして、セッタであるか否かを調べるには、Android Studioに一度記述してみて、
use property access syntax と提案されるのを確認するとのこと。

きちんと確認したいと思い、Androidデベロッパー APIリファレンスを確認しましたが、
恥ずかしながらそれぞれのメソッドが、セッタであるかどうかは解りませんでした。

プロの皆さんはセッタであるかどうかを、どのように確認されているのでしょうか？

宜しく、お願いします。

Answer 1

Android の API はもともと Java で書かれているので、Kotlin としてそれをどう解釈するかという問題になります。そして、API リファレンスには Kotlin 切り替えボタンがありますが、切り替えても Kotlin のプロパティに当たるかどうかは書いてないようです。(Web の API リファレンスは重いので、Cmd/Ctrl-B でソースを参照する人が多いと思います。ソースに加えて Java Doc のドキュメントも読めるし。)

How Does Kotlin Generate Property from Java Getters and Setters (Undocumented by JetBrains) という記事によれば、Java の getter/setter が Kotlin のプロパティとして認識されるには、
・getter が存在すること (getter だけなら read-only のプロパティとなる)
・getter に加えて setter が存在する場合、型がマッチすること
・setter のみの場合、プロパティとは認識されない (Kotlin には set-only のプロパティは存在しないので)
という条件があるそうです。そして、setOnClickListener には対応する getter がないのでプロパティとして認識されず、setOnItemClickListener には対応する getter があるのでプロパティとして認識されるのだと思います。

Comments

[doroidon]

すごく解りやすいご回答、ありがとうございます。

これからも、恥ずかしくなるような質問を連発するかもですがよろしくお願いします。

[hoshi-takanori]

あ、いえ。自分もよく分かってませんでしたが、この質問をきっかけに調べました。調べるきっかけをいただいてありがとうございます。

[doroidon]

あと、Ctrl-B の存在も知らなかったので、、、感謝です。