personal.sakaki.io
クラス ObexManager

java.lang.Object
  personal.sakaki.io.ObexManager

public class ObexManager
extends java.lang.Object

OBEXライブラリの管理を行うクラスです。 このクラスはOBEX通信の処理（コネクション）を行うクラスと通信を実際に担当する処理（ソケット）を引き合わせて、通信可能なコネクションオブジェクトを生成します。

OBEXライブラリにデフォルトで含まれている以外の独自に作成したソケットクラスの登録もこのクラスで行います。 ソケットはクライアント向けのものとサーバー向けのものを分離して取り扱います。 クライアント向けはObexClientSocketインターフェース、サーバー向けはObexServerSocketインターフェースを実装して作成します。 それぞれのこれらのソケットクラスはクラスがロードされたタイミングでregisterClientSocket(java.lang.String, java.lang.String, java.lang.String)メソッドあるいはregisterServerSocket(java.lang.String, java.lang.String, java.lang.String)メソッドを呼び出して自身を登録します。

アプリケーションは登録されたソケットの中から使用するものを名前（文字列）で指定します。 例えばデフォルトで使用可能な赤外線ソケットの場合はIrDAという名前を指定して、getClient(java.lang.String)メソッドあるいはgetServer(java.lang.String)メソッドを呼び出してコネクションオブジェクトを取得します。

作成者:

さかきけい

メソッドの概要

static void	deregisterClientSocket(java.lang.String strName, java.lang.String strInternalName) 登録されているクライアントソケットを削除します。
static void	deregisterServerSocket(java.lang.String strName, java.lang.String strInternalName) 登録されているサーバーソケットを削除します。
static ObexClientConnection	getClient(java.lang.String strName) パラメータを渡さずに指定されたクライアントソケットを使用してクライアントコネクションを生成します。
static ObexClientConnection	getClient(java.lang.String strName, java.lang.Object objParameter) 指定されたクライアントソケットにパラメータを渡し、そのソケットを使用してクライアントコネクションを生成します。
static ObexServerConnection	getServer(java.lang.String strName) パラメータを渡さずに指定されたサーバーソケットを使用してサーバーコネクションを生成します。
static ObexServerConnection	getServer(java.lang.String strName, java.lang.Object objParameter) 指定されたサーバーソケットにパラメータを渡し、そのソケットを使用してサーバーコネクションを生成します。
static void	registerClientSocket(java.lang.String strName, java.lang.String strInternalName, java.lang.String strClass) クライアントソケットを実装したクラスを登録します。
static void	registerServerSocket(java.lang.String strName, java.lang.String strInternalName, java.lang.String strClass) サーバーソケットを実装したクラスを登録します。

クラス java.lang.Object から継承されたメソッド

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

メソッドの詳細

registerServerSocket

public static void registerServerSocket(java.lang.String strName,
                                        java.lang.String strInternalName,
                                        java.lang.String strClass)

サーバーソケットを実装したクラスを登録します。 詳しくはソケットクラス実装に関する文書を参照してください。

パラメータ:

strName - サーバーソケットをアプリケーションが使用する際に指定する名前を渡します。

strInternalName - サーバーソケットをOBEXライブラリが識別する際に使用する名前を渡します。

strClass - サーバーソケット処理を行うクラスの完全修飾名を渡します。

例外:

java.lang.NullPointerException - パラメータのいずれかにnullが渡されるとthrowされます。

registerClientSocket

public static void registerClientSocket(java.lang.String strName,
                                        java.lang.String strInternalName,
                                        java.lang.String strClass)

クライアントソケットを実装したクラスを登録します。 詳しくはソケットクラス実装に関する文書を参照してください。

パラメータ:

strName - クライアントソケットをアプリケーションが使用する際に指定する名前を渡します。

strInternalName - クライアントソケットをOBEXライブラリが識別する際に使用する名前を渡します。

strClass - クライアントソケット処理を行うクラスの完全修飾名を渡します。

例外:

java.lang.NullPointerException - パラメータのいずれかにnullが渡されるとthrowされます。

deregisterServerSocket

public static void deregisterServerSocket(java.lang.String strName,
                                          java.lang.String strInternalName)

登録されているサーバーソケットを削除します。 アプリケーション向けの名前と登録名で一致するソケットが無い場合は何も処理をしません。

パラメータ:

strName - サーバーソケットをアプリケーションが使用する際に指定する名前を渡します。

strInternalName - サーバーソケットをOBEXライブラリが識別する際に使用する名前を渡します。

例外:

java.lang.NullPointerException - パラメータのいずれかにnullが渡されるとthrowされます。

deregisterClientSocket

public static void deregisterClientSocket(java.lang.String strName,
                                          java.lang.String strInternalName)

登録されているクライアントソケットを削除します。 アプリケーション向けの名前と登録名で一致するソケットが無い場合は何も処理をしません。

パラメータ:

strName - クライアントソケットをアプリケーションが使用する際に指定する名前を渡します。

strInternalName - クライアントソケットをOBEXライブラリが識別する際に使用する名前を渡します。

例外:

java.lang.NullPointerException - パラメータのいずれかにnullが渡されるとthrowされます。

getServer

public static ObexServerConnection getServer(java.lang.String strName)
                                      throws ObexException

パラメータを渡さずに指定されたサーバーソケットを使用してサーバーコネクションを生成します。 指定されたサーバーソケットが存在しないかパラメータ必要なソケットの場合はIllegalArgumentException例外クラスがthrowされます。

このメソッドの呼び出しは以下の記述と等価です。

    getServer(strName, null);

パラメータ:

strName - サーバーソケット名を渡します。

戻り値:

有効なサーバーコネクションを返します。

例外:

java.lang.NullPointerException - strNameにnullが渡されるとthrowされます。

ObexException - ソケット処理で問題が発生した場合にINTERNAL_ERRORステータスでthrowされます。

java.lang.IllegalArgumentException - 指定されたサーバーソケットが存在しなかった場合かパラメータが必要な場合にthrowされます。

getServer

public static ObexServerConnection getServer(java.lang.String strName,
                                             java.lang.Object objParameter)
                                      throws ObexException

指定されたサーバーソケットにパラメータを渡し、そのソケットを使用してサーバーコネクションを生成します。 指定されたサーバーソケットが存在しないかパラメータが不正な場合はIllegalArgumentException例外クラスがthrowされます。

パラメータ:

strName - サーバーソケット名を渡します。

objParameter - サーバーソケットへのパラメータを渡します。

戻り値:

有効なサーバーコネクションを返します。

例外:

java.lang.NullPointerException - strNameにnullが渡されるとthrowされます。

ObexException - ソケット処理で問題が発生した場合にINTERNAL_ERRORステータスでthrowされます。

java.lang.IllegalArgumentException - 指定されたサーバーソケットが存在しなかった場合かパラメータが不正な場合にthrowされます。

getClient

public static ObexClientConnection getClient(java.lang.String strName)
                                      throws ObexException

パラメータを渡さずに指定されたクライアントソケットを使用してクライアントコネクションを生成します。 指定されたクライアントソケットが存在しないかパラメータ必要なソケットの場合はIllegalArgumentException例外クラスがthrowされます。

このメソッドの呼び出しは以下の記述と等価です。

    getClient(strName, null);

パラメータ:

strName - クライアントソケット名を渡します。

戻り値:

有効なクライアントコネクションを返します。

例外:

java.lang.NullPointerException - strNameにnullが渡されるとthrowされます。

ObexException - ソケット処理で問題が発生した場合にINTERNAL_ERRORステータスでthrowされます。

java.lang.IllegalArgumentException - 指定されたクライアントソケットが存在しなかった場合かパラメータが必要な場合にthrowされます。

getClient

public static ObexClientConnection getClient(java.lang.String strName,
                                             java.lang.Object objParameter)
                                      throws ObexException

指定されたクライアントソケットにパラメータを渡し、そのソケットを使用してクライアントコネクションを生成します。 指定されたクライアントソケットが存在しないかパラメータが不正な場合はIllegalArgumentException例外クラスがthrowされます。

パラメータ:

strName - クライアントソケット名を渡します。

objParameter - クライアントソケットへのパラメータを渡します。

戻り値:

有効なクライアントコネクションを返します。

例外:

java.lang.NullPointerException - strNameにnullが渡されるとthrowされます。

ObexException - ソケット処理で問題が発生した場合にINTERNAL_ERRORステータスでthrowされます。

java.lang.IllegalArgumentException - 指定されたクライアントソケットが存在しなかった場合かパラメータが不正な場合にthrowされます。