APIリファレンス 使い方
解決済
回答 3
投稿
- 評価
- クリップ 1
- VIEW 5,373
Java、JavaScript、JQuery、PHP辺りを勉強しているのですが、APIリファレンスの使い方がわかりません。
自分が実装してみたい機能があったとして、APIリファレンスでどうやってそれを見つけたらよいのでしょうか?
あと例えば、JavaのArraylistの部分を見たのですが、よくわかりませんでした。説明が難しいのですが、どうやったら理解できたり、実装の仕方がわかるのでしょうか?
質問の説明も合っているのかよくわかりませんが、教えてください。よろしくお願い致します。
-
気になる質問をクリップする
クリップした質問は、後からいつでもマイページで確認できます。
またクリップした質問に回答があった際、通知やメールを受け取ることができます。
クリップを取り消します
-
良い質問の評価を上げる
以下のような質問は評価を上げましょう
- 質問内容が明確
- 自分も答えを知りたい
- 質問者以外のユーザにも役立つ
評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。
質問の評価を上げたことを取り消します
-
評価を下げられる数の上限に達しました
評価を下げることができません
- 1日5回まで評価を下げられます
- 1日に1ユーザに対して2回まで評価を下げられます
質問の評価を下げる
teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。
- プログラミングに関係のない質問
- やってほしいことだけを記載した丸投げの質問
- 問題・課題が含まれていない質問
- 意図的に内容が抹消された質問
- 過去に投稿した質問と同じ内容の質問
- 広告と受け取られるような投稿
評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。
質問の評価を下げたことを取り消します
この機能は開放されていません
評価を下げる条件を満たしてません
質問の評価を下げる機能の利用条件
この機能を利用するためには、以下の事項を行う必要があります。
- 質問回答など一定の行動
-
メールアドレスの認証
メールアドレスの認証
-
質問評価に関するヘルプページの閲覧
質問評価に関するヘルプページの閲覧
checkベストアンサー
+3
こんにちは。
unauさんの「APIリファレンスは手段なので、作りたいものを作り始めたら、自然とAPIリファレンスを読むので慣れるはず」というアプローチと、dsuzukiさんの挙げられている、「逆引き」本の実装例から、APIリファレンスを参照して理解を深めるという方法、いずれも効果的だと思います。
私の提案として、これら加えて、もう二点ほど挙げます。
1.入門書ではない書籍に挑戦する。
Javaであれば、具体的には
といったあたりです。
ただし、これらは、APIリファレンスに書いてある内容の理解度を深めてくれることになるとは思いますが、Javaである程度、実践を積んでからのほうがよいかもしれません。
なお、上記で実践というのは、「開発に使える時間を決められて、ある機能要件を満たすものを作らないといけないという、差し迫った状況」を意味しています。
2.欲しいAPIリファレンスに早くたどり着くために英語力を高める。
ご質問の中には、おそらく
「何か目的を果たすプログラムを作ろうとして、そのために必要なクラスやメソッドが分からないから、そもそもAPIリファレンスのどこを見たらよいかも分からない」
という問題も含まれているものと思います。それはどうやったら解消されるか(あるいは、自己解決する力がつけられるか)について、メソッドとクラスの順に以下、書きます。
まず、メソッド名については、たくさんプログラムを書いているうちに、類推できるようになります。何かを取得するメソッドだったら、getやfindから始まってその後欲しいものが英語になっているメソッドがないか探してみればよいかと思います。逆にいうと、一度使ってみたメソッドの名前に意識を向けて、次に、同じような機能のメソッドが必要になったときにそれを類推できるように、普段から心がけておくとよいでしょう。値を取得するメソッドはたいていgetで始まりますが、findもあれば、fetchも使われますし、retrieveなんてのも使われる。これらのように、同じ「取得する」でも複数の動詞があり、これらの微妙なニュアンスの違いも意識して自分のものにしておけば、APIリファレンスを「こういうメソッド、ないかな?」という調べ方であたるときに、欲しいメソッドに早くたどり着けるようになります。
次にクラスですが、これは例を挙げます。
たとえば今、複素数を使うプログラムをJAVAで書きたいとしましょう。
今これを書いている時点で、実はこの私も、複素数クラスを誰かが既に書いているとは思うけど、誰が作っていて、どこからダウンロードしたらいいのか、APIドキュメントがどこにあるのかわかりません。
そのときはまんまGoogleで検索してしまいます。複素数は英語で、complexですから
「complex java api」
あたりでググります。
すると、(ラッキーなことに)一番上に
Complex (Apache Commons Math 3.6.1 API)
が出てくるので、Apache commonsのライブラリを入手して、このComplexのJavaDOCを読めば、おそらくほとんどやりたいことは解決できるのではないでしょうか。
上記で、メソッド名を推定するにしても、自分の欲しい機能を提供してくれるクラスの名前で検索するにしても、上記の例でいえば、「複素数」と言われて、「complex」がすぐ思いつくかで、正解にたどり着くスピードが変わってきますので、英語に慣れるのが効果的という結論になるのですが、分からない単語も和英辞典で調べることを習慣にしていけばよいと思います。
たとえば、何かの製品の受発注システムを作るときに「注文」というクラスを書く場面があったときに、「注文」の英訳が分からないからといって、和英辞典で引く手間を惜しんで、ローマ字まんまの
public class Chuumon
なんていうクラスを書くのはダメで、和英辞典で調べてちゃんと
public class Order
というクラス名にするとかです。そういう細かいところで差がつくと思います。
以上、ご参考になれば幸いです。
投稿
-
回答の評価を上げる
以下のような回答は評価を上げましょう
- 正しい回答
- わかりやすい回答
- ためになる回答
評価が高い回答ほどページの上位に表示されます。
-
回答の評価を下げる
下記のような回答は推奨されていません。
- 間違っている回答
- 質問の回答になっていない投稿
- スパムや攻撃的な表現を用いた投稿
評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。
+3
szk24 さんが、まだ API リファレンスを見てプログラミングできるだけの経験を積まれていない、ということではないかと思います。2, 3 種類のプログラミング言語である程度まとまってものを作ったりすれば、まったく新しいプログラミング言語やライブラリなどのリファレンスのどこをどうやって調べればいいかのアタリがつくようになるはずです。
まずは、その言語の入門書で勉強されるほうがよいと思います。それである程度自由に作りたいものが作れるようになったときには、自然と API リファレンスを使いこなせるようになっていることでしょう。API リファレンスを使いこなすことは目的ではなく手段のはずです。そこに目標を置くのではなく、自分が作りたいものをしっかりイメージして、それを実現すべくもがいているうちに、手段として使えるようになるのではないでしょうか。
投稿
-
回答の評価を上げる
以下のような回答は評価を上げましょう
- 正しい回答
- わかりやすい回答
- ためになる回答
評価が高い回答ほどページの上位に表示されます。
-
回答の評価を下げる
下記のような回答は推奨されていません。
- 間違っている回答
- 質問の回答になっていない投稿
- スパムや攻撃的な表現を用いた投稿
評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。
+2
書籍で「逆引き」リファレンスが複数あります。
Java逆引きハンドブックなど。いわゆるレシピ集です。
これらで作りたい機能をどのように実装するのかを学び、そこで利用されているクラスやメソッドの詳細を知るためにAPIリファレンスを参照する、というのはどうでしょうか。
投稿
-
回答の評価を上げる
以下のような回答は評価を上げましょう
- 正しい回答
- わかりやすい回答
- ためになる回答
評価が高い回答ほどページの上位に表示されます。
-
回答の評価を下げる
下記のような回答は推奨されていません。
- 間違っている回答
- 質問の回答になっていない投稿
- スパムや攻撃的な表現を用いた投稿
評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。
15分調べてもわからないことは、teratailで質問しよう!
- ただいまの回答率 88.35%
- 質問をまとめることで、思考を整理して素早く解決
- テンプレート機能で、簡単に質問をまとめられる
2016/04/18 09:01
入門書以上の本を読んでみます。あと、メソッド名や英語に慣れていきたいと思います。
ありがとうございました。