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

すべてのスーパーインタフェース:

Connection, ContentConnection, HttpConnection, InputConnection, OutputConnection, StreamConnection

public interface HttpsConnection
extends HttpConnection

このインタフェースはセキュアなネットワーク接続を証明するために必要なメソッドと定数を定義しています。 Connector クラスの open メソッドでスキームに"https"を含む URI 形式をオープンすると HttpsConnection オブジェクトを返します。 スキームは RFC2818 にて定義されています。

以下に示す仕様を１つ以上採用してセキュアなネットワーク接続を実装しなければなりません。

• RFC2818 によって示される HTTP over TLS と RFC2246 によって規定された TLS Protovol Version 1.0。
• The SSL Protocol Version 3.0 で定められた SSL V3。
• WAP Forum Specifications June 2000(WAP 1.2.1) conformance release - WAP-199, Wireless Transport Layer Security Specification で定められた WTLS。
• WAP-219-TLS-20010411-a が定める WAP(TM) TLS Profile および Tunneling Specification。

HTTPS は HTTP（RFC2616）のセキュアバージョンであり、リクエストを送信する前にリクエスト・パラメータを設定しなければならないリクエスト - レスポンス型のプロトコルです。

接続状態への遷移を促す様々なメソッドの呼び出しによって、通常の IOException に加えて、セキュアなリンクを確立する際に発生する様々な失敗を示すために CertificateException（IOException のサブクラス）を throw することができます。 接続状態への遷移はセキュアなリンクを確立し、正常にヘッダーを送信することが必要です。 Connector クラスの open() メソッドと同メソッドに関連するメソッドの呼び出し時点でセキュアなリンクを確立する可能性があり、最初の入出力ストリームによる状態遷移よりも早期に CertificateException が throw されることがあります。

使用例

HTTPS 接続を開き、そして各種パラメータを設定し、HTTP レスポンスを読み出します。

URL を Connector クラスの open メソッドでオープンし、HttpsConnection オブジェクトを取得します。 HTTP ヘッダを読み取り処理します。 データの長さが有効であればそれをデータの読み取りに使用します。 HttpsConnection オブジェクトから InputStream オブジェクトを開きます。 そしてファイルの終わり（読み出し結果が -1 になるまで）全てのデータを読み出すのに使用します。 例外が throw された場合は HttpsConnection オブジェクトと InputStream オブジェクトを閉じます。

void getViaHttpsConnection(String url)
        throws CertificateException, IOException {
     HttpsConnection c = null;
     InputStream is = null;
     try {
         c = (HttpsConnection)Connector.open(url);
 
         // InputStream オブジェクトを開くことで、接続が開かれ、
         // （Connector.open() によって既に扱われていなければ）
         // SSL ハンドシェイクを行い、HTTP レスポンスヘッダを読み
         // 出すことを確実にします。これらは要求があるまで保持し
         // ます。
         is = c.openDataInputStream();
 
         if c.getResponseCode() == HttpConnection.HTTP_OK) {
             // データの長さの取得と処理を行います。
             int len = (int)c.getLength();
             if (len > 0) {
                 byte[] data = new byte[len];
                 int actual = is.readFully(data);
                 ...
             } else {
                 int ch;
                 while ((ch = is.read()) != -1) {
                     ...
                 }
             }
         } else {
           ...
         }
     } finally {
         if (is != null)
             is.close();
         if (c != null)
             c.close();
     }
 }

導入されたバージョン:

MIDP 2.0

関連項目:

CertificateException

getSecurityInfo

SecurityInfo getSecurityInfo()
                             throws IOException

正常にオープンされたこの接続に関連するセキュリティ情報を返します。 接続がまだセットアップ状態の場合、セキュアな接続を証明するためにサーバーへの接続を開始します。 接続が確立され、サーバーから提供された Certificate が有効になるとメソッドは呼び出し元に戻ります。 正常にサーバーに接続した場合に限り、SecurityInfo オブジェクトを返します。

戻り値:

このオープンされた接続に関連するセキュリティ情報を返します。

例外:

IOException - 証明できない任意の接続である場合に throw します。

getPort

int getPort()

この HttpsConnection オブジェクトのオープンに使用した URL のネットワーク・ポート番号を返します。

定義:

インタフェース HttpConnection 内の getPort

戻り値:

この HttpsConnection オブジェクトが接続先とするネットワーク・ポート番号を返します。 開く際に使用された URL 文字列にポート番号の記述が無い場合はデフォルトの HTTPS ポート番号である 443 を返します。