Manpages

名 前

rmic − Java RMI ス タ ブ コ ン パ イ ラ

形 式

rmic [ −bootclasspath path ] [ −classpath path ]
[ −d directory ] [ −depend ] [ −extdirs path ] [ −g ]
[ −idl ] [ −iiop ] [ −keepgenerated ] [ −J ]
[ −nowarn ] [ −sourcepath path ] [ −vcompat ]
[ −verbose ] [ −v1.1 ] [ −v1.2 ]
package-qualified-class-names

機 能 説 明

rmic コ ン パ イ ラ は 、 リ モ ー ト オ ブ ジ ェ ク ト を 含 ん だ コ ン パ イ ル 後 の Java ク ラ ス の 名 前 か ら 、 ス タ ブ と ス ケ ル ト ン ク ラ ス フ ァ イ ル を 生 成 し ま す 。 リ モ ー ト オ ブ ジ ェ ク ト と は 、 イ ン タ フ ェ ー ス java.rmi.Remote を 実 装 す る オ ブ ジ ェ ク ト で す 。 rmic コ マ ン ド に 指 定 す る ク ラ ス 名 は 、 javac(1) コ マ ン ド で 正 し く コ ン パ イ ル さ れ た ク ラ ス を 表 し 、 か つ パ ッ ケ ー ジ 名 で 完 全 に 修 飾 さ れ て い る 必 要 が あ り ま す 。 次 に 示 す 例 で は 、 HelloImpl と い う ク ラ ス フ ァ イ ル に 対 し て rmic を 実 行 し て い ま す 。

example% rmic hello.HelloImpl こ れ に よ り 、 HelloImpl_Skel.class と HelloImpl_Stub.class の 2 つ の フ ァ イ ル が 生 成 さ れ ま す 。 リ モ ー ト オ ブ ジ ェ ク ト 用 の ス ケ ル ト ン は サ ー バ 側 の エ ン テ ィ テ ィ で 、 実 装 さ れ て い る リ モ ー ト オ ブ ジ ェ ク ト を 呼 び 出 す メ ソ ッ ド を 含 ん で い ま す 。 ス タ ブ と は リ モ ー ト オ ブ ジ ェ ク ト の プ ロ キ シ で 、 リ モ ー ト オ ブ ジ ェ ク ト の メ ソ ッ ド 呼 び 出 し を 実 際 の リ モ ー ト オ ブ ジ ェ ク ト が 存 在 す る サ ー バ へ 転 送 す る 役 目 を 果 た し ま す 。 し た が っ て ク ラ イ ア ン ト に よ る リ モ ー ト オ ブ ジ ェ ク ト の 参 照 は 、 実 際 に は 局 所 ス タ ブ へ の 参 照 と な り ま す 。 ス タ ブ は リ モ ー ト イ ン タ フ ェ ー ス だ け を 実 装 し て い て 、 リ モ ー ト オ ブ ジ ェ ク ト が 実 装 し て い る 局 所 イ ン タ フ ェ ー ス は 扱 い ま せ ん 。 ス タ ブ が 実 装 し て い る リ モ ー ト イ ン タ フ ェ ー ス は 、 リ モ ー ト オ ブ ジ ェ ク ト の も の と ま っ た く 同 一 で す 。 し た が っ て ク ラ イ ア ン ト は 、 キ ャ ス ト し た り 型 チ ェ ッ ク し た り す る の に Java 言 語 の 組 み 込 み 演 算 子 を 使 う こ と が で き ま す 。

オ プ シ ョ ン

以 下 の オ プ シ ョ ン が 使 用 で き ま す 。

−bootclasspath path ブ ー ト ス ト ラ ッ プ ク ラ ス フ ァ イ ル の 位 置 を オ ー バ ー ラ イ ド し ま す 。
−classpath path

rmic が ク ラ ス を 探 す の に 用 い る パ ス を path で 指 定 し ま す 。 こ の 指 定 値 は 、 デ フ ォ ル ト お よ び CLASSPATH 環 境 変 数 の 設 定 値 を オ ー バ ー ラ イ ド し ま す 。 複 数 の デ ィ レ ク ト リ を 指 定 す る 場 合 は コ ロ ン で 区 切 り ま す 。 し た が っ て path の 通 常 の 形 式 は 次 の よ う に な り ま す 。

.:<your_path> 以 下 に 例 を 示 し ま す 。

.:/usr/local/java/classes

Java の デ バ ッ グ ツ ー ル が 使 用 し ま す 。 デ フ ォ ル ト で は 、 行 番 号 だ け が 生 成 さ れ ま す 。

−always ま た は −alwaysgenerate 既 存 の ス タ ブ 、 Tie、 お よ び IDL が 入 力 ク ラ ス よ り 新 し い と き で も 、 強 制 的 に 生 成 し 直 し ま す 。
−factory 生 成 さ れ た IDL で factory キ ー ワ ー ド を 使 い ま す 。
−idlModule fromJavaPackage[.class] toIDLModule

IDLEntity パ ッ ケ ー ジ の マ ッ ピ ン グ を 指 定 し ま す 。 次 に 例 を 示 し ま す 。

−idlModule foo.bar
my::real::idlmod.

−idlFile fromJavaPackage[.class] toIDLFile

IDLEntity フ ァ イ ル の マ ッ ピ ン グ を 指 定 し ま す 。 次 に 例 を 示 し ま す 。

−idlFile test.pkg.X TEST16.idl

−iiop を 指 定 し て rmic を 起 動 す る と 、 次 の 命 名 規 約 に 準 拠 し た ス タ ブ と Tie が 生 成 さ れ ま す 。

_<implementationName>_stub.class

_<interfaceName>_tie.class

−iiop オ プ シ ョ ン は 、 合 わ せ て 以 下 の オ プ シ ョ ン も 指 定 で き ま す 。

−always ま た は −alwaysgenerate 既 存 の ス タ ブ 、 Tie、 お よ び IDL が 入 力 ク ラ ス よ り 新 し い と き で も 、 強 制 的 に 生 成 し 直 し ま す 。

−nolocalstubs 同 じ プ ロ セ ス の ク ラ イ ア ン ト と サ ー バ に 対 し て 最 適 化 さ れ た ス タ ブ を 作 成 し ま せ ん 。
−noValueMethods

−idl オ プ シ ョ ン と と も に 使 用 す る 必 要 が あ り ま す 。 発 行 さ れ た IDL に 、 valuetype メ ソ ッ ド お よ び 初 期 化 子 を 追 加 し ま せ ん 。 こ の メ ソ ッ ド お よ び 初 期 化 子 は 、 valuetype の オ プ シ ョ ン で す 。 −idl オ プ シ ョ ン を 使 う と き は 、 −noValueMethods オ プ シ ョ ン を 指 定 し な い 限 り 生 成 さ れ ま す 。

org.omg.PortableServer.Servant.へ 変 更 し ま す 。
Portable Object Adapter (POA) の PortableServer モ ジ ュ ー ル は 、 ネ イ テ ィ ブ の servant 型 を 定 義 し ま す 。 Java プ ロ グ ラ ミ ン グ 言 語 で は 、 servant 型 は 、 Java の org.omg.PortableServer.Servant ク ラ ス に マ ッ プ さ れ ま す 。 こ れ は す べ て の POA サ ー バ ン ト 実 装 の 基 底 ク ラ ス と し て 機 能 し 、 ア プ リ ケ ー シ ョ ン 開 発 者 が 呼 び 出 せ る 多 数 の メ ソ ッ ド を 提 供 し ま す 。 ま た 、 POA 自 体 が 読 み 出 し た り 、 サ ー バ ン ト 動 作 を 制 御 す る た め に ユ ー ザ が 上 書 き し た り で き る メ ソ ッ ド も 提 供 し ま す 。 CORBA V 2.3.1 の 「 OMG IDL to Java Language Mapping Specfication (ptc/00-01-08.pdf)」 に 基 づ い て い ま す 。