HttpConnection (Unofficial 'CLDC 1.0 + MIDP 1.0' API Reference.)

URL をオープンするために Connector.open(java.lang.String) を使用します。この結果 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(java.lang.String) を使用します。この結果 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(java.lang.String) を使用します。この結果 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(java.lang.String) を使用します。この結果 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-1.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)

このインタフェースは Mobile Information Device Profile に所属しています。 MID Profile を含まない環境では存在しません。

導入されたバージョン:: 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) を返します。（ドキュメントに記載はありませんが、https の場合は 443 がデフォルトで返されるものと思われます。）

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

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-eg など）が分析済みのヘッダを持つことがありますが、このメソッドをオーバーライドすることによって分析を避けることができます。

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

getHeaderFieldDate

long getHeaderFieldDate(String name,
                        long def)
                        throws IOException

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

パラメータ:: 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.0
+ MIDP 1.0"
API Reference.
（日本語版）

前のクラス 次のクラス

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

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

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

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

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

Unofficial "CLDC 1.1 + MIDP 2.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