Kagetaka

net.hizlab.kagetaka.net
クラス HttpClient

java.lang.Object
  拡張net.hizlab.kagetaka.net.NetworkClient
      拡張net.hizlab.kagetaka.net.HttpClient
直系の既知のサブクラス:
HttpsClient

public class HttpClient
extends NetworkClient

HTTP クライアントの基本的な機能を提供します。 このクラスはスレッドセーフではありません。

バージョン:
$Revision: 1.5 $

フィールドの概要
static int DEFAULT_PORT
          デフォルトポート
 
クラス net.hizlab.kagetaka.net.NetworkClient から継承したフィールド
defaultConnectTimeout, defaultOutputEncoding, defaultSoTimeout
 
メソッドの概要
 boolean candoHttpKeepAlive()
          Keep-Alive をサポートしているかどうかを返します。
 void dispose()
          接続を解放します。
static HttpClient getInstance(String protocol, String host, int port, boolean proxy)
          HTTP プロトコルで接続したクライアントのインスタンスを取得します。
 boolean needRetry()
          エラーが発生した場合に、再試行したほうが良いかどうかを返します。
 InputStream send(MessageHeader requests, PosterOutputStream poster, MessageHeader responses, boolean isEmpty, boolean canRelease)
          HTTP リクエストをサーバに送り、レスポンスを返します。
 String toString()
          文字列表現を返します。
 boolean usingProxy()
          プロキシを使用するかどうかを返します。
 
クラス net.hizlab.kagetaka.net.NetworkClient から継承したメソッド
doConnect
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

DEFAULT_PORT

public static final int DEFAULT_PORT
デフォルトポート

関連項目:
定数フィールド値
メソッドの詳細

candoHttpKeepAlive

public boolean candoHttpKeepAlive()
Keep-Alive をサポートしているかどうかを返します。

戻り値:
Keep-Alive をサポートしている場合は true、 サポートしていない場合は false

dispose

public void dispose()
接続を解放します。 Keep-Alive の場合でエラーが発生していなければ、 コネクションは再利用キューに回されます。


getInstance

public static HttpClient getInstance(String protocol,
                                     String host,
                                     int port,
                                     boolean proxy)
                              throws IOException
HTTP プロトコルで接続したクライアントのインスタンスを取得します。

パラメータ:
protocol - プロトコル
host - サーバのホスト
port - サーバのポート
proxy - サーバがプロキシの場合は true、 それ以外の場合は false
戻り値:
HTTP クライアント
例外:
IOException - IO エラーが発生した場合
UnknownHostException - 不明なホストを指定した場合

needRetry

public boolean needRetry()
エラーが発生した場合に、再試行したほうが良いかどうかを返します。

戻り値:
再試行したほうが良い場合は true、 ダメな場合は false

send

public InputStream send(MessageHeader requests,
                        PosterOutputStream poster,
                        MessageHeader responses,
                        boolean isEmpty,
                        boolean canRelease)
                 throws IOException
HTTP リクエストをサーバに送り、レスポンスを返します。

パラメータ:
requests - 送信するリクエストヘッダー
poster - POST データ、無い場合は null
responses - 受信したレスポンスヘッダーを格納するインスタンス
isEmpty - レスポンスの中身が必ず空の場合は true、 それ以外の場合は false
canRelease - レスポンスが空の場合に、接続を開放しても 大丈夫な場合は true、 ダメな場合は false
戻り値:
レスポンスボディを受け取るための入力ストリーム
例外:
IOException - IO エラーが発生した場合

toString

public String toString()
文字列表現を返します。

戻り値:
文字列表現

usingProxy

public boolean usingProxy()
プロキシを使用するかどうかを返します。

戻り値:
プロキシを使用する場合は true、 使用しない場合は false

Kagetaka

Copyright (c) 2002-2004 The Kagetaka Project 'November 20, 2004'