javax.microedition.io
クラス Connector

java.lang.Object
  javax.microedition.io.Connector

public class Connector
extends Object

Generic Connection フレームワークにおける接続をオープンする static メソッドを提供するクラスです。

Generic Connection フレームワークでは、接続のオープンに URL、アクセス・モード、タイムアウト可否を指定することができます。 URL 以外は省略可能であり、省略時にはデフォルトの設定を使用します。

URL は RFC2396 による URL 形式である、“{scheme}:[{target}][{params}]”を使用します。

{scheme} には http のような接続先のプロトコル名あるいはデバイス内部の特定の装置（論理的なものを含む）の名前を指定します。 指定できる名前は実装されているデバイスに依存します。

[{target}] には {scheme} で指定した名前に対応するアドレスを記述します。アドレスが不要な場合は省略することができます。 例えば http の場合、//127.0.0.1/cgi-bin/test.cgi?name=value の部分が該当します。

[{params}] には [{target}] および {scheme} によって接続する先に渡すパラメータを;name=value 形式で記述します。 パラメータが不要な場合は省略することができます。

アクセス・モードは読み出し（READ）モード、書き込み（WRITE）モード、読み書き（READ_WRITE）モードの３種類が存在し、接続先および目的によって使い分けます。 例えば ROM データへアクセスする場合、書き込みは意味をなさないので読み出しモードを指定します。 読み出しモードでオープンした場合に書き込みを行うと IllegalArgumentException を throw します。 これは書き込みモードで読み込みを行った場合にも同様です。 モードの指定を省略した場合は読み書きモードを指定したことになります。

タイムアウトは boolean 型で指定します。true を指定の場合にはデバイス側実装によってタイムアウトが発生した場合に InterruptedIOException を throw するように要求します。 ただし、実際に throw するかどうかは実装によって異なり、ヒントとして扱われます。false を指定するか省略した場合、タイムアウトに関する例外は一切 throw しません。

以上の接続オープン用メソッドのほかに InputStream インタフェースおよび OutputStream インタフェースによる接続のためのユーティリティメソッドが定義されています。

DatagramConnection による接続の URL に関しては同インタフェースのページに記載があります。

READ

public static final int READ

アクセス・モードの読み込みモードを示します。

WRITE

public static final int WRITE

アクセス・モードの書き込みモードを示します。

READ_WRITE

public static final int READ_WRITE

アクセス・モードの読み書きモードを示します。

open

public static Connection open(String url)
                       throws IOException

Generic Connection フレームワークによる接続をオープンします。 アクセス・モードは読み書き、タイムアウトは通知されない状態でオープンされます。

パラメータ:

url - オープンする対象 URL を渡します。

戻り値:

接続した対象に対応する接続オブジェクトを返します。

例外:

IllegalArgumentException - パラメータが無効または誤りのある場合に throw します。

ConnectionNotFoundException - 要求された url に対応する接続が行い無い場合あるいは指定されたプロトコル名がデバイスによってサポートされない場合に throw します。

IOException - 上記以外の何らかの例外が発生した場合に throw します。

open

public static Connection open(String url,
                              int mode)
                       throws IOException

アクセス・モードを指定して Generic Connection フレームワークによる接続をオープンします。 タイムアウトを通知しない状態でオープンします。

パラメータ:

url - オープンする対象の URL を渡します。

mode - アクセス・モードを指定します。

戻り値:

接続した対象に対応する接続オブジェクトを返します。

例外:

IllegalArgumentException - パラメータが無効または誤りのある場合に throw します。

ConnectionNotFoundException - 要求された url に対応する接続が行い無い場合あるいは指定されたプロトコル名がデバイスによってサポートされない場合に throw します。

IOException - 上記以外の何らかの例外が発生した場合に throw します。

open

public static Connection open(String url,
                              int mode,
                              boolean timeout)
                       throws IOException

アクセス・モードとタイムアウト指示を指定して Generic Connection フレームワークによる接続をオープンします。

パラメータ:

url - オープンする対象の URL を渡します。

mode - アクセス・モードを指定します。

timeout - タイムアウトを検出する場合は true、検出しない場合は false を指定します。

戻り値:

接続した対象に対応する接続オブジェクトを返します。

例外:

IllegalArgumentException - パラメータが無効または誤りのある場合に throw します。

ConnectionNotFoundException - 要求された url に対応する接続が行い無い場合あるいは指定されたプロトコル名がデバイスによってサポートされない場合に throw します。

IOException - 上記以外の何らかの例外が発生した場合に throw します。

openDataInputStream

public static DataInputStream openDataInputStream(String url)
                                           throws IOException

DataInputStream インタフェースによるオープンを行います。 アクセス・モードは読み込みモード、タイムアウトは通知されない状態でオープンします。

戻り値:

接続した対象に対応する接続オブジェクトに接続した DataInputStream オブジェクトを返します。

例外:

IllegalArgumentException - パラメータが無効または誤りのある場合に throw します。

ConnectionNotFoundException - 要求された url に対応する接続が行い無い場合あるいは指定されたプロトコル名がデバイスによってサポートされない場合に throw します。

IOException - 上記以外の何らかの例外が発生した場合に throw します。

openDataOutputStream

public static DataOutputStream openDataOutputStream(String url)
                                             throws IOException

DataOutputStream インタフェースによるオープンを行います。 アクセス・モードは書き込みモード、タイムアウトは通知されない状態でオープンします。

戻り値:

接続した対象に対応する接続オブジェクトに接続した DataOutputStream オブジェクトを返します。

例外:

IllegalArgumentException - パラメータが無効または誤りのある場合に throw します。

ConnectionNotFoundException - 要求された url に対応する接続が行い無い場合あるいは指定されたプロトコル名がデバイスによってサポートされない場合に throw します。

IOException - 上記以外の何らかの例外が発生した場合に throw します。

openInputStream

public static InputStream openInputStream(String url)
                                   throws IOException

InputStream インタフェースによるオープンを行います。 アクセス・モードは読み込みモード、タイムアウトは通知されない状態でオープンします。

戻り値:

接続した対象に対応する接続オブジェクトに接続した InputStream オブジェクトを返します。

例外:

IllegalArgumentException - パラメータが無効または誤りのある場合に throw します。

ConnectionNotFoundException - 要求された url に対応する接続が行い無い場合あるいは指定されたプロトコル名がデバイスによってサポートされない場合に throw します。

IOException - 上記以外の何らかの例外が発生した場合に throw します。

openOutputStream

public static OutputStream openOutputStream(String url)
                                     throws IOException

OutputStream インタフェースによるオープンを行います。 アクセス・モードは書き込みモード、タイムアウトは通知されない状態でオープンします。

戻り値:

接続した対象に対応する接続オブジェクトに接続した OutputStream オブジェクトを返します。

例外:

IllegalArgumentException - パラメータが無効または誤りのある場合に throw します。

ConnectionNotFoundException - 要求された url に対応する接続が行い無い場合あるいは指定されたプロトコル名がデバイスによってサポートされない場合に throw します。

IOException - 上記以外の何らかの例外が発生した場合に throw します。