パッケージ javax.microedition.io

リソースに制限のある環境で、アプリケーションに、さまざまな入出力プロトコルを使用できるようにする簡易メカニズムを提供します。

参照先:
説明

インタフェースの概要

CommConnection	このインタフェースは、論理シリアルポート接続を定義します。
Connection	これは、もっとも基本的な種類の汎用接続です。
ContentConnection	このインタフェースでは、コンテンツが通過するストリーム接続が定義されます。
Datagram	このクラスは、データグラムパケットの抽象インタフェースを定義します。
DatagramConnection	このインタフェースでは、データグラム接続に必要な機能を定義します。
InputConnection	このインタフェースでは、入力ストリーム接続に必要な機能を定義します。
OutputConnection	このインタフェースでは、出力ストリーム接続に必要な機能を定義します。
StreamConnection	このインタフェースでは、ストリーム接続に必要な機能を定義します。
StreamConnectionNotifier	このインタフェースでは、接続の通知に必要な機能を定義します。
UDPDatagramConnection	このインタフェースは、ローカル端点アドレスを認識しているデータグラム接続を定義します。

クラスの概要

Connector

このクラスは、新しい Connection オブジェクトを作成するファクトリです。

例外の概要

ConnectionNotFoundException

このクラスは、接続先が見つからないか、プロトコルタイプがサポートされていないことを通知するために使用します。

パッケージ javax.microedition.io の説明

リソースに制限のある環境で、アプリケーションに、さまざまな入出力プロトコルを使用できるようにする簡易メカニズムを提供します。入出力処理は、Connector ファクトリクラスから取得した Connection によって行われます。接続は、「{scheme}:[{target}][{params}]」の形式の URI に基づいて動的に作成されます。詳細については、Connector クラスの説明を参照してください。

プロトコルサポート (CDC)

CDC を使用するには、次の接続プロトコルのサポートが必要です。

• ファイル - CDC java.io.File* 仕様および Generic Connection Framework の「file:」プロトコルの定義に従います (後述)。
• データグラムソケット - CDC java.net.DatagramSocket 仕様および Generic Connection Framework の「datagram:」の定義に従います (後述)。
• 次の javax.microedition.io.Connector プロトコルをサポートします。
  「file:」および「datagram:」 (形式の詳細は後述)

  CDC の Generic Connection Framework は、
  次の各プロトコルで、定義に従って動作する必要があります。
  
  1. RFC 1738 (http://www.w3.org/Addressing/rfc1738.txt) の定義によると、
  ファイル URL は「file://{path}」の形式で、「読み取り」モードの場合は 
  javax.microedition.io.InputConnection、「書き込み」モードの場合は 
  javax.microedition.io.OutputConnection、「読み取り/書き込み」モードの
  場合は avax.microedition.io.StreamConnection を実装するオブジェクトを
  返す必要があります。実装は、最低限「読み取り」モードをサポートする必要
  があります。
  
  2. javax.microedition.io.UDPDatagramConnection の定義によると、データ
  グラムソケットは「datagram://[{host}]:{port}」の形式で、
  javax.microedition.io.DatagramConnection インタフェースの拡張インタ
  フェースである javax.microedition.io.UDPDatagramConnection の仕様に
  準拠して動作するオブジェクトを返す必要があります。
  
  3. 通信ポート 
  GCF CommConnection インタフェースの実装はオプションです。このインタ
  フェースはデバイスのシリアル接続に依存しており、使用するかどうかは
  デバイスの製造元によって異なります。
   
  

これらのプロトコルで、{host} パラメータは www.jcp.org などのマシン名か、206.26.48.100 のような IP アドレスを表す文字列になります。

プロトコルサポート (CDC/Foundation Profile)

CDC/Foundation Profile では、次の接続プロトコルのサポートが必要です (Foundation Profile が存在する場合のみ)。

• すべてのプロトコル - CDC 仕様の定義に従います。
• ソケット - Foundation Profile java.net.Socket 仕様および Generic Connection Framework の「socket:」の定義に従います (後述)。
• HTTP (Hypertext Transfer Protocol) - Foundation Profile java.net.URLConnection for HTTP 仕様および Generic Connection Framework の「http:」の定義に従います (後述)。
• 次の javax.microedition.io.Connector プロトコルをサポートします。
  CDC の「file:」および「datagram:」 (形式の詳細は、CDC の概要を参照)
  「socket:」および「http:」 (形式の詳細は後述)

  Foundation Profile の Generic Connection Framework は、
  次の各プロトコルで、定義に従って動作する必要があります。
  
  1. すべてのプロトコル - Generic Connection Framework については、
  CDC 仕様の定義に従います。
  
  2.  TCP/IP クライアントソケット。「socket://{host}:{port}」の形式の
   URI は、javax.microedition.io.StreamConnection インタフェース仕様に
  準拠して動作するオブジェクトを返す必要があります。 
  この接続から得られるストリームは、Socket(String, int) コンストラクタが
  使用されていてソケットオプションが設定されていない場合に 
  java.net.Socket クラスから得られるストリームと機能的に同等です。 
  
  TCP/IP サーバーソケット。「socket:// | socket://:{port}」の形式の 
  URI は、javax.microedition.io.StreamConnectionNotifier インタ
  フェース仕様に準拠して動作するオブジェクトを返す必要があります。 
  この接続から得られるストリームは、ServerSocket インスタンスの作成に 
  ServerSocket(int) コンストラクタが使用されている場合に 
  java.net.ServerSocket.accept() メソッドが返す 
  java.net.Socket クラスから得られるストリームと機能的に同等です。
  
  3. Mobile Information Device Profile (MIDP) に定義された HTTP。
  MIDP javax.microedition.io.HttpConnection URL 仕様に
  準拠した形式の javax.microedition.io.HttpConnection インタフェースで、
  javax.microedition.io.HttpConnection インタフェース仕様に
  準拠して動作するオブジェクトを返す必要があります。
  

次の MIDP インタフェースの実装はオプションです。これらのインタフェースは SSL プロトコルに依存しています。

• SecureConnection
• HttpsConnection

SecureConnection と HttpsConnection のどちらかが実装されている場合、または Java ME Security Optional Package の Java Secure Socket Extension (JSSE) 部分が存在する場合は、SecureConnection インタフェースと HttpsConnection インタフェースの両方を実装する必要があります。

これらのプロトコルで、{host} パラメータは www.jcp.org などのマシン名か、206.26.48.100 のような IP アドレスを表す文字列になります。

汎用接続フレームワーク (GCF) のセキュリティーチェック (CDC)

javax.microedition.io.Connector のメソッドを使用して要求されたプロトコルタイプの接続へのアクセスは、特定の java.lang.SecurityManager チェックによって制御されます。次に、CDC の場合について説明します。

プロトコル	URI 形式	セキュリティーチェック
ファイル入出力	file://{path} (読み取り) file://{path} (書き込み)	checkRead({path}) checkWrite({path})
データグラムソケット	datagram://{host}:{port} datagram://:{port}	checkListen(0) checkListen({port})

javax.microedition.io.InputConnection.openDataInputStream() メソッドまたは javax.microedition.io.InputConnection.openInputStream() メソッドが呼び出されると、次のようなセキュリティーチェックが行われます。

プロトコル	URI 形式	セキュリティーチェック
ファイル入力	file://{path}	checkRead({path})

javax.microedition.io.OutputConnection.openDataOutputStream() メソッドまたは javax.microedition.io.OutputConnection.openOutputStream() メソッドが呼び出されると、次のようなセキュリティーチェックが行われます。

プロトコル	URI 形式	セキュリティーチェック
ファイル出力	file://{path}	checkWrite({path})

CDC/Foundation Profile の汎用接続フレームワーク (GCF) のセキュリティーチェック

javax.microedition.io.Connector のメソッドを使用して要求されたプロトコルタイプの接続へのアクセスは、特定の java.lang.SecurityManager チェックによって制御されます。次に、CDC/Foundation Profile の場合について説明します (Foundation Profile が存在する場合のみ)。

プロトコル	URI 形式	セキュリティーチェック
TCP/IP クライアントソケット	socket://{host}:{port}	checkConnect({host}, {port})
TCP/IP サーバーソケット	socket://:{port}	checkListen({port})
HTTP 1.1	http://{host}[{path}] http://{host}:{port}[{path}]	checkConnect({host}, 80) checkConnect({host}, {port})
HTTPS	https://{host}[{path}] http://{host}:{port}[{path}]	checkConnect({host}, 443) checkConnect({host}, {port})
セキュアソケット	ssl://{host}:{port}	checkConnect({host}, {port})
ファイル入出力	file://{path} (読み取り) file://{path} (書き込み)	checkRead({path}) checkWrite({path})
データグラムソケット	datagram://{host}:{port} datagram://:{port}	checkListen(0) checkListen({port})

javax.microedition.io.InputConnection.openDataInputStream() メソッドまたは javax.microedition.io.InputConnection.openInputStream() メソッドが呼び出されると、次のようなセキュリティーチェックが行われます。

プロトコル	URI 形式	セキュリティーチェック
HTTP 1.1	http://{host}[{path}] http://{host}:{port}[{path}]	checkConnect({host}, 80) checkConnect({host}, {port})
HTTPS	https://{host}[{path}] http://{host}:{port}[{path}]	checkConnect({host}, 443) checkConnect({host}, {port})
セキュアソケット	ssl://{host}:{port}	checkConnect({host}, {port})
ファイル入力	file://{path}	checkRead({path})

javax.microedition.io.OutputConnection.openDataOutputStream() メソッドまたは javax.microedition.io.OutputConnection.openOutputStream() メソッドが呼び出されると、次のようなセキュリティーチェックが行われます。

プロトコル	URI 形式	セキュリティーチェック
HTTP 1.1	http://{host}[{path}] http://{host}:{port}[{path}]	checkConnect({host}, 80) checkConnect({host}, {port})
HTTPS	https://{host}[{path}] http://{host}:{port}[{path}]	checkConnect({host}, 443) checkConnect({host}, {port})
セキュアソケット	ssl://{host}:{port}	checkConnect({host}, {port})
ファイル出力	file://{path}	checkWrite({path})

StreamConnection の動作

DataInputStream をオープンすると、InputStream がオープンされたとみなされます。DataOutputStream をオープンすると、OutputStream がオープンされたとみなされます。 Foundation Profile では、1 つの StreamConnection で複数のストリームをオープンできます。1 つの StreamConnection から新たに InputStream または OutputStream をオープンしようとしたとき、例外が発生してはいけません。 InputStream または OutputStream を終了したあとにオープンしようとすると、IOException がスローされます。

close メソッドを呼び出したあとは、オープンストリームの有無にかかわらず、接続に対してさらにメソッド呼び出しを行うと、IOException をスローするように宣言されているメソッドで IOException がスローされます。例外をスローしないメソッドの場合は、結果が不明になることがあります。