|
|
|
|
|
|
EventChannelFactory)
ChannelFactoryオブジェクト(Tobj_SimpleEvents::
ChannelFactory)表4-3に、Tobjモジュールの例外を示します。
public:
Tobj_Bootstrap(CORBA::ORB_ptr orb, const char* address);
CORBA::Object_ptr resolve_initial_references(
const char* id);
void register_callback_port(CORBA::Object_ptr objref);
void destroy_current( );
};リスト4-2に、Tobj_Bootstrap.javaのマッピングを示します。リスト4-2 Tobj_Bootstrap.javaのマッピングpublic void register_callback_port(orb.omg.CORBA.Object objref)
throws org.omg.CORBA.SystemException;リスト4-3に、オートメーションBootstrapインタフェースのマッピングを示します。
“//#.#.#.#:port_number”
“corbaloc://hostname:port_number”
“corbalocs://hostname:port_number”最初の形式では、ドメインはローカルの名前解決機能(通常はDNS)を使用してhostnameのアドレスを検索します。ホスト名はリモート・マシンでなければならず、ローカルの名前解決機能ではhostnameがそのリモート・マシンのアドレスに明確に解決されなければなりません。2番目の形式では、#.#.#.#はドット区切りの10進数形式です。ドット区切りの10進数形式では、それぞれの#に0から255の数字を指定します。このドット区切りの10進数は、リモート・マシンのIPアドレスを表します。最初と2番目のどちらの形式でも、port_numberは、ドメイン・プロセスが受信リクエストをリスニングするTCPポート番号です。port_numberは、0 - 65535の数字でなければなりません。複数のアドレスを指定した場合、Oracle Tuxedoソフトウェアは、接続が確立されるまで左から右へ順番にアドレスを試行します。試行中にいずれかのアドレスで構文エラーが検出されると、BAD_PARAM例外がただちに呼出し側に返され、Oracle Tuxedoソフトウェアは接続の試行を中断します。たとえば、上記のカンマ区切りリストの最初のアドレスが//m1.3050である場合は、構文エラーが検出され、接続の試行が中断されます。Oracle Tuxedoソフトウェアがアドレス・リストの最後まで達しても有効なアドレスで接続を試行できない場合、つまりリストのどのアドレスにも接続を確立できない場合は、INVALID_DOMAIN例外が呼出し側に返されます。INVALID_DOMAIN以外の例外が生成された場合、その例外は呼出し側に直ちに返されます。Oracle Tuxedoでは、ランダムなアドレスの選択もサポートされています。ランダムなアドレスの選択を使用する場合は、アドレス・リストの任意のメンバーを、かっこで囲まれたパイプ(|)区切りのネットワーク・アドレスのグループとして指定できます。例:この形式を使用した場合、Oracle Tuxedoシステムでは、かっこで囲まれたアドレスのいずれか(//m1.acme:3050または//m2.acme:3050)がランダムに選択されます。INVALID_DOMAIN以外の例外が生成された場合、その例外は呼出し側に直ちに返されます。選択したアドレスで接続を確立できない場合は、かっこの後にある次の要素で接続が試行されます。接続を確立できないうちに文字列の最後に達してしまった場合は、INVALID_DOMAIN例外が呼出し側にスローされます。パイプ区切りリスト内のNULLアドレスは無効とみなされます。Oracle Tuxedoソフトウェアで無効なアドレスがランダムに選択された場合は、BAD_PARAM例外が呼出し側に返され、Oracle Tuxedoソフトウェアは接続の試行を中断します。TOBJADDR環境変数の詳細は、『Oracle Tuxedoアプリケーションの設定』のリモート・クライアント・アプリケーションの管理に関する項を参照してください。ただし、Tobj_Bootstrapで指定されたアドレスの方が常にTOBJADDR 環境変数よりも優先されます。TOBJADDR環境変数を使用してアドレス文字列を指定するには、Tobj_Bootstrapのaddressパラメータで空の文字列を指定する必要があります。
corbalocs://ctxobj:3434,mthd:3434,corbaloc://force:1111上の例では、パーサーがURL corbaloc://force:1111に達した場合、安全な接続を試行しなかった場合と同様にその内部状態をリセットし、保護されていない接続の試行を開始します。
ERROR: Unofficial connection from client at
<tcp/ip address>/<port-number>
たとえば、ネットワーク・アドレスがサーバー・アプリケーションのUBBCONFIGファイルのISLコマンド行オプション文字列で(NULL URLアドレス形式を使用して) //TRIXIE:3500として指定されている場合、BootstrapコンストラクタまたはTOBJADDRで//192.12.4.6:3500または//trixie:3500を指定すると接続の試行は失敗します。UNIXシステムで大文字/小文字の区別を調べるには、ホスト・システムでuname -nコマンドを使用します。Windowsシステムで正確な大文字/小文字の区別を調べるには、コントロール・パネルでホスト・システムのネットワーク設定を確認します。ネイティブ・クライアントの場合、Tobj_Bootstrapコンストラクタのaddressパラメータは常に(NULLポインタではなく)空の文字列である必要があります。ネイティブ・クライアントは、TUXCONFIG環境変数で指定されたアプリケーションに接続します。アドレスが空でない場合は、コンストラクタによって CORBA::BAD_PARAMが生成されます。サーバーがBootstrapオブジェクトへのアクセスを必要とする場合、TP.bootstrap()を呼び出して、TPフレームワークを使用してその参照を取得する必要があります。Bootstrapオブジェクトの新しいインスタンスを作成することは避ける必要があります。applet (Javaメソッドのみに適用)これは、クライアント・アプレットへのポインタです。クライアント・アプレットからBootstrapコンストラクタにISHホストとポートが明示的に渡されない場合、この引数を渡すことができ、これにより、BootstrapオブジェクトはアプレットのHTMLファイルでTOBJADDRの定義を検索します。オブジェクトがnilである場合、またはオブジェクトに格納されているホストが接続と一致しないか、ホスト・アドレス(//hostname:port_number)が有効な形式でない場合に生成されます。このC++メンバー関数(またはJavaメソッド)は、共同クライアント/サーバーの受信ポートをISHに通知するために呼び出します。このメソッドは、GIOP 1.2の双方向機能をサポートしていない共同クライアント/サーバーORB (つまりGIOP 1.0および1.1のクライアントORB)でのみ使用してください。GIOP 1.0および1.1の場合、ISHでは共同クライアント/サーバーごとに1つの受信ポートのみがサポートされます。そのため、register_callback_portメソッドは、接続されている共同クライアント/サーバーごとに1回のみ呼び出すようにしてください。
[in] BSTR host);Oracle TuxedoドメインのIIOPリスナー/ハンドラのホスト名とポート。1つ以上のTCP/IPアドレスを指定できます。複数のアドレスを指定するには、C++マッピングの場合と同様にカンマ区切りリストを使用します。アドレスを指定しない場合は、TOBJADDR環境変数の値が使用されます。
ERROR: Unofficial connection from client at
<tcp/ip address>/<port-number>
たとえば、ネットワーク・アドレスがISLコマンド行オプション文字列で//TRIXIE:3500として指定された場合、BootstrapコンストラクタまたはTOBJADDRで//192.12.4.6:3500または//trixie:3500を指定すると接続の試行が失敗します。UNIXシステムで大文字/小文字の区別を調べるには、ホスト・システムでuname -nコマンドを使用します。Windowsシステムで正確な大文字/小文字の区別を調べるには、コントロール・パネルでホスト・システムのネットワーク設定を確認します。表4-5に例外を示します。
oBootstrap.Initialize “//host:port”‘Get the FactoryFinder for the Oracle Tuxedo Domain
Set oBSFactoryFinder = oBootstrap.CreateObject(“Tobj.FactoryFinder”)
static UniversityW::Registrar_ptr get_registrar(
CORBA::ORB_ptr orb
)
{リスト4-6に、クライアント・アプリケーションがINSを使用してPrincipalAuthenticatorオブジェクトへのオブジェクト参照を取得する方法の例を示します。完全なサンプル・コードについては、University Sampleのクライアント・アプリケーションを参照してください。リリース8.0以降のOracle Tuxedo CORBAでは、CORBAトランザクション・サービス・インタフェースを使用したトランザクションの開始がサポートされています。クライアントは、ORB::resolve_initial_references(“FactoryFinder”)関数を使用してFactoryFinderへのオブジェクト参照を取得します。次にクライアントは、FactoryFinderを使用して(トランザクションの開始に使用する) TransactionFactoryのリファレンスを取得します。リスト4-7に、クライアント・アプリケーションがINSを使用してTransactionFactoryオブジェクトへのオブジェクト参照を取得する方法の例を示します。完全なサンプル・コードについては、University Sampleのクライアント・アプリケーションを参照してください。