HttpConnection (Unofficial 'CLDC 1.1 + MIDP 2.0' API Reference.)

URL をオープンするために Connector.open を使用します。この結果 StreamConnection を返します。この StreamConnection から InputStream をオープンします。 InputStream を使用してファイルの終端 (-1 が返されるまで ) 全ての文字を読み出します。例外が throw された場合、Connection および Stream をクローズします。

      void getViaStreamConnection(String url) throws IOException {
          StreamConnection c = null;
          InputStream s = null;
          try {
              c = (StreamConnection)Connector.open(url);
              s = c.openInputStream();
              int ch;
              while ((ch = s.read()) != -1) {
                  ...
              }
          } finally {
              if (s != null) 
                  s.close();
              if (c != null)
                  c.close();
          }
      }

ContentConnection の使用例

ContentConnection を使用したシンプルな URL からの読み出しです。 HTTP 特有の振る舞いは必要としないか使用しません。

URL をオープンするために Connector.open を使用します。この結果 ContentConnection を返します。 ContentConnection は長さを提供することができます。長さが提供される場合、それは保持するデータを読むために使用することができます。この ContentConnection から InputStream をオープンします。 InputStream を使用してファイルの終端 (-1 が返されるまで ) 全ての文字を読み出します。例外が throw された場合、Connection および Stream をクローズします。

      void getViaContentConnection(String url) throws IOException {
          ContentConnection c = null;
          InputStream is = null;
          try {
              c = (ContentConnection)Connector.open(url);
              int len = (int)c.getLength();
              if (len > 0) {
                  is = c.openInputStream();
                  byte[] data = new byte[len];
                  int actual = is.read(data);
                  ...
              } else {
                  int ch;
                  while ((ch = is.read()) != -1) {
                      ...
                  }
              }
          } finally {
              if (is != null)
                  is.close();
              if (c != null)
                  c.close();
          }
      }

HttpConnection の使用例

HttpConnection を使用し、HTTP ヘッダおよびデータを読み出します。

URL をオープンするために Connector.open を使用します。この結果 ContentConnection を返します。 HTTP ヘッダを読み出して処理します。長さが提供される場合、それは保持するデータを読むために使用することができます。この HttpConnection から InputStream をオープンします。 InputStream を使用してファイルの終端 (-1 が返されるまで ) 全ての文字を読み出します。例外が throw された場合、Connection および Stream をクローズします。

      void getViaHttpConnection(String url) throws IOException {
          HttpConnection c = null;
          InputStream is = null;
          try {
              c = (HttpConnection)Connector.open(url);
  
              // InputSream を取得すると、接続を開き HTTP ヘッダを取得します。
              // これらは要求があるまで格納されます。
              is = c.openInputStream();
  
              // Content-Type を取得します。
              String type = c.getType();
  
              // 処理対象データの長さを取得します。
              int len = (int)c.getLength();
              if (len > 0) {
                  byte[] data = new byte[len];
                  int actual = is.read(data);
                  ...
              } else {
                  int ch;
                  while ((ch = is.read()) != -1) {
                      ...
                  }
              }
          } finally {
              if (is != null)
                  is.close();
              if (c != null)
                  c.close();
          }
      }

HttpConnection による POST の使用例

サーバーへいくつかのヘッダと内容をリクエストにて送信し、レスポンスとして返されたヘッダおよび内容を処理します。

URL をオープンするために Connector.open を使用します。この結果 ContentConnection を返します。リクエスト・メソッドを使用して POST およびリクエストヘッダをセットします。簡単なコマンドを書き込んでフラッシュします。 HTTP ヘッダを読み出して処理します。長さが提供される場合、それは保持するデータを読むために使用することができます。この HttpConnection から InputStream をオープンします。 InputStream を使用してファイルの終端 (-1 が返されるまで ) 全ての文字を読み出します。例外が throw された場合、Connection および Stream をクローズします。

     void postViaHttpConnection(String url) throws IOException {
         HttpConnection c = null;
         InputStream is = null;
         OutputStream os = null;
 
         try {
             c = (HttpConnection)Connector.open(url);
 
             // リクエスト・メソッドとヘッダを設定します。
             c.setRequestMethod(HttpConnection.POST);
             c.setRequestProperty("If-Modified-Since",
                 "29 Oct 1999 19:43:31 GMT");
             c.setRequestProperty("User-Agent",
                 "Profile/MIDP-2.0 Configuration/CLDC-1.0");
             c.setRequestProperty("Content-Language", "en-US");
 
             // OutputStream を経由してヘッダを書き込んでフラッシュします。
             os = c.openOutputStream();
             os.write("LIST games\n".getBytes());
             os.flush();
 
             // InputStream をオープンすると接続を開いて HTTP ヘッダを読みます。
             // それらは要求があるまで蓄えられます。
             is = c.openInputStream();
 
             // Content-Type を取得します。
             String type = c.getType();
             processType(type);
 
             // 長さとデータを取得して処理します。
             int len = (int)c.getLength();
             if (len > 0) {
                 byte[] data = new byte[len];
                 int actual = is.read(data);
                 process(data);
             } else {
                 int ch;
                 while ((ch = is.read()) != -1) {
                     process((byte)ch);
                 }
             }
         } finally {
             if (is != null)
                 is.close();
             if (os != null)
                 os.close();
             if (c != null)
                 c.close();
         }
     }

Connector における単純化された Stream オープン・メソッド

Connector クラスは以下に示す、指定された URL から入力あるいは出力するための Stream を直接生成するメソッドを提供しています。

これらのメソッドを使用することで一部機能に制限が生じることを理解しておく必要があります。これらのメソッドは直接 Stream を生成するため、実際の Connection を得る手段が提供されません。このため Connection へのアクセスを必要とする以下のメソッドは一切呼び出すことができません。

getRequestMethod()
setRequestMethod(java.lang.String)
getRequestProperty(java.lang.String)
setRequestProperty(java.lang.String, java.lang.String)
ContentConnection.getLength()
ContentConnection.getType()
ContentConnection.getEncoding()
getHeaderField(java.lang.String)
getResponseCode()
getResponseMessage()
getHeaderFieldInt(java.lang.String, int)
getHeaderFieldDate(java.lang.String, long)
getExpiration()
getDate()
getLastModified()
getHeaderField(java.lang.String)
getHeaderFieldKey(int)

導入されたバージョン:: MIDP 1.0

フィールドの概要
`static String`	`GET` GET メソッドを示す定数（`="GET"`）です。
`static String`	`HEAD` HEAD メソッドを示す定数（`="HEAD"`）です。
`static int`	`HTTP_ACCEPTED` HTTP ステータス・コード (`202`) の比較用定数です。
`static int`	`HTTP_BAD_GATEWAY` HTTP ステータス・コード (`502`) の比較用定数です。
`static int`	`HTTP_BAD_METHOD` HTTP ステータス・コード (`405`) の比較用定数です。
`static int`	`HTTP_BAD_REQUEST` HTTP ステータス・コード (`400`) の比較用定数です。
`static int`	`HTTP_CLIENT_TIMEOUT` HTTP ステータス・コード (`408`) の比較用定数です。
`static int`	`HTTP_CONFLICT` HTTP ステータス・コード (`409`) の比較用定数です。
`static int`	`HTTP_CREATED` HTTP ステータス・コード (`201`) の比較用定数です。
`static int`	`HTTP_ENTITY_TOO_LARGE` HTTP ステータス・コード (`413`) の比較用定数です。
`static int`	`HTTP_EXPECT_FAILED` HTTP ステータス・コード (`417`) の比較用定数です。
`static int`	`HTTP_FORBIDDEN` HTTP ステータス・コード (`403`) の比較用定数です。
`static int`	`HTTP_GATEWAY_TIMEOUT` HTTP ステータス・コード (`504`) の比較用定数です。
`static int`	`HTTP_GONE` HTTP ステータス・コード (`410`) の比較用定数です。
`static int`	`HTTP_INTERNAL_ERROR` HTTP ステータス・コード (`500`) の比較用定数です。
`static int`	`HTTP_LENGTH_REQUIRED` HTTP ステータス・コード (`411`) の比較用定数です。
`static int`	`HTTP_MOVED_PERM` HTTP ステータス・コード (`301`) の比較用定数です。
`static int`	`HTTP_MOVED_TEMP` HTTP ステータス・コード (`302`) の比較用定数です。
`static int`	`HTTP_MULT_CHOICE` HTTP ステータス・コード (`300`) の比較用定数です。
`static int`	`HTTP_NO_CONTENT` HTTP ステータス・コード (`204`) の比較用定数です。
`static int`	`HTTP_NOT_ACCEPTABLE` HTTP ステータス・コード (`406`) の比較用定数です。
`static int`	`HTTP_NOT_AUTHORITATIVE` HTTP ステータス・コード (`203`) の比較用定数です。
`static int`	`HTTP_NOT_FOUND` HTTP ステータス・コード (`404`) の比較用定数です。
`static int`	`HTTP_NOT_IMPLEMENTED` HTTP ステータス・コード (`501`) の比較用定数です。
`static int`	`HTTP_NOT_MODIFIED` HTTP ステータス・コード (`304`) の比較用定数です。
`static int`	`HTTP_OK` HTTP ステータス・コード (`200`) の比較用定数です。
`static int`	`HTTP_PARTIAL` HTTP ステータス・コード (`206`) の比較用定数です。
`static int`	`HTTP_PAYMENT_REQUIRED` HTTP ステータス・コード (`402`) の比較用定数です。
`static int`	`HTTP_PRECON_FAILED` HTTP ステータス・コード (`412`) の比較用定数です。
`static int`	`HTTP_PROXY_AUTH` HTTP ステータス・コード (`407`) の比較用定数です。
`static int`	`HTTP_REQ_TOO_LONG` HTTP ステータス・コード (`414`) の比較用定数です。
`static int`	`HTTP_RESET` HTTP ステータス・コード (`205`) の比較用定数です。
`static int`	`HTTP_SEE_OTHER` HTTP ステータス・コード (`303`) の比較用定数です。
`static int`	`HTTP_TEMP_REDIRECT` HTTP ステータス・コード (`307`) の比較用定数です。
`static int`	`HTTP_UNAUTHORIZED` HTTP ステータス・コード (`401`) の比較用定数です。
`static int`	`HTTP_UNAVAILABLE` HTTP ステータス・コード (`503`) の比較用定数です。
`static int`	`HTTP_UNSUPPORTED_RANGE` HTTP ステータス・コード (`416`) の比較用定数です。
`static int`	`HTTP_UNSUPPORTED_TYPE` HTTP ステータス・コード (`415`) の比較用定数です。
`static int`	`HTTP_USE_PROXY` HTTP ステータス・コード (`305`) の比較用定数です。
`static int`	`HTTP_VERSION` HTTP ステータス・コード (`505`) の比較用定数です。
`static String`	`POST` POST メソッドを示す定数（`="POST"`）です。

メソッドの概要
`long`	`getDate()` HTTP レスポンス・ヘッダ・フィールドで示された送信日時（`Date`）を返します。
`long`	`getExpiration()` HTTP レスポンス・ヘッダ・フィールドで示された有効期限（`Expires`）を返します。
`String`	`getFile()` 保持しているＵＲＬからファイル名部分を取り出して返します。
`String`	`getHeaderField(int n)` HTTP レスポンス・ヘッダ・フィールドから指定行数目のフィールド値を取得して返します。
`String`	`getHeaderField(String name)` HTTP レスポンス・ヘッダ・フィールドから任意のフィールド名に対応するフィールド値を返します。
`long`	`getHeaderFieldDate(String name, long def)` HTTP レスポンス・ヘッダ・フィールドから任意のフィールド名に対応するフィールド値を日付として分析して返します。
`int`	`getHeaderFieldInt(String name, int def)` HTTP レスポンス・ヘッダ・フィールドから任意のフィールド名に対応するフィールド値を `int` 型の値で返します。
`String`	`getHeaderFieldKey(int n)` HTTP レスポンス・ヘッダ・フィールドから指定行数目のフィールド名を取得して返します。
`String`	`getHost()` 接続先のホスト情報を保持しているＵＲＬから取り出して返します。
`long`	`getLastModified()` HTTP レスポンス・ヘッダ・フィールドで示された最終更新日時（`Last-Modified`）を返します。
`int`	`getPort()` 保持しているＵＲＬからターゲットのネットワーク・ポート番号を返します。
`String`	`getProtocol()` コネクションが使用するプロトコル（`http` あるいは `https`）を保持しているＵＲＬから取り出して返します。
`String`	`getQuery()` 保持しているＵＲＬからクエリー（ＵＲＬの「`?`」より後ろでリファレンスを除いた部分）を取り出して返します。
`String`	`getRef()` 保持しているＵＲＬからリファレンス（ＵＲＬの「`#`」より後ろの部分）を取り出して返します。
`String`	`getRequestMethod()` 現在設定されているリクエスト・メソッドを文字列返します。
`String`	`getRequestProperty(String key)` コネクションで保持しているリクエスト・ヘッダ・フィールドから指定キー名の値を返します。
`int`	`getResponseCode()` HTTP レスポンス・コード（ステータス・コード）を返します。
`String`	`getResponseMessage()` HTTP レスポンス・メッセージ（ステータス・メッセージ）を返します。
`String`	`getURL()` コネクションが保持しているＵＲＬを返します。
`void`	`setRequestMethod(String method)` リクエスト・メソッドを設定します。
`void`	`setRequestProperty(String key, String value)` リクエスト・プロパティ（リクエスト・ヘッダ・フィールド）の指定キー名に値を設定します。

インタフェース javax.microedition.io.ContentConnection から継承されたメソッド
`getEncoding, getLength, getType`

インタフェース javax.microedition.io.InputConnection から継承されたメソッド
`openDataInputStream, openInputStream`

インタフェース javax.microedition.io.OutputConnection から継承されたメソッド
`openDataOutputStream, openOutputStream`

インタフェース javax.microedition.io.Connection から継承されたメソッド
`close`

フィールドの詳細

HEAD

static final String HEAD

HEAD メソッドを示す定数（="HEAD"）です。

関連項目:: 定数フィールド値

GET

static final String GET

GET メソッドを示す定数（="GET"）です。

関連項目:: 定数フィールド値

POST

static final String POST

POST メソッドを示す定数（="POST"）です。

関連項目:: 定数フィールド値

HTTP_OK

static final int HTTP_OK

HTTP ステータス・コード (200) の比較用定数です。
要求が処理されたとを示します。

関連項目:: 定数フィールド値

HTTP_CREATED

static final int HTTP_CREATED

HTTP ステータス・コード (201) の比較用定数です。
作成されたことを示します。

関連項目:: 定数フィールド値

HTTP_ACCEPTED

static final int HTTP_ACCEPTED

HTTP ステータス・コード (202) の比較用定数です。
許可されたことを示します。

関連項目:: 定数フィールド値

HTTP_NOT_AUTHORITATIVE

static final int HTTP_NOT_AUTHORITATIVE

HTTP ステータス・コード (203) の比較用定数です。
不正な情報であったことを示します。

関連項目:: 定数フィールド値

HTTP_NO_CONTENT

static final int HTTP_NO_CONTENT

HTTP ステータス・コード (204) の比較用定数です。
コンテンツが無いことを示します。

関連項目:: 定数フィールド値

HTTP_RESET

static final int HTTP_RESET

HTTP ステータス・コード (205) の比較用定数です。
コンテンツをリセットすることを示します。

関連項目:: 定数フィールド値

HTTP_PARTIAL

static final int HTTP_PARTIAL

HTTP ステータス・コード (206) の比較用定数です。
部分的なコンテンツであることを示します。

関連項目:: 定数フィールド値

HTTP_MULT_CHOICE

static final int HTTP_MULT_CHOICE

HTTP ステータス・コード (300) の比較用定数です。
複数選択されたことを示します。

関連項目:: 定数フィールド値

HTTP_MOVED_PERM

static final int HTTP_MOVED_PERM

HTTP ステータス・コード (301) の比較用定数です。
永続的に移動されたことを示します。

関連項目:: 定数フィールド値

HTTP_MOVED_TEMP

static final int HTTP_MOVED_TEMP

HTTP ステータス・コード (302) の比較用定数です。
一時的に移動されたことを示します。

関連項目:: 定数フィールド値

HTTP_SEE_OTHER

static final int HTTP_SEE_OTHER

HTTP ステータス・コード (303) の比較用定数です。
他を参照するようにという要求を示します。

関連項目:: 定数フィールド値

HTTP_NOT_MODIFIED

static final int HTTP_NOT_MODIFIED

HTTP ステータス・コード (304) の比較用定数です。
変更されていないことを示します。

関連項目:: 定数フィールド値

HTTP_USE_PROXY

static final int HTTP_USE_PROXY

HTTP ステータス・コード (305) の比較用定数です。
PROXY を使用することを要求していることを示します。

関連項目:: 定数フィールド値

HTTP_TEMP_REDIRECT

static final int HTTP_TEMP_REDIRECT

HTTP ステータス・コード (307) の比較用定数です。
指定されたページは一時的に移動していることを示します。

関連項目:: 定数フィールド値

HTTP_BAD_REQUEST

static final int HTTP_BAD_REQUEST

HTTP ステータス・コード (400) の比較用定数です。
不正な要求を示します。

関連項目:: 定数フィールド値

HTTP_UNAUTHORIZED

static final int HTTP_UNAUTHORIZED

HTTP ステータス・コード (401) の比較用定数です。
認証されていないことを示します。

関連項目:: 定数フィールド値

HTTP_PAYMENT_REQUIRED

static final int HTTP_PAYMENT_REQUIRED

HTTP ステータス・コード (402) の比較用定数です。
支払いが必要なことを示します。

関連項目:: 定数フィールド値

HTTP_FORBIDDEN

static final int HTTP_FORBIDDEN

HTTP ステータス・コード (403) の比較用定数です。
禁止されていることを示します。

関連項目:: 定数フィールド値

HTTP_NOT_FOUND

static final int HTTP_NOT_FOUND

HTTP ステータス・コード (404) の比較用定数です。
見つからなかったことを示します。

関連項目:: 定数フィールド値

HTTP_BAD_METHOD

static final int HTTP_BAD_METHOD

HTTP ステータス・コード (405) の比較用定数です。
使用できないメソッドであることを示します。

関連項目:: 定数フィールド値

HTTP_NOT_ACCEPTABLE

static final int HTTP_NOT_ACCEPTABLE

HTTP ステータス・コード (406) の比較用定数です。
許容されなかったことを示します。

関連項目:: 定数フィールド値

HTTP_PROXY_AUTH

static final int HTTP_PROXY_AUTH

HTTP ステータス・コード (407) の比較用定数です。
PROXY の認証が必要であることを示します。

関連項目:: 定数フィールド値

HTTP_CLIENT_TIMEOUT

static final int HTTP_CLIENT_TIMEOUT

HTTP ステータス・コード (408) の比較用定数です。
クライアントからのリクエストが時間切れになったことを示します。

関連項目:: 定数フィールド値

HTTP_CONFLICT

static final int HTTP_CONFLICT

HTTP ステータス・コード (409) の比較用定数です。
要求が衝突 ( 重複競合 ) したことを示します。

関連項目:: 定数フィールド値

HTTP_GONE

static final int HTTP_GONE

HTTP ステータス・コード (410) の比較用定数です。
存在しないことを示します。

関連項目:: 定数フィールド値

HTTP_LENGTH_REQUIRED

static final int HTTP_LENGTH_REQUIRED

HTTP ステータス・コード (411) の比較用定数です。
長さ情報が必須であることを示します。

関連項目:: 定数フィールド値

HTTP_PRECON_FAILED

static final int HTTP_PRECON_FAILED

HTTP ステータス・コード (412) の比較用定数です。
前提条件が不正であることを示します。

関連項目:: 定数フィールド値

HTTP_ENTITY_TOO_LARGE

static final int HTTP_ENTITY_TOO_LARGE

HTTP ステータス・コード (413) の比較用定数です。
エンティティが長すぎることを示します。

関連項目:: 定数フィールド値

HTTP_REQ_TOO_LONG

static final int HTTP_REQ_TOO_LONG

HTTP ステータス・コード (414) の比較用定数です。
リクエストが長すぎることを示します。

関連項目:: 定数フィールド値

HTTP_UNSUPPORTED_TYPE

static final int HTTP_UNSUPPORTED_TYPE

HTTP ステータス・コード (415) の比較用定数です。
サポートされていない Content-Type であることを示します。

関連項目:: 定数フィールド値

HTTP_UNSUPPORTED_RANGE

static final int HTTP_UNSUPPORTED_RANGE

HTTP ステータス・コード (416) の比較用定数です。
範囲を指定しての要求で問題が発生したことを示します。

関連項目:: 定数フィールド値

HTTP_EXPECT_FAILED

static final int HTTP_EXPECT_FAILED

HTTP ステータス・コード (417) の比較用定数です。
サーバーでサポートしていない HTTP ヘッダであることを示します。

関連項目:: 定数フィールド値

HTTP_INTERNAL_ERROR

static final int HTTP_INTERNAL_ERROR

HTTP ステータス・コード (500) の比較用定数です。
要求が実装されていないことを示します。

関連項目:: 定数フィールド値

HTTP_NOT_IMPLEMENTED

static final int HTTP_NOT_IMPLEMENTED

HTTP ステータス・コード (501) の比較用定数です。
要求が実装されていないことを示します。

関連項目:: 定数フィールド値

HTTP_BAD_GATEWAY

static final int HTTP_BAD_GATEWAY

HTTP ステータス・コード (502) の比較用定数です。
不正なゲートウェイであることを示します。

関連項目:: 定数フィールド値

HTTP_UNAVAILABLE

static final int HTTP_UNAVAILABLE

HTTP ステータス・コード (503) の比較用定数です。
準備ができていないことを示します。

関連項目:: 定数フィールド値

HTTP_GATEWAY_TIMEOUT

static final int HTTP_GATEWAY_TIMEOUT

HTTP ステータス・コード (504) の比較用定数です。
ゲートウェイが時間切れになったことを示します。

関連項目:: 定数フィールド値

HTTP_VERSION

static final int HTTP_VERSION

HTTP ステータス・コード (505) の比較用定数です。
要求された HTTP バージョンをサポートしていないことを示します。

関連項目:: 定数フィールド値

メソッドの詳細

getURL

String getURL()

コネクションが保持しているＵＲＬを返します。

戻り値:: 保持しているＵＲＬを返します。

getProtocol

String getProtocol()

コネクションが使用するプロトコル（http あるいは https）を保持しているＵＲＬから取り出して返します。

戻り値:: 使用するプロトコルを返します。

getHost

String getHost()

接続先のホスト情報を保持しているＵＲＬから取り出して返します。ホスト情報は IPv4 アドレスあるいはホスト名で返します。ホスト情報が存在しない場合は null を返します。

戻り値:: ホスト情報あるいは null を返します。

getFile

String getFile()

保持しているＵＲＬからファイル名部分を取り出して返します。ファイル名が存在しない場合は null を返します。

戻り値:: ファイル名あるいは null を返します。

getRef

String getRef()

保持しているＵＲＬからリファレンス（ＵＲＬの「#」より後ろの部分）を取り出して返します。リファレンス部分が無い場合は null を返します。

戻り値:: リファレンス部分の文字列あるいは null を返します。

getQuery

String getQuery()

保持しているＵＲＬからクエリー（ＵＲＬの「?」より後ろでリファレンスを除いた部分）を取り出して返します。クエリーが無い場合は null を返します。

戻り値:: クエリー部分の文字列あるいは null を返します。

getPort

int getPort()

保持しているＵＲＬからターゲットのネットワーク・ポート番号を返します。ＵＲＬにポート番号の記述が無い場合、デフォルトで HTTP ポート (80) を返します。

戻り値:: ネットワーク・ポート番号を返します。

getRequestMethod

String getRequestMethod()

現在設定されているリクエスト・メソッドを文字列返します。返される文字列は「HEAD」「GET」あるいは「POST」のいずれかです。デフォルトでは「GET」が設定されています。

戻り値:: リクエスト・メソッドを返します。
関連項目:: HEAD, GET, POST

setRequestMethod

void setRequestMethod(String method)
                      throws IOException

リクエスト・メソッドを設定します。設定できるメソッドは「GET」「POST」あるいは「HEAD」のいずれかです。デフォルトでは「GET」が設定されています。

パラメータ:: method - 設定するメソッドを返します。
例外:: IOException - メソッドがリセットできなかった場合あるいは指定されたメソッドが不正であった場合に throw します。
関連項目:: HEAD, GET, POST

getRequestProperty

String getRequestProperty(String key)

コネクションで保持しているリクエスト・ヘッダ・フィールドから指定キー名の値を返します。

パラメータ:: key - 取り出す対象のキー名を渡します（例えば「accept」や「User-Agent」などです）。
戻り値:: キー名に対応した値を返します。

setRequestProperty

void setRequestProperty(String key,
                        String value)
                        throws IOException

リクエスト・プロパティ（リクエスト・ヘッダ・フィールド）の指定キー名に値を設定します。すでにリクエスト・プロパティに対応するキー名に値が設定されていた場合、上書きをします。

注記：１つのリクエスト・プロパティに対して複数の値を設定する場合は、アプリケーション側で全ての値をカンマ区切りの文字列として構成してからこのメソッドを呼び出す必要があります。個別に値を設定しようとすると上書きが行われてしまい、最後に設定された値のみが有効となります。

パラメータ:: key - 設定するキー名を渡します。; value - キー名に対応する設定する値を渡します。
例外:: IOException - ドキュメントに throw される場合の条件が無いため不明です（おそらくサーバー接続後に呼び出された場合に throw するものと思われます）。

getResponseCode

int getResponseCode()
                    throws IOException

HTTP レスポンス・コード（ステータス・コード）を返します。レスポンス・コードの取得に失敗した場合には -1 を返します。

戻り値:: HTTP レスポンス・コードあるいは -1 を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getResponseMessage

String getResponseMessage()
                          throws IOException

HTTP レスポンス・メッセージ（ステータス・メッセージ）を返します。レスポンス・メッセージの取得に失敗した場合には null を返します。

戻り値:: HTTP レスポンス・メッセージあるいは null を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getExpiration

long getExpiration()
                   throws IOException

HTTP レスポンス・ヘッダ・フィールドで示された有効期限（Expires）を返します。有効期限は 1970 年 1 月 1 日午前 0 時 (GMT) からの経過ミリ秒数で返します。有効期限が不明な場合、0 を返します。

戻り値:: 経過ミリ秒あるいは 0 を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getDate

long getDate()
             throws IOException

HTTP レスポンス・ヘッダ・フィールドで示された送信日時（Date）を返します。送信日時は 1970 年 1 月 1 日午前 0 時 (GMT) からの経過ミリ秒数で返します。送信日時が不明な場合、0 を返します。

戻り値:: 経過ミリ秒あるいは 0 を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getLastModified

long getLastModified()
                     throws IOException

HTTP レスポンス・ヘッダ・フィールドで示された最終更新日時（Last-Modified）を返します。最終更新日時は 1970 年 1 月 1 日午前 0 時 (GMT) からの経過ミリ秒数で返します。最終更新日時が不明な場合、0 を返します。

戻り値:: 経過ミリ秒あるいは 0 を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getHeaderField

String getHeaderField(String name)
                      throws IOException

HTTP レスポンス・ヘッダ・フィールドから任意のフィールド名に対応するフィールド値を返します。該当するフィールドが無い場合は null を返します。

パラメータ:: name - 取得するフィールド名を渡します。
戻り値:: フィールド名に対応する値あるいは null を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getHeaderFieldInt

int getHeaderFieldInt(String name,
                      int def)
                      throws IOException

HTTP レスポンス・ヘッダ・フィールドから任意のフィールド名に対応するフィールド値を int 型の値で返します。該当するフィールドが無い場合および値が不正な形式の場合、指定したデフォルトの値を返します。一部のコネクション・タイプ（例えば http-ng）が分析済みのヘッダを持つことがありますが、このメソッドをオーバーライドすることによって分析を避けることができます。

パラメータ:: name - 取得するフィールド名を渡します。; def - デフォルトの値を渡します。
戻り値:: 取得した値あるいはデフォルト値を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getHeaderFieldDate

long getHeaderFieldDate(String name,
                        long def)
                        throws IOException

HTTP レスポンス・ヘッダ・フィールドから任意のフィールド名に対応するフィールド値を日付として分析して返します。分析結果は 1970 年 1 月 1 日午前 0 時 (GMT) からの経過ミリ秒数で返します。該当するフィールドが無い場合および値が不正な形式の場合、指定したデフォルトの値を返します。一部のコネクション・タイプ（例えば http-ng）が分析済みのヘッダを持つことがありますが、このメソッドをオーバーライドすることによって分析を避けることができます。

パラメータ:: name - 取得するフィールド名を渡します。; def - デフォルトの値を渡します。
戻り値:: 取得した値あるいはデフォルト値を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getHeaderField

String getHeaderField(int n)
                      throws IOException

HTTP レスポンス・ヘッダ・フィールドから指定行数目のフィールド値を取得して返します。該当するフィールドが存在しない場合は null を返します。行数は０オリジンで指定します。

パラメータ:: n - 取り出すフィールドの行番号を渡します。
戻り値:: 取り出したフィールド値あるいは null を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

getHeaderFieldKey

String getHeaderFieldKey(int n)
                         throws IOException

HTTP レスポンス・ヘッダ・フィールドから指定行数目のフィールド名を取得して返します。該当するフィールドが存在しない場合は null を返します。行数は０オリジンで指定します。

パラメータ:: n - 取り出すフィールドの行番号を渡します。
戻り値:: 取り出したフィールド名あるいは null を返します。
例外:: IOException - サーバーに接続する前に呼び出した場合に throw します。

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Unofficial
"CLDC 1.1
+ MIDP 2.0"
API Reference.
（日本語版）

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

公式仕様書原文の著作権表記等（※）：

Mobile Information Device Profile Specification ("Specification")
Version: 2.0
Status: FCS
Release: November 5, 2002

Copyright 2002 Sun Microsystems, Inc. and Motorola, Inc.
All rights reserved.

※ただしこの API リファレンスは英語仕様を一語一句正確に翻訳したものではなく、一度私が英語の仕様原文を読んだ上で元の意味と構造をなるべく保つように書き起こしたものです。このため一部は完全に異なる説明となっています。また CLDC 1.1 部分は同仕様の範囲外であるため、まったく参考とはしていません。

※仕様書のライセンス上、問題は無いと考えておりますが、万が一問題があるとお考えの関係者の方がいらっしゃいましたらメールにて連絡をいただけると幸いに存じます（第一言語に日本語、第二言語に英語を希望しますが、返信は基本的に日本語で行います）。

この API リファレンスは仕様書の日本語版という位置づけでは作成していませんし、仕様書ほど厳格でもありません。MUST、SHOULD、MAY などの仕様の条件を強調する文を維持していません（反映すらしていない個所もあります）。仮想マシンおよび MIDP の実装のために使用することは避けてください。そのような用途には必ず公式仕様書原文そのものを用いるべきです。

この API リファレンスに記載されている内容は"さかきけい"が Sun Microsystems, Inc や Motorola, Inc、Java Community Process が公開している各種公式資料を元に、独自に調査・編集したものであり、Sun Microsystems, Inc や Motorola, Inc、Java Community Process 等とは一切関係ありません。したがってこの API リファレンスに関する問い合わせを関係各社等に対して行うことを固く禁じます。
また、記載された内容には既知か否かに関らず誤りが含まれる可能性があり、一切保証はありません。本 API リファレンスを使用した結果、不利益が生じたとしても"さかきけい"は一切の責任を負いません。

許可無く公開/非公開および Internet/Intranet/LAN を問わず他サイトに転載すること、複写および複製すること、ローカル・ファイル等に保存することを禁じます。

Unofficial "CLDC 1.0 + MIDP 1.0" API Reference はこちらです。

javax.microedition.io インタフェース HttpConnection

HEAD

GET

POST

HTTP_OK

HTTP_CREATED

HTTP_ACCEPTED

HTTP_NOT_AUTHORITATIVE

HTTP_NO_CONTENT

HTTP_RESET

HTTP_PARTIAL

HTTP_MULT_CHOICE

HTTP_MOVED_PERM

HTTP_MOVED_TEMP

HTTP_SEE_OTHER

HTTP_NOT_MODIFIED

HTTP_USE_PROXY

HTTP_TEMP_REDIRECT

HTTP_BAD_REQUEST

HTTP_UNAUTHORIZED

HTTP_PAYMENT_REQUIRED

HTTP_FORBIDDEN

HTTP_NOT_FOUND

HTTP_BAD_METHOD

HTTP_NOT_ACCEPTABLE

HTTP_PROXY_AUTH

HTTP_CLIENT_TIMEOUT

HTTP_CONFLICT

HTTP_GONE

HTTP_LENGTH_REQUIRED

HTTP_PRECON_FAILED

HTTP_ENTITY_TOO_LARGE

HTTP_REQ_TOO_LONG

HTTP_UNSUPPORTED_TYPE

HTTP_UNSUPPORTED_RANGE

HTTP_EXPECT_FAILED

HTTP_INTERNAL_ERROR

HTTP_NOT_IMPLEMENTED

HTTP_BAD_GATEWAY

HTTP_UNAVAILABLE

HTTP_GATEWAY_TIMEOUT

HTTP_VERSION

getURL

getProtocol

getHost

getFile

getRef

getQuery

getPort

getRequestMethod

setRequestMethod

getRequestProperty

setRequestProperty

getResponseCode

getResponseMessage

getExpiration

getDate

getLastModified

getHeaderField

getHeaderFieldInt

getHeaderFieldDate

getHeaderField

getHeaderFieldKey

javax.microedition.io
インタフェース HttpConnection