1 '\" t
2 .\" Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
3 .\" Title: tnameserv
4 .\" Language: English
5 .\" Date: 2013年11月21日
6 .\" SectDesc: Java IDLおよびRMI-IIOPツール
7 .\" Software: JDK 8
8 .\" Arch: 汎用
9 .\"
10 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
11 .\"
12 .\" This code is free software; you can redistribute it and/or modify it
13 .\" under the terms of the GNU General Public License version 2 only, as
14 .\" published by the Free Software Foundation.
15 .\"
16 .\" This code is distributed in the hope that it will be useful, but WITHOUT
17 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19 .\" version 2 for more details (a copy is included in the LICENSE file that
20 .\" accompanied this code).
21 .\"
22 .\" You should have received a copy of the GNU General Public License version
23 .\" 2 along with this work; if not, write to the Free Software Foundation,
24 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
25 .\"
26 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
27 .\" or visit www.oracle.com if you need additional information or have any
28 .\" questions.
29 .\"
30 .pl 99999
31 .TH "tnameserv" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール"
32 .\" -----------------------------------------------------------------
33 .\" * Define some portability stuff
34 .\" -----------------------------------------------------------------
35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
36 .\" http://bugs.debian.org/507673
37 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
38 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
39 .ie \n(.g .ds Aq \(aq
40 .el .ds Aq '
41 .\" -----------------------------------------------------------------
42 .\" * set default formatting
43 .\" -----------------------------------------------------------------
44 .\" disable hyphenation
45 .nh
46 .\" disable justification (adjust text to left margin only)
47 .ad l
48 .\" -----------------------------------------------------------------
49 .\" * MAIN CONTENT STARTS HERE *
50 .\" -----------------------------------------------------------------
51 .SH "NAME"
52 tnameserv \- インタフェース定義言語(IDL)。
53 .SH "概要"
54 .sp
55 .if n \{\
56 .RS 4
57 .\}
58 .nf
59 \fItnameserve\fR \fI\-ORBInitialPort\fR [ \fInameserverport\fR ]
60 .fi
61 .if n \{\
62 .RE
63 .\}
64 .PP
65 \-ORBInitialPort \fInameserverport\fR
66 .RS 4
67 ネーミング・サービスがORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references\fRメソッドの実装に使用するブートストラップ・プロトコルをリスニングする初期ポートです。
68 .RE
69 .SH "説明"
70 .PP
71 Java IDLには、Object Request Broker Daemon (ORBD)が含まれます。ORBDは、ブートストラップ・サービス、一時ネーミング・サービス、永続ネーミング・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーミング・サービスを使用する例では、\fIorbd\fRのかわりに\fItnameserv\fRを使用できます。
72 .PP
73 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlにある
74 orbd(1)または「Naming Service」を参照してください。
75 .PP
76 CORBAのCOS (Common Object Services)ネーミング・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\fItnameserv\fRは、COSネーム・サービスの仕様を単純な形で実装したものです。
77 .PP
78 オブジェクト参照はネームスペースに名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・バインディングと呼ばれます。ネーム・バインディングはネーミング・コンテキストに組み込むことができます。ネーミング・コンテキストはネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは初期ネーミング・コンテキストの下に格納されます。初期ネーミング・コンテキストは、ネームスペースの唯一の永続バインディングです。Java IDLネーミング・サービス・プロセスを停止して再起動すると、残りのネームスペースは失われます。
79 .PP
80 アプレットまたはアプリケーションからCOSネーミング・サービスを使用するためには、そのORBがネーミング・サービスが動作しているホストのポートを知っているか、そのネーミング・サービスの初期ネーミング・コンテキスト文字列にアクセスできる必要があります。ネーム・サービスは、Java IDLのネーム・サービスでもその他のCOS準拠のネーム・サービスでもかまいません。
81 .SS "ネーミング・サービスの起動"
82 .PP
83 Java IDLネーム・サービスは、ネーム・サービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java IDL製品をインストールすると、Java IDLネーミング・サービスを起動するスクリプト(Oracle Solaris:
84 \fItnameserv\fR)または実行可能ファイル(Windows:
85 \fItnameserv\&.exe\fR)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。
86 .PP
87 特に指定しない場合、Java IDLネーミング・サービスは、ORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references methods\fRメソッドの実装に使用するブートストラップ・プロトコルに対してポート900でリスニングします。
88 .sp
89 .if n \{\
90 .RS 4
91 .\}
92 .nf
93 tnameserv \-ORBInitialPort nameserverport&
94 .fi
95 .if n \{\
96 .RE
97 .\}
98 .PP
99 ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Oracle Solarisソフトウェアの実行時、1024より小さいポートでプロセスを開始する場合は、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、UNIXコマンド・シェルで次のように入力します。
100 .sp
101 .if n \{\
102 .RS 4
103 .\}
104 .nf
105 tnameserv \-ORBInitialPort 1050&
106 .fi
107 .if n \{\
108 .RE
109 .\}
110 .PP
111 WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
112 .sp
113 .if n \{\
114 .RS 4
115 .\}
116 .nf
117 start tnameserv \-ORBInitialPort 1050
118 .fi
119 .if n \{\
120 .RE
121 .\}
122 .PP
123 ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティに新しいポート番号を設定します。
124 .SS "異なるホスト上でのサーバーとクライアントの実行"
125 .PP
126 Java IDLとRMI\-IIOPのほとんどのチュートリアルでは、ネーミング・サービス、サーバーおよびクライアントはすべて開発用のマシン上で実行されます。実際にデプロイメントする場合には、クライアントとサーバーを、ネーミング・サービスとは異なるホスト・マシン上で実行することが多くなります。
127 .PP
128 クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティと\fIorg\&.omg\&.CORBA\&.ORBInitialHost\fRプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、「Getting Started Using RMI\-IIOP」
129 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi\-iiop/rmiiiopexample\&.html)に示されています
130 .PP
131 コマンドライン・オプション\fI\-ORBInitialPort nameserverport#\fRと\fI\-ORBInitialHost nameserverhostname\fRを使用して、クライアントとサーバーに対してネーミング・サービスを探す場所を指定することもできます。コマンドライン・オプションを使用してこれを行う方法の1つの例は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.htmlの「Java IDL: The Hello World Example on Two Machines」
132 を参照してください
133 .PP
134 たとえば、一時ネーム・サービス\fItnameserv\fRが、ホスト\fInameserverhost\fRのポート1050上で実行されているとします。さらに、クライアントがホスト\fIclienthost\fR上で実行され、サーバーはホスト\fIserverhost\fR上で実行されているとします。
135 .PP
136 ホスト\fInameserverhost\fR上で\fItnameserv\fRを起動します。
137 .sp
138 .if n \{\
139 .RS 4
140 .\}
141 .nf
142 tnameserv \-ORBInitialPort 1050
143 .fi
144 .if n \{\
145 .RE
146 .\}
147 .PP
148 \fIserverhost\fR上でサーバーを起動します。
149 .sp
150 .if n \{\
151 .RS 4
152 .\}
153 .nf
154 java Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
155 .fi
156 .if n \{\
157 .RE
158 .\}
159 .PP
160
161 \fIclienthost\fR上でクライアントを起動します。
162 .sp
163 .if n \{\
164 .RS 4
165 .\}
166 .nf
167 java Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
168 .fi
169 .if n \{\
170 .RE
171 .\}
172 .SS "ネーミング・サービスの停止"
173 .PP
174 Java IDLネーミング・サービスを停止するには、Unixの場合は、\fIkill\fRなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\fI[Ctrl]+[C]\fRキーを使用します。ネーミング・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。
175 .SH "オプション"
176 .PP
177 \-J\fIoption\fR
178 .RS 4
179 Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
180 .RE
181 .SH "例"
182 .SS "ネームスペースへのオブジェクトの追加"
183 .PP
184 次の例では、ネームスペースに名前を追加する方法を示します。このサンプル・プログラムは、このままの状態で完全に動作する一時ネーム・サービス・クライアントで、次のような単純なツリーを作成するものです。
185 .sp
186 .if n \{\
187 .RS 4
188 .\}
189 .nf
190 Initial Naming Context
191 plans
192 Personal
193 calendar
194 schedule
195 .fi
196 .if n \{\
197 .RE
198 .\}
199 .PP
200 この例で、\fIplans\fRはオブジェクト参照、\fIPersonal\fRは\fIcalendar\fRと\fIschedule\fRの2つのオブジェクト参照を含むネーミング・コンテキストです。
201 .sp
202 .if n \{\
203 .RS 4
204 .\}
205 .nf
206 import java\&.util\&.Properties;
207 import org\&.omg\&.CORBA\&.*;
208 import org\&.omg\&.CosNaming\&.*;
209
210 public class NameClient {
211
212 public static void main(String args[]) {
213
214 try {
215 .fi
216 .if n \{\
217 .RE
218 .\}
219 .PP
220 ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。
221 .sp
222 .if n \{\
223 .RS 4
224 .\}
225 .nf
226 Properties props = new Properties();
227 props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");
228 ORB orb = ORB\&.init(args, props);
229 .fi
230 .if n \{\
231 .RE
232 .\}
233 .PP
234 次のコードでは、初期ネーミング・コンテキストを取得し、それを\fIctx\fRに代入します。2行目では、\fIctx\fRをダミーのオブジェクト参照\fIobjref\fRにコピーします。このobjrefには、あとで様々な名前を割り当ててネームスペースに追加します。
235 .sp
236 .if n \{\
237 .RS 4
238 .\}
239 .nf
240 NamingContext ctx =
241 NamingContextHelper\&.narrow(
242 orb\&.resolve_initial_references("NameService"));
243 NamingContext objref = ctx;
244 .fi
245 .if n \{\
246 .RE
247 .\}
248 .PP
249 次のコードでは、\fItext\fRタイプの名前\fIplans\fRを作成し、それをダミーのオブジェクト参照にバインドします。その後、\fIrebind\fRメソッドを使用して初期ネーミング・コンテキストの下に\fIplans\fRを追加しています。\fIrebind\fRメソッドを使用すれば、\fIbind\fRメソッドを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。
250 .sp
251 .if n \{\
252 .RS 4
253 .\}
254 .nf
255 NameComponent nc1 = new NameComponent("plans", "text");
256 NameComponent[] name1 = {nc1};
257 ctx\&.rebind(name1, objref);
258 System\&.out\&.println("plans rebind successful!");
259 .fi
260 .if n \{\
261 .RE
262 .\}
263 .PP
264 次のコードでは、\fIdirectory\fRタイプの\fIPersonal\fRというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\fIctx2\fRを\fIname\fRにバインドし、初期ネーミング・コンテキストに追加します。
265 .sp
266 .if n \{\
267 .RS 4
268 .\}
269 .nf
270 NameComponent nc2 = new NameComponent("Personal", "directory");
271 NameComponent[] name2 = {nc2};
272 NamingContext ctx2 = ctx\&.bind_new_context(name2);
273 System\&.out\&.println("new naming context added\&.\&.");
274 .fi
275 .if n \{\
276 .RE
277 .\}
278 .PP
279 残りのコードでは、ダミーのオブジェクト参照を\fIschedule\fRと\fIcalendar\fRという名前でネーミング・コンテキスト\fIPersonal\fR(\fIctx2\fR)にバインドします。
280 .sp
281 .if n \{\
282 .RS 4
283 .\}
284 .nf
285 NameComponent nc3 = new NameComponent("schedule", "text");
286 NameComponent[] name3 = {nc3};
287 ctx2\&.rebind(name3, objref);
288 System\&.out\&.println("schedule rebind successful!");
289
290 NameComponent nc4 = new NameComponent("calender", "text");
291 NameComponent[] name4 = {nc4};
292 ctx2\&.rebind(name4, objref);
293 System\&.out\&.println("calender rebind successful!");
294 } catch (Exception e) {
295 e\&.printStackTrace(System\&.err);
296 }
297 }
298 }
299 .fi
300 .if n \{\
301 .RE
302 .\}
303 .SS "ネームスペースの参照"
304 .PP
305 次のサンプル・プログラムでは、ネームスペースをブラウズする方法を示します。
306 .sp
307 .if n \{\
308 .RS 4
309 .\}
310 .nf
311 import java\&.util\&.Properties;
312 import org\&.omg\&.CORBA\&.*;
313 import org\&.omg\&.CosNaming\&.*;
314
315 public class NameClientList {
316
317 public static void main(String args[]) {
318
319 try {
320 .fi
321 .if n \{\
322 .RE
323 .\}
324 .PP
325 ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。
326 .sp
327 .if n \{\
328 .RS 4
329 .\}
330 .nf
331 Properties props = new Properties();
332 props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");
333 ORB orb = ORB\&.init(args, props);
334 .fi
335 .if n \{\
336 .RE
337 .\}
338 .PP
339 次のコードでは、初期ネーミング・コンテキストを取得しています。
340 .sp
341 .if n \{\
342 .RS 4
343 .\}
344 .nf
345 NamingContext nc =
346 NamingContextHelper\&.narrow(
347 orb\&.resolve_initial_references("NameService"));
348 .fi
349 .if n \{\
350 .RE
351 .\}
352 .PP
353 \fIlist\fRメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストから\fIBindingListHolder\fRに返されます。残りのバインディングは、\fIBindingIteratorHolder\fRに返されます。
354 .sp
355 .if n \{\
356 .RS 4
357 .\}
358 .nf
359 BindingListHolder bl = new BindingListHolder();
360 BindingIteratorHolder blIt= new BindingIteratorHolder();
361 nc\&.list(1000, bl, blIt);
362 .fi
363 .if n \{\
364 .RE
365 .\}
366 .PP
367 次のコードでは、返された\fIBindingListHolder\fRからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。
368 .sp
369 .if n \{\
370 .RS 4
371 .\}
372 .nf
373 Binding bindings[] = bl\&.value;
374 if (bindings\&.length == 0) return;
375 .fi
376 .if n \{\
377 .RE
378 .\}
379 .PP
380 残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
381 .sp
382 .if n \{\
383 .RS 4
384 .\}
385 .nf
386 for (int i=0; i < bindings\&.length; i++) {
387
388 // get the object reference for each binding
389 org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name);
390 String objStr = orb\&.object_to_string(obj);
391 int lastIx = bindings[i]\&.binding_name\&.length\-1;
392
393 // check to see if this is a naming context
394 if (bindings[i]\&.binding_type == BindingType\&.ncontext) {
395 System\&.out\&.println("Context: " +
396 bindings[i]\&.binding_name[lastIx]\&.id);
397 } else {
398 System\&.out\&.println("Object: " +
399 bindings[i]\&.binding_name[lastIx]\&.id);
400 }
401 }
402 } catch (Exception e) {
403 e\&.printStackTrace(System\&.err)
404 }
405 }
406 }
407 .fi
408 .if n \{\
409 .RE
410 .\}
411 .SH "関連項目"
412 .sp
413 .RS 4
414 .ie n \{\
415 \h'-04'\(bu\h'+03'\c
416 .\}
417 .el \{\
418 .sp -1
419 .IP \(bu 2.3
420 .\}
421 orbd(1)
422 .RE
423 .br
424 'pl 8.5i
425 'bp