名前
org.omg.CORBA.ORB.init
形式
(1) public static org.omg.CORBA.ORB init()
(2) public static org.omg.CORBA.ORB init(
java.lang.String[] args,
java.util.Properties props ) (3) public static org.omg.CORBA.ORB init(
java.applet.Applet app,
java.util.Properties props )機能説明
(1)ORB(Singleton ORB)のインスタンスを返します。ORBクラスの特定のメソッドだけ呼出すことができます。使用可能なメソッドについては、注意事項を参照してください。
(2)アプリケーションに対する新しいORBインスタンスを生成します。このメソッドはアプリケーションからのみコールされます。
(3)アプレットに対する新しいORBインスタンスを生成します。このメソッドはアプレットからのみコールされます。プレインストール型JavaライブラリおよびPortable-ORBで使用できます。
Java EE使用時
IIOPサービスを使用して分散トランザクション連携を行うことはできません。
プレインストール型Javaライブラリ使用時
プレインストール型Javaライブラリを使用して分散トランザクション連携を行う場合には、プロパティに以下の記述を追加してください。
com.fujitsu.ObjectDirector.CORBA.GlobalTransactionMode=true
プロパティの検索は、以下の順序で行います。
形式(2)/(3)の本メソッドのpropsパラメタ
Java VM起動時に渡すシステムプロパティ
Portable-ORB使用時
Portable-ORBを使用して分散トランザクション連携を行うことはできません。
パラメタ
(1) なし。
(2)
アプリケーションのmainメソッドに与えられるコマンドラインの引数。null可。
アプリケーション固有のプロパティ。null可。
(3)
アプレット。null不可。
アプレット固有のプロパティ。null可。
org.omg.CORBA.ORB.resolve_initial_references()によってクライアント固有のイニシャルサービスのオブジェクトリファレンスを獲得したい場合、“アプリケーション作成ガイド（CORBAサービス編）”の“ネーミングサービスのイニシャルリファレンスの獲得”にしたがってargsに値を設定する必要があります。
(1)パラメタargsへの設定方法
javaコマンド実行時に指定したORB引数をパラメタargsに設定する場合は、main関数に渡される引数リストをパラメタargsへそのまま設定します。
ORBInitRef引数指定時のjavaコマンド実行時例とプログラムの記述例を以下に示します。
> java Sample -ORBInitRef NameService=corbaloc::nshost/NameService
public class Sample
{
public static void main( String[] args ) {
org.omg.CORBA.ORB Orb;
Orb = org.omg.CORBA.ORB.init(args, null);
:
:
}
} |
ORB引数の有無に関係なく常にmain関数に渡される引数リストをパラメタargsに設定してください。
(2)パラメタappへの設定方法(プレインストール型Javaライブラリ/Portable-ORB使用時)
使用するHTMLの<PARAM>タグを使用して設定します。HTMLに設定したORB引数の情報は、アプレット実行時のアプレットクラスをパラメタappに設定することで、ORBに渡されます。
ORBInitRef引数を設定する場合を例にJBKプラグイン使用時の記述例を以下に示します。
<HTML>
<HEAD><!--sample.html-->
<TITLE>Java sample Applet </TITLE>
</HEAD>
<BODY>
<OBJECT CLASSID="CLSID:BEA62964-C40B-11D1-AACA-00A0C9216A67" WIDTH=300 HEIGHT=250>
<PARAM NAME="TYPE" VALUE="application/x-JBK-Plugin">
<PARAM NAME="CODE" VALUE="Sample.class">
<PARAM NAME="ORBInitRef" VALUE="NameService=corbaloc::nshost/NameService">
<COMMENT>
<EMBED TYPE="application/x-JBK-Plugin"
CODE="Sample.class" WIDTH=300 HEIGHT=250
ORBInitRef="NameService=corbaloc::nshost/NameService" >
</EMBED>
</COMMENT>
</OBJECT>
</BODY>
</HTML> |
<EMBED>タグ内で記述する場合は、<PARAM>タグは使用せず、"ORB引数名=引数値"の形式で記述します。これらのORB引数情報はアプレットプログラム内で読み込む必要はありません。ORB内で自動的に読込みを行います。
ORB引数の有無に関係なく常にアプレット実行時のアプレットクラスをパラメタappに設定してください。
ORBInitRef引数およびORBDefaultInitRef引数を複数指定する場合は、空白' 'を区切り文字としてVALUE(引数)部に複数指定します。詳細については、“アプリケーション作成ガイド（CORBAサービス編）”の“ネーミングサービスのイニシャルリファレンスの獲得”を参照してください。
復帰値
正常終了した場合は、ORBオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
org.omg.CORBA.SystemException
システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。
IIOPサービス（Java EEクライアント）機能を使用している場合は、“メッセージ集”の“Java EE使用時に出力される例外情報”も合わせて参照してください。
注意事項
(2)および(3)の形式のinit()メソッドは、アプリケーション／アプレットにおいて1回だけ発行してください。
プレインストール型Javaライブラリを使用する場合、パラメタ情報等は、2回目以降の呼び出しでは無視されます。アプレットの場合、同じブラウザで異なるHTMLへ移動すると、最初に発行されたinit()メソッドだけが有効となります。
(1)の形式のinit()メソッドが返すORBオブジェクトはSingleton ORBと呼ばれ、使用できるメソッドの種類が限定されています。Singleton ORBから使用できるORBクラスのメソッドを以下に示します。
create_list() create_operation_list() create_named_value() create_exception_list() create_context_list() create_environment() create_any() get_primitive_tc() create_array_tc() create_enum_tc() create_enum_tc() create_exception_tc() create_sequence_tc() create_string_tc() create_struct_tc() create_union_tc() create_wstring_tc()
使用例
main引数をそのままCORBA::ORB_init()に渡している場合、コマンドラインからの実行時に該当の引数を設定してください。
HTTPトンネル用のパラメタ設定サンプル
プレインストール型JavaライブラリまたはPortable-ORBで利用可能です。
String args[] = {
"", /* 最初の引数は無視されます */
"-ORB_FJ_HTTP", "yes",
"-ORB_FJ_HTTPGW", "http://host.com/od-httpgw",
null };
org.omg.CORBA.ORB orb;
orb = org.omg.CORBA.ORB.init( args, null );
|
クライアント固有のイニシャルサービスの設定サンプル
String args[] = {
"", /* 最初の引数は無視されます */
"-ORBInitRef", "NameService=corbaloc::nshost:8002/NameService",
"-ORBDefaultInitRef", "corbaloc::inithost:8002",
null };
org.omg.CORBA.ORB orb;
orb = org.omg.CORBA.ORB.init( args, null );
|