|
Foundation 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object javax.microedition.io.Connector
public class Connector
このクラスは、新しい Connection オブジェクトを作成するファクトリです。
Connection オブジェクトは、要求された接続のプロトコル名に由来する名前を持つプロトコル実装クラスを検索することにより、動的に作成されます。 接続先を記述するパラメータの文字列が、RFC 2396 に記述されている URL 形式に準拠するようにしてください。これには次のような汎用形式が使用されます。
{scheme}:[{target}][{params}]
{scheme}
は、http などのプロトコルの名前です。
{target}
は、通常、ある種のネットワークアドレスです。
{parms}
は、「;x=y」の形式の一連の等式を形成します。たとえば、";type=a" などです。
2 番目のオプションパラメータには、open 関数を指定することもできます。これは、呼び出しコード側の意図をプロトコルハンドラに伝えるモードフラグです。ここでのオプションは、接続モードとして読み取り (READ)、書き込み (WRITE)、読み取りと書き込み (READ_WRITE) のどれかを指定します。これらのフラグ設定が有効かどうかは、プロトコルによって異なります。たとえば、プリンタへの接続では読み取りアクセスは許可されません。このため、読み取りアクセスを試行すると IllegalArgumentException がスローされます。モードパラメータを指定しなかった場合は、デフォルトの READ_WRITE が使用されます。
3 番目のオプションパラメータは、呼び出しコードがタイムアウト例外を処理できるかどうかを示す boolean 型フラグです。このフラグが設定されている場合に、プロトコル実装がタイムアウト条件を検出すると、InterruptedIOException がスローされることがあります。このフラグはプロトコルハンドラに対するヒントとして機能するだけであり、こうした例外が実際にスローされることを保証するものではありません。このパラメータを設定しなかった場合は、タイムアウト例外はスローされません。
特定の入力ストリームまたは出力ストリームにアクセスするためだけに接続が開始されることが多いため、これに対応する 4 つの便利な関数が用意されています。
DatagramConnection
を参照して、データグラムアドレス指定の関連情報も確認してください。
フィールドの概要 | |
---|---|
static int |
READ
読み取りアクセスモード (READ) です。 |
static int |
READ_WRITE
読み取り書き込みアクセスモード (READ_WRITE) です。 |
static int |
WRITE
書き込みアクセスモード (WRITE) です。 |
メソッドの概要 | |
---|---|
static Connection |
open(String name)
Connection を作成および開始します。 |
static Connection |
open(String name,
int mode)
Connection を作成および開始します。 |
static Connection |
open(String name,
int mode,
boolean timeouts)
Connection を作成および開始します。 |
static DataInputStream |
openDataInputStream(String name)
接続入力ストリームを作成およびオープンします。 |
static DataOutputStream |
openDataOutputStream(String name)
接続出力ストリームを作成し、オープンします。 |
static InputStream |
openInputStream(String name)
接続入力ストリームを作成およびオープンします。 |
static OutputStream |
openOutputStream(String name)
接続出力ストリームを作成およびオープンします。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
---|
public static final int READ
public static final int WRITE
public static final int READ_WRITE
メソッドの詳細 |
---|
public static Connection open(String name) throws IOException
file
プロトコルの場合、ファイルは上書きされます。
name
- 接続先 URL
IllegalArgumentException
- パラメータが無効な場合
ConnectionNotFoundException
- 名前のターゲットが見つからないか、要求されたプロトコルタイプがサポートされていない場合
IOException
- 上記以外のなんらかの入出力エラーが発生した場合
SecurityException
- プロトコルハンドラへのアクセスが禁止された場合にスローされる場合があるpublic static Connection open(String name, int mode) throws IOException
file
プロトコルの場合、WRITE モードまたは READ_WRITE モードでは、ファイルは上書きされます。
name
- 接続先 URLmode
- アクセスモード
IllegalArgumentException
- パラメータが無効な場合
ConnectionNotFoundException
- 名前のターゲットが見つからないか、要求されたプロトコルタイプがサポートされていない場合
IOException
- 上記以外のなんらかの入出力エラーが発生した場合
SecurityException
- プロトコルハンドラへのアクセスが禁止された場合にスローされる場合があるpublic static Connection open(String name, int mode, boolean timeouts) throws IOException
file
プロトコルの場合、WRITE モードまたは READ_WRITE モードでは、ファイルは上書きされます。
name
- 接続先 URLmode
- アクセスモードtimeouts
- 呼び出し側がタイムアウト例外を要求していることを示すフラグ
IllegalArgumentException
- パラメータが無効な場合
ConnectionNotFoundException
- 名前のターゲットが見つからないか、要求されたプロトコルタイプがサポートされていない場合
IOException
- 上記以外のなんらかの入出力エラーが発生した場合
SecurityException
- プロトコルハンドラへのアクセスが禁止された場合にスローされる場合があるpublic static DataInputStream openDataInputStream(String name) throws IOException
name
- 接続先 URL。使用可能な URL 接頭辞は「comm:」、「http:」、「socket:」、「ssl:」など。ただし、実装で使用可能であり、それぞれの接続仕様に従う場合
IllegalArgumentException
- パラメータが無効な場合
ConnectionNotFoundException
- 名前のターゲットが見つからないか、要求されたプロトコルタイプがサポートされていない場合
IOException
- 上記以外のなんらかの入出力エラーが発生した場合
SecurityException
- プロトコルハンドラへのアクセスが禁止された場合にスローされる場合があるpublic static DataOutputStream openDataOutputStream(String name) throws IOException
name
- 接続先 URL。使用可能な URL 接頭辞は「comm:」、「http:」、「socket:」、「ssl:」など。ただし、実装で使用可能であり、それぞれの接続仕様に従う場合
IllegalArgumentException
- パラメータが無効な場合
ConnectionNotFoundException
- 名前のターゲットが見つからないか、要求されたプロトコルタイプがサポートされていない場合
IOException
- 上記以外のなんらかの入出力エラーが発生した場合
SecurityException
- プロトコルハンドラへのアクセスが禁止された場合にスローされる場合があるpublic static InputStream openInputStream(String name) throws IOException
name
- 接続先 URL。使用可能な URL 接頭辞は「comm:」、「http:」、「socket:」、「ssl:」など。ただし、実装で使用可能であり、それぞれの接続仕様に従う場合
IllegalArgumentException
- パラメータが無効な場合
ConnectionNotFoundException
- 名前のターゲットが見つからないか、要求されたプロトコルタイプがサポートされていない場合
IOException
- 上記以外のなんらかの入出力エラーが発生した場合
SecurityException
- プロトコルハンドラへのアクセスが禁止された場合にスローされる場合があるpublic static OutputStream openOutputStream(String name) throws IOException
file
プロトコルの場合、ファイルは上書きされます。
name
- 接続先 URL。使用可能な URL 接頭辞は「comm:」、「http:」、「socket:」、「ssl:」など。ただし、実装で使用可能であり、それぞれの接続仕様に従う場合
IllegalArgumentException
- パラメータが無効な場合
ConnectionNotFoundException
- 名前のターゲットが見つからないか、要求されたプロトコルタイプがサポートされていない場合
IOException
- 上記以外のなんらかの入出力エラーが発生した場合
SecurityException
- プロトコルハンドラへのアクセスが禁止された場合にスローされる場合がある
|
Foundation 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。