Java API仕様の読み方．

1. ネットワークプログラミング 応用演習 第4回 ネットワーク 2011/10/12

2. コンストラクタとメソッド P.8 16行目 オブジェクト指向言語の用語 ・クラス ≒ 設計図 ・インスタンス ≒ 実体（newで生成） PrintWriter writer = new PrintWriter( ...以下略... 設計図 PrintWriter ←newにより 生成される

3. コンストラクタとメソッド オブジェクト指向言語の用語 ・クラス ≒ 設計図 ・インスタンス ≒ 実体（newで生成） PrintWriter writer = new PrintWriter( ...以下略... writer 設計図 PrintWriter

4. 実際の動作の調べ方 http://java.sun.com/j2se/1.4/ja/docs/ja/api/ または http://java.sun.com/javase/ja/6/docs/ja/api/ にアクセスし 赤い枠から クラスを選択して

5. 実際の動作の調べ方 該当する項目を探す

6. Java API仕様の見方 たくさんの項目があるが，先頭から (1)クラスの継承図 (2)説明 (3)フィールドの概要 (4)コンストラクタの概要 (5)メソッドの概要 (6)フィールドの詳細 (7)コンストラクタの詳細 (8)メソッドの詳細 の順番で並んでいる

7. クラスの継承図 java.io.PrintWriter と書いてあるので，先頭に import java.io.* が必要． または，プログラムの中にいちいち java.io.PrintWriter と書く．

8. コンストラクタ 簡単に言うと，newの処理 PrintWriter writer = new PrintWriter( socket.getOutputStream() ); 例えば，↑が実行されるときの処理． コンストラクタは4種類あるけどどれ？ PrintWriter( OutputStream out ) PrintWriter( OutputStream out, booleanautoFlash ) PrintWriter( Writer out ) PrintWriter( Writer out, booleanautoFlash )

9. オーバーロード Java言語では，同じ名前のメソッドを定義可能． 実際に使われるメソッドは，パラメータによって 自動的に判別される． 下記のメソッドが用意されているとき， dummy(1); で実行されるのはどっち？ void dummy( int a ) { System.out.println( "パラメータがint型一つ" ); } void dummy( ) { System.out.println( "パラメータ無し" ); }

10. 実行されるコンストラクタをさがそう PrintWriter writer = new PrintWriter( socket.getOutputStream() ); socket.getOutputStram() って何だ？ まず，変数宣言を確認する． Socket socket = new Socket(); socketには「new Socket()」が代入されているので，SocketクラスのgetOutputStreamを調べる．

11. メソッドの探し方 先に示したURLから，Socketクラスを開き， メソッドの詳細からgetOutputStreamを探す． パラメータは無し． 戻り値の型 public OutputStreamgetOutputStream() throws IOException 発生する可能性のある例外 と言う具合に，OutputStream型を返す メソッドであることが分かる．

12. 該当するコンストラクタ PrintWriter writer = new PrintWriter( socket.getOutputStream() ); よって，該当するコンストラクタは PrintWriter( OutputStream out ) PrintWriter( OutputStream out, booleanautoFlash ) PrintWriter( Writer out ) PrintWriter( Writer out, booleanautoFlash ) であることが分かる． 詳しい説明も読んでおこう．

13. 便利なコンストラクタを探す PrintWriter( OutputStream out ) PrintWriter( OutputStream out, booleanautoFlash ) PrintWriter( Writer out ) PrintWriter( Writer out, booleanautoFlash ) ん？このコンストラクタって何だ？ Java言語では，同じ働きをするコンストラクタやメソッドが多数定義されている．仕様書によるとautoFlushにtrueを与えると，便利そうである． よって，以下のように書き換えることもできる． PrintWriter writer = new PrintWriter( socket.getOutputStream(), true );

14. 課題4-e プログラムから実行される ・全てのコンストラクタ ・全てのメソッド に関してJava API仕様書で確認し， 発生する可能性のある例外を調べる． ついでに，コンストラクタやメソッドの 説明にも目を通しておくこと．

15. 課題4-f 以下のように，実行時に接続先の ホスト名とポート番号を指定できるようにする $ java Test41 localhost8000 プログラムの6行目が以下のようになる InetSocketAddresssocketAddress = new InetSocketAddress( args[0], Integer.parseInt( args[1] ) );

16. 課題4-f このように改造すると， コマンドラインパラメータに何も指定しないと 例外が発生する． しかし，実行方法を知らない人から見ると， 「実行したらエラーが出た」としか映らない． そこで，コマンドラインパラメータが無い 場合には， ・プログラムの目的 ・プログラムの使い方 ・実行例 を表示することが望ましい．