com.docomostar.io
インタフェース ClientObexConnection

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

javax.microedition.io.Connection, javax.microedition.io.InputConnection, ObexConnection, javax.microedition.io.OutputConnection, javax.microedition.io.StreamConnection

既知の実装クラスの一覧:

FelicaClientObexConnection, IrClientObexConnection

public interface ClientObexConnection
extends ObexConnection

OBEX クライアントとして通信を行う場合の接続を定義します。 オペレーションとして PUT と GET をサポートしています。 一回の接続で複数回 sendRequest メソッドを呼び出すことが可能で、 連続して複数のリクエストを送信することができます。

OutputStream または DataOutputStream に出力したデータが PUT オペレーションの BODY ヘッダの内容としてサーバに送信されます。 GET オペレーションの場合、OutputStream または DataOutputStream に出力したデータは無視されます。
また、GET オペレーションに対するレスポンスの BODY ヘッダの内容は InputStream または DataInputStream から読み出すことができます。 PUT オペレーションに対するレスポンスの場合、 InputStream または DataInputStream は常に空のストリームとなります。 ObexConnection インタフェースで定義されている getContentLength メソッドは レスポンスの BODY ヘッダ内のコンテンツの長さを返します。

以下に IrDA 通信において PUT オペレーションを使用する場合のコード例を示します。

   try {
       IrClientObexConnection coc;
       coc = (IrClientObexConnection)Connector.open("obex:/irclient");
       coc.connect(); // IrDA の場合、この時点でデバイスに通電して
                      // CONNECT オペレーションを発行します。
       while (true) { // 複数のオペレーションを行う場合のループ。
                      // ループの中で PUT と GET を組み合わせて使用してもよい。
           coc.setOperation(ObexConnection.PUT);
           coc.setName("foo");
           OutputStream out = coc.openOutputStream();
           // 書き込み処理
           out.close();
           coc.sendRequest(); // IrDA の場合、この時点で PUT オペレーションを
                              // 送信して、レスポンスを受け取ります。
           int response = coc.getResponseCode();
       }
       coc.close(); // IrDA の場合、この時点で DISCONNECT オペレーションを
                    // 発行して、デバイスをオフにします。
   } catch (IOException e) {
   }
 

また、以下に IrDA 通信において GET オペレーションを使用する場合のコード例を示します。

   try {
       IrClientObexConnection coc;
       coc = (IrClientObexConnection)Connector.open("obex:/irclient");
       coc.connect(); // IrDA の場合、この時点でデバイスに通電して
                      // CONNECT オペレーションを発行します。
       while (true) { // 複数のオペレーションを行う場合のループ。
                      // ループの中で PUT と GET を組み合わせて使用してもよい。
           coc.setOperation(ObexConnection.GET);
           coc.setName("bar");
           coc.sendRequest(); // IrDA の場合、この時点で GET オペレーションを
                              // 送信して、レスポンスを受け取ります。
           int response = coc.getResponseCode();
           InputStream in = coc.openInputStream();
           // 読み出し処理
           in.close();
       }
       coc.close(); // IrDA の場合、この時点で DISCONNECT オペレーションを
                    // 発行して、デバイスをオフにします。
   } catch (IOException e) {
   }
 

導入されたバージョン:

Star-1.0

フィールドの概要

インタフェース com.docomostar.io.ObexConnection から継承されたフィールド

ACCEPTED, BAD_GATEWAY, BAD_REQUEST, COMM_MODE_IRDA, COMM_MODE_IRSIMPLE_INTERACTIVE, COMM_MODE_IRSIMPLE_UNILATERALLY, CONFLICT, CONTINUE, CREATED, DATABASE_FULL, DATABASE_LOCKED, DISCONNECT, FORBIDDEN, GATEWAY_TIMEOUT, GET, GONE, HTTP_VERSION_NOT_SUPPORTED, INTERNAL_SERVER_ERROR, LENGTH_REQUIRED, METHOD_NOT_ALLOWED, MOVED_PERMANENTLY, MOVED_TEMPORARILY, MULTIPLE_CHOICES, NO_CONTENT, NON_AUTHORITATIVE_INFORMATION, NOT_ACCEPTABLE, NOT_FOUND, NOT_IMPLEMENTED, NOT_MODIFIED, PARTIAL_CONTENT, PAYMENT_REQUIRED, PRECONDITION_FAILED, PROXY_AUTHENTICATION_REQUIRED, PUT, REQUEST_ENTITY_TOO_LARGE, REQUEST_TIME_OUT, REQUEST_URL_TOO_LARGE, RESET_CONTENT, SEE_OTHER, SERVICE_UNAVAILABLE, SUCCESS, UNAUTHORIZED, UNSUPPORTED_MEDIA_TYPE, USE_PROXY

メソッドの概要

void	connect() 接続を確立します。
int	getResponseCode() レスポンスコードを取得します。
void	sendRequest() リクエストを送信して、レスポンスの受信を完了するまで待ちます。
void	setOperation(int operation) オペレーションコードを設定します。

インタフェース com.docomostar.io.ObexConnection から継承されたメソッド

getContentLength, getName, getTime, getType, setName, setTime, setType

インタフェース javax.microedition.io.InputConnection から継承されたメソッド

openDataInputStream, openInputStream

インタフェース javax.microedition.io.OutputConnection から継承されたメソッド

openDataOutputStream, openOutputStream

インタフェース javax.microedition.io.Connection から継承されたメソッド

close

メソッドの詳細

connect

void connect()
             throws java.io.IOException

接続を確立します。

例外:

RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。

ConnectionException -
(BUSY_RESOURCE)
既に接続要求発行中の別スレッドが存在するか、 別オブジェクトにより既に通信リソースが使用されている場合に発生します。

java.io.InterruptedIOException -
別スレッドからの中断要求発生により、 通信が中断された場合に発生します。

ConnectionException -
(TIMEOUT)
ネイティブのOBEXレイヤでタイムアウトが発生した場合に発生します。

ConnectionException -
(USER_ABORT)
ユーザ操作により通信を中断された場合に発生します。

java.io.IOException -
対向機器からDisconnect要求が通知された場合に発生します。

java.io.IOException -
I/O エラーが発生した場合に発生します。

setOperation

void setOperation(int operation)

オペレーションコードを設定します。 設定できるオペレーションは "PUT" と "GET" です。

パラメータ:

operation - オペレーションコードを指定します。

例外:

RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。

IllegalArgumentException -
引数 operation にサポートしていないオペレーションコードが指定された場合に発生します。

IllegalArgumentException -
WRITEモードでの接続に対してGETオペレーションが指定された場合やREADモードでの接続に対してPUTオペレーションが指定された場合に発生します。

sendRequest

void sendRequest()
                 throws java.io.IOException

リクエストを送信して、レスポンスの受信を完了するまで待ちます。 このメソッドを呼び出すとリクエストを送信して、 レスポンスが到着するまでブロックします。 レスポンスを全て受信し終わったらこのメソッドから戻ります。

このメソッドを呼び出すことによって、それより前にこの接続オブジェクトから 取り出した InputStream, DataInputStream, OutputStream, DataOutputStream が無効になります。 次に InputStream, DataInputStream を取り出した時は、 このオペレーションで受信したデータを読み出す入力ストリームを返します。 また、次に OutputStream, DataOutputStream を取り出した時は、 次のオペレーションで送信するデータを書き込む出力ストリームを返します。

例外:

RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。

ConnectionException -
(ILLEGAL_STATE)
オペレーションコードがセットされていない場合に発生します。

java.io.InterruptedIOException -
別スレッドからの中断要求発生により、 通信が中断された場合に発生します。

ConnectionException -
(TIMEOUT)
ネイティブのOBEXレイヤでタイムアウトが発生した場合に発生します。

ConnectionException -
(USER_ABORT)
ユーザ操作により通信を中断された場合や、ユーザ操作により通信を中断された直後に呼び出された場合 に発生します。

java.io.IOException -
対向機器からDisconnect要求が通知された場合に発生します。

java.io.IOException -
I/O エラーが発生した場合に発生します。

ConnectionException -
(OBEX_ERROR)
レスポンスコードが 0x20 番台 (generally ok 系の ステータスコード) 以外のコードだった場合に発生します。

getResponseCode

int getResponseCode()

レスポンスコードを取得します。 直前に実行した sendRequest メソッドにおいて受信した レスポンスのレスポンスコードを返します。

1つのデータを複数のパケットに分割して受信した場合、 一番最後に受信したパケットのレスポンスコードを返します。

ミニマムスペックでは、 以下のレスポンスコードについて取得できることが保証されています。

1. ObexConnection.CONTINUE
2. ObexConnection.SUCCESS
3. ObexConnection.NON_AUTHORITATIVE_INFORMATION
4. ObexConnection.UNAUTHORIZED
5. ObexConnection.FORBIDDEN
6. ObexConnection.NOT_FOUND
7. ObexConnection.REQUEST_TIME_OUT
8. ObexConnection.CONFLICT
9. ObexConnection.NOT_IMPLEMENTED
10. ObexConnection.BAD_REQUEST
11. ObexConnection.DATABASE_FULL
12. ObexConnection.DATABASE_LOCKED

戻り値:

レスポンスコードを返します。

例外:

RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。