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 - strNamenullが渡されると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 - strNamenullが渡されると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 - strNamenullが渡されると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 - strNamenullが渡されるとthrowされます。
ObexException - ソケット処理で問題が発生した場合にINTERNAL_ERRORステータスでthrowされます。
java.lang.IllegalArgumentException - 指定されたクライアントソケットが存在しなかった場合かパラメータが不正な場合にthrowされます。


本ライブラリは"さかきけい"が作成した無保証の評価目的専用のOBEXライブラリです。他の用途への転用は一切行えません。
記載された内容および本ライブラリには既知か否かに関らず誤りが含まれる可能性があり、一切保証はありません。本APIリファレンスおよび本ライブラリを使用した結果、不利益が生じたとしても"さかきけい"は一切の責任を負いません。
許可無く公開/非公開およびInternet/Intranet/LANを問わず他サイトに転載すること、複写および複製することを禁じます。

Copyright© 2002-2008 by KEI SAKAKI.
ALL RIGHTS RESERVED.
無断転載を禁じます。