4

人々は一般的に、API ドキュメントとコードを使用していると言います。

私はJAVA言語は比較的大丈夫です。つまり、簡単なプログラムを書くことができます。最近取り組んでいるプロジェクトで、SOAPUI ツールの作業を依頼され、Groovy でコードを記述するための SOAPUI API を読んでいます。そうこうしているうちに、こんな質問が来ました。

API ドキュメントの使用を開始する方法 (任意の言語/もの)? たとえば、Google Map API または Yahoo 開発者 API の使用を開始したいとします。

API を読んで理解する構造化された方法はありますか? どのクラスを最初に使用するか、またはさまざまなメソッドを呼び出しまたは使用する方法。

特定の API を読む前に何をすべきか、また、API を読んで理解することで物事の作成に慣れ、その上に物事を構築し始めるにはどうすればよいでしょうか?

これを行うために必要なスキルは何ですか？そのようなスキルを開発する方法。

4

4 に答える 4

4

チュートリアルとサンプルコードから始めることをお勧めします。実際、API ドキュメントは一種のリファレンスです。

于 2010-09-17T10:31:51.800 に答える
1

新しいツール/APIを使い始めるとき、私は常に最初にドキュメントを読んで、それが何であるか/何をするか/どのように機能するかについての概要を理解します。ドキュメントは通常、チュートリアルを指しています。これは私が次に行うことです。次に、APIをかなり簡単な方法で使用する独自の非常に単純なテストアプリを作成してみます。

この時点で、私はメインクラスを理解し、通常はそれらのjavadocsを読む必要があります。必要な場合にのみ、他のあまり使用されていないクラスや追加機能に実際にアクセスします。

于 2010-09-17T10:40:33.747 に答える
1
  1. APIを完全に読み、各メソッド呼び出しの要件を理解してください。たとえば、一部の呼び出しはGET/POSTメソッドです。それらが必要とするパラメータとそれらが返す応答を理解します。
  2. APIで遊んでください。通常、API呼び出しなどで遊ぶことができるサンドボックスシステムがあります。
  3. 独自のコードを作成し（好きなように）、APIのフローを理解するまでそれを試してみてください。

コツをつかんだら、APIに最適なアーキテクチャを設計します。本質的に、APIを理解するには、ドキュメントを読むことが不可欠です。

お役に立てれば。

于 2010-09-17T10:43:31.443 に答える
0

私は最近、それらを理解しようとしていました。主に、テスト ケースのテスト スクリプトを作成する際にアクセスできるオブジェクトを追跡しようとしていました。API に関連して、ログ、コンテキスト、testStep などのタイプを把握するのに苦労していました。私にとって、エラー メッセージは宝の山でした。私が何か間違ったことをしようとしたとき、それはオブジェクトのタイプが何であるかを明確に示し、API の正しい方向を示してくれました。

Groovy について最初から十分に注意深く読まなかった場合 (私のように) 誰かが役に立つかもしれないループに私を投げ込んだもう 1 つのことは、Groovy がゲッターまたはセッターを呼び出す必要なくすべてのプロパティを公開することです。したがって、 myObj.myProp = 5 のようなものは、API の setMyProp(5) メソッドに対応します。簡単なことですが、いくつかのことは初めてで頭を悩ませていました!

于 2010-09-21T19:14:32.610 に答える