JavaFX APIリファレンスについて

Question

JAVAの初心者です。説明が下手ですいませんが、以前の質問に

リファレンスを頻繁に確認してクラス・メソッドの使い方をだんだんと把握していく

と書かれていたんですが、JavaFX APIリファレンスを見てもそういうものが詳しく書かれていないように見えます。

まだ慣れてないところもありますが、例えばshowOpenDialogの仕様を見てもそんなものは書かれていないように見えます。

さらに、

７．で、選択したファイルはどうやって受け取ってくるんだ…？リファレンスを読もう…

お、getSelectedFile()メソッドあるじゃん！じゃあコレを使って…

と書かれていたんですが、リファレンスを見てもそんなメソッドはありませんでした。
リファレンスの見方が間違っているのか、どうもリファレンスを読んでもそんなメソッドがないんです。

リファレンスの見方が間違っているのでしょうか？

Answer 1

リファレンスはクラスの情報(メソッドの引数、挙動、戻り値など)が書かれているだけです。
リファレンスは逆引き辞典ではないので、自分がやりたいことに対する解決策が記述されている訳ではありません。(書いてあることもありますが)
つまりリファレンスを読んでもクラスの使い方が分かるだけで、目的を達成する方法を知ることができるとは限らないのです。

リファレンスを頻繁に確認してクラス・メソッドの使い方をだんだんと把握していく

これは文字通り、「どのクラスのどのメソッドを利用するとどのようなことが起こるか」を把握するということです。
換言すると、「自分の目的を達成するためにどのクラスのどのメソッド(など)が利用できるかを予め把握しておくための予備知識を蓄える活動」です。

リファレンスを見てもそんなメソッドはありませんでした。

リファレンスの見方が間違っているのか、どうもリファレンスを読んでもそんなメソッドがないんです。
リファレンスの見方が間違っているのでしょうか？

語弊を恐れずに答えると、間違っています。
リファレンスは単に目的を達成するためのメソッドの存在の確認、もしくは使用したいメソッドの詳細の確認に利用するのです。
誰かに教えて貰ったメソッドの存在が確認できなかったからといって右往左往するのはおかしいと思います。
無い物は無いのです。
そこに疑問を挟む余地はありません。

前回の回答内容に固執せずにshowOpenDialog()の詳細を読みましょう。
「戻り値は選択したファイル」という旨の記述があるはずです。
これは回答が(少なくともJavaFX 8においては)誤っているということでしょう。
何よりも一次ソースを信用してください。
これが「リファレンスを読め」という意味です。

Answer 2

showOpenDialogの仕様を見ても

前回の質問の内容はshowOpenDialogの第一引数にWindowを渡さなければならないのにFileを渡すという間違いを知るには・・・という意味合いだったはずです。その点についてはリファレンスを見ることで「第一引数はFileではない」ことだけはわかります。

クラス・メソッドの使い方をだんだんと把握していく

確かにクラス・メソッドの使い方はリファレンスを読めばそれだけでわかるものではないですね。同意します。リファレンスから重要な情報を読み取るには書いてあることを把握するための知識が必要です。また「このように設計されているはずである・されているだろう」という常識もある程度必要でしょう。

これに対する即効性の特効薬はないと思います。残念ながら「地道にバックグラウンドの知識を増やす」ことが必要です。そのためにファレンスを読むのもこれまた一つのやり方ではあります。が、単に特定の項目を読むだけでなく関連しそうな多くの項目を見て知識を増やす必要があると思います。そう考えればリファレンスを読むだけでは時間がかかりすぎるのも事実なので、サンプルを見てどういう作法なのかを把握したり解説書などを読んで情報を得たりといったことも必要だと思います。

質問者さんがおっしゃるようにリファレンスをみることが全ての解決策ではないとは思いますが、だとしてもリファレンスを見る習慣はやはり大事だと思います。あるとき突然リファレンスが読めるようには多分ならないと思うからです。また少なくとも「どんな型の引数をどの順に指定して戻り値は何か」は絶対に必要な情報ですよね？

---

追記：一般論はさておいてJavaFXについてコメントします。
特にJavaFXについてはCarimaticsさんがおっしゃる「一次ソースを信用」というのがとても重要だと感じます。NishidaRyu416_さんのコメントにあるようにまだ仕様が流動的だからです。例えばネット上サンプルには古い仕様のJavaFX Scriptで記述されているものも散見されますが今はこの仕様はないですね。結局信用できるのは最新のAPIリファレンス（あるいは残念なことにJDKのソースだったりする）になってしまうのですね。十分に枯れていないソフトウェアではこうしたことがよくあると思います。上の回答で述べたこととはちょっと意味合いが違いますがそういう観点でも信用できる情報源としてリファレンスを見ることが大事と感じます。

Answer 3

メソッドって廃止されたりするものですよ、特にJavaFXってScriptみたいなやつ導入されたと思ったら無くなったりとか、方向性が定まっていない気がw
ちなみに僕はJavaFX情報が不足していたし、すぐに変わっていたので
古いですがSwingを使ってます。
リンク
調べてみたところ廃止などされておらずきちんとありましたよSwingのクラスとして,JavaFXからもSwingのクラス使えたと思うので頑張って下さい！

Comments

[KSwordOfHaste]

質問の本題からははずれますが、自分はjava8でのswingのデグレード(Java7で正常な表示なのに、Java8で表示が崩れる)をきっかけにJavaFXが標準になったことを知りJavaFXを学び始めました。しかし・・・
> JavaFX情報が不足していたし、すぐに変わっていたの
ここはおっしゃるとおりと思っています。まだまだ流動的な部分も多そうなのでそれで混乱したくない場合はしばらくswingを利用する選択もありですね。