FelicaServerObexConnection (Star-1.1 (APIリファレンス))

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

com.docomostar.io
クラス FelicaServerObexConnection

Object
  com.docomostar.io.FelicaServerObexConnection

すべての実装インタフェース:: javax.microedition.io.Connection, javax.microedition.io.InputConnection, ObexConnection, javax.microedition.io.OutputConnection, ServerObexConnection, javax.microedition.io.StreamConnection

public class FelicaServerObexConnection
extends Object
implements ServerObexConnection

[iアプリオプションAPI]

OBEX サーバとしてアドホック通信による連続データ転送を行う場合の接続を定義します。

本クラスのインスタンスは Connector.open("obex:/felicaserver") メソッドの戻り値として取得することができます。詳細なコード例については StarEventObject.STAR_FELICA_ADHOC_REQUEST_RECEIVED の説明を参照して下さい。

上記インスタンスは、Connector.open() した瞬間に確立していたリンクのみに対して有効です。現在のリンクが切れ、再度別のリンクが確立したとしても、このインスタンスは無効のままで、リンクが切れているものとして振る舞います。

導入されたバージョン:: 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 accept()
          接続要求を待ちます。

void close()
           この接続をクローズします。

int getContentLength()
          コンテンツの長さを取得します。

String getName()
          NAME ヘッダを取得します。

int getOperation()
          リクエストのオペレーションを取得します。

long getTime()
          TIME ヘッダを取得します。

String getType()
          TYPE ヘッダを取得します。

java.io.DataInputStream openDataInputStream()
          CLDC の仕様に従って DataInputStream オブジェクトを返す処理を実装します。

java.io.DataOutputStream openDataOutputStream()
          CLDC の仕様に従って DataOutputStream オブジェクトを返す処理を実装します。

java.io.InputStream openInputStream()
          CLDC の仕様に従って InputStream オブジェクトを返す処理を実装します。

java.io.OutputStream openOutputStream()
          CLDC の仕様に従って OutputStream オブジェクトを返す処理を実装します。

void receiveRequest()
          リクエストの受信を完了するのを待ちます。

void sendResponse(int code)
           レスポンスを送信します。

void setName(String name)
          NAME ヘッダを設定します。

void setTime(long time)
          TIME ヘッダを設定します。

void setType(String type)
          TYPE ヘッダを設定します。

クラス Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

accept

public void accept()
            throws java.io.IOException

接続要求を待ちます。このメソッドを呼び出すと、接続要求が来るまでブロックします。接続が確立されたらこのメソッドから戻ります。

定義:: インタフェース ServerObexConnection 内の accept

例外:: RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。; ConnectionException -
(BUSY_RESOURCE)
既に接続要求発行中の別スレッドが存在するか、別オブジェクトにより既に通信リソースが使用されている場合に発生します。; java.io.InterruptedIOException -
別スレッドからのFelicaServerObexConnection.close() 呼び出しにより、通信が中断された場合に発生します。; ConnectionException -
(TIMEOUT)
ネイティブの OBEX レイヤでタイムアウトが発生した場合に発生します。; ConnectionException -
(USER_ABORT)
ユーザ操作により通信を中断された場合や、ユーザ操作により通信を中断された直後に呼び出された場合に発生します。; java.io.IOException -
対向機器から Disconnect 要求が通知された場合に発生します。; java.io.IOException -
アドホック通信のリンクが確立していない(できなくなった)場合に発生します。; java.io.IOException -
I/O エラーが発生した場合に発生します。

receiveRequest

public void receiveRequest()
                    throws java.io.IOException

リクエストの受信を完了するのを待ちます。このメソッドを呼び出すと、リクエストが到着するまでブロックして、リクエストを全て受信し終わったらこのメソッドから戻ります。このメソッドから正常に戻った場合は、必ず sendResponse メソッドを呼んでレスポンスを送信しなければなりません。

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

定義:: インタフェース ServerObexConnection 内の receiveRequest

例外:: RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。; java.io.InterruptedIOException -
別スレッドからのFelicaServerObexConnection.close() 呼び出しにより、通信が中断された場合に発生します。; ConnectionException -
(TIMEOUT)
ネイティブの OBEX レイヤでタイムアウトが発生した場合に発生します。; ConnectionException -
(USER_ABORT)
ユーザ操作により通信を中断された場合や、ユーザ操作により通信を中断された直後に呼び出された場合に発生します。; java.io.IOException -
アドホック通信のリンクが確立していない(できなくなった)場合に発生します。; java.io.IOException -
I/O エラーが発生した場合に発生します。

getOperation

public int getOperation()

リクエストのオペレーションを取得します。直前に実行した receiveRequest メソッドにおいて受信したリクエストのオペレーションコードを返します。

定義:: インタフェース ServerObexConnection 内の getOperation

戻り値:: リクエストのオペレーションを返します。
例外:: RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。

sendResponse

public void sendResponse(int code)
                  throws java.io.IOException

レスポンスを送信します。

ミニマムスペックでは、以下のレスポンスコードがサポートされています。

定義:: インタフェース ServerObexConnection 内の sendResponse

パラメータ:: code - レスポンスコードを指定します。
例外:: RuntimeException -
呼び出してはならない状態の時に呼び出された場合に発生します。; ConnectionException -
(ILLEGAL_STATE)
receiveRequest メソッドを呼び出す前に呼び出された場合に発生します。; IllegalArgumentException -
引数 code にサポートしていないレスポンスコードが指定された場合に発生します。; java.io.InterruptedIOException -
別スレッドからのFelicaServerObexConnection.close() 呼び出しにより、通信が中断された場合に発生します。; ConnectionException -
(TIMEOUT)
ネイティブの OBEX レイヤでタイムアウトが発生した場合に発生します。; ConnectionException -
(USER_ABORT)
ユーザ操作により通信を中断された場合や、ユーザ操作により通信を中断された直後に呼び出された場合に発生します。; java.io.IOException -
対向機器から Disconnect 要求が通知された場合に発生します。; java.io.IOException -
アドホック通信のリンクが確立していない(できなくなった)場合に発生します。; java.io.IOException -
I/O エラーが発生した場合に発生します。

close

public void close()
           throws java.io.IOException

この接続をクローズします。

既にリンクが切れている状態で呼び出した場合には何もしません。
リンクが確立している状態で OBEX クライアントから DISCONNECT 要求を受信する前に呼び出した場合には、強制的にリンクを切断します。
リンクが確立している状態で OBEX クライアントから DISCONNECT 要求を受信した後に呼び出した場合は、何もしません。この場合にリンクを切断するには、 OBEX クライアント側からすみやかにリンクを切断してください。

定義:: インタフェース javax.microedition.io.Connection 内の close

例外:: PortBusyException -
ポートビジーエラーが発生した場合に発生します。; java.io.IOException -
I/O エラーが発生した場合に発生します。