Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
Title: idlj
Language: Japanese
Date: 2013��11��21��
SectDesc: Java IDL������RMI-IIOP������
Software: JDK 8
Arch: ����
Part Number: E58103-01
Doc ID: JSSON
* Define some portability stuff
-----------------------------------------------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
http://bugs.debian.org/507673
http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-----------------------------------------------------------------
* set default formatting
-----------------------------------------------------------------
disable hyphenation
disable justification (adjust text to left margin only)
-----------------------------------------------------------------
* MAIN CONTENT STARTS HERE *
-----------------------------------------------------------------
.\}
idlj [ options ] idlfile
options
����������������������������������������������������options��������������������idlfile����������������������������������
idlfile
����������������������(IDL)������������������������������������
IDL-to-Java������������������������IDL����������������Java����������������������������������������������������http://docs.oracle.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping.html������ Java IDL: Java������������������IDL��������������������
IDL-to-Java������������������������������������idltojava��������������������������������
����idlj����������������������������������������������My.idl������������IDL����������������������
.\}
idlj My.idl
������������������������
.\}
idlj -fclient My.idl
������������������������������������������������������������������������������������������������������������������������POA (����������)������
.\}
idlg -fserver My.idl
������������������������������������������������������������������������������(����������)��������1����������������
.\}
idlj -fclient -fserver My.idl idlj -fall My.idl
��������������������������2������������������������������������������Tie������������Tie������������������������������
����������������������������. ��������������������������������������������������������������������My.idl����My��������������������������������������MyPOA.java������������������������������My������������������������������������������My����������������MyPOA����������������������������������MyPOA.java����http://docs.oracle.com/javase/8/docs/api/org/omg/PortableServer/Servant.html������ org.omg.PortableServer.Servant��������������������������������������������������
My��������������������������������������IDL����������������������������������callHandler������������������������������������������������
����������������������������������(POA)��PortableServer��������������������������Servant����������������http://docs.oracle.com/javase/8/docs/technotes/guides/idl/POA.html������ ����������������������������������(POA)��������������������
Java������������������������Servant����Java��org.omg.PortableServer.Servant����������������������������������������POA������������������������������������������������������������������������������������������������������������������������POA��������������������������������������������������������������������������������������������������������
����������������1������������������-oldImplBase������������������Java SE 1.4������������������Java����������������������������������������������������������������������������-oldImplBase��������������������������API����������������������������������������Java SE 1.3��������������������������������������������������������������������������make��������������������-oldImplBase��������idlj����������������������������������������������������POA��������������������������������������������������������������������������������������������������������������������
.\}
idlj -fclient -fserver -oldImplBase My.idl idlj -fall -oldImplBase My.idl
My.idl����My��������������������������������������_MyImplBase.java������������������������������My������������������������������������������My����������������_MyImplBase����������������������������������
Tie����������. ����1������������������������Tie������������������������������������������������������������������Tie������������������������������������������������������������������������������������������������������������Tie����������������������������������������
.\}
idlj -fall My.idl idlj -fallTIE My.idl
My����������������������2����������������������MyPOATie.java����������������MyPOATie����������������������������delegate������������������������������������POA��������������������������������������������POA������������delegate��������������������������������������������������MyOperations����������������������������������������������������������������������������������������������ORB����������������������������������������MyPOATie������������������������������������������
.\}
ORB orb = ORB.init(args, System.getProperties()); // Get reference to rootpoa & activate the POAManager POA rootpoa = (POA)orb.resolve_initial_references("RootPOA"); rootpoa.the_POAManager().activate(); // create servant and register it with the ORB MyServant myDelegate = new MyServant(); myDelegate.setORB(orb); // create a tie, with servant being the delegate. MyPOATie tie = new MyPOATie(myDelegate, rootpoa); // obtain the objectRef for the tie My ref = tie._this(orb);
������������������������������������������������������������Tie��������������������������������Java��������������������������������������������������������������������������������������������1��������������������������������������������������������������������Tie����������������������������������������������������������������������������������������������������������������1����������������������������������������������������������������������������������1��������������
������������������������Java SE 1.4��������������������Java��������������������IDL����������������������������Tie����������������������������
.\}
idlj -oldImplBase -fall My.idl idlj -oldImplBase -fallTIE My.idl
My����������������������������������My_Tie.java����������������My_Tie����������������������������impl������������������������impl��������������������������������������������������HelloOperations������������������������������������������������������������������������������������������������������ORB����������������������������������������My_Tie������������������������������������
.\}
ORB orb = ORB.init(args, System.getProperties()); // create servant and register it with the ORB MyServant myDelegate = new MyServant(); myDelegate.setORB(orb); // create a tie, with servant being the delegate. MyPOATie tie = new MyPOATie(myDelegate); // obtain the objectRef for the tie My ref = tie._this(orb);
��������������������������������������������������������������������idlj -td /altdir My.idl��������������������������������������
My����������������������������������������./My.java����������/altdir/My.java��������������������
My.idl��������������idl��������������MyOther.idl����������������������������������������MyOther.idl����������������������������������������������������������������������������������/includes������������������������������������������������������������
.\}
idlj -i /includes My.idl
����������/moreIncludes������Another.idl��My.idl����������������������������������������������������������������������������������
.\}
idlj -i /includes -i /moreIncludes My.idl
����������������include������������������������������������������������������������������������������������������������������������������������������������������������������CLASSPATH����������������������������������������idl.config��������������������������������������idl.config��������������������������������������
.\}
includes=/includes;/moreIncludes
����������������������������������������������������������������������������������������������������������������������������(;)����������������������������������������������������������������������Windows����������������������������������������Solaris��Linux������OS X����������������������������������������
������������������������������������idl����������������������������������������������������������������Java������������������������������������������������������������������������������������������������������������������2����idl������������������������������
.\}
My.idl file: #include <MyOther.idl> interface My { }; MyOther.idl file: interface MyOther { };
��������������������������������������������������������������������������#include������������������������������������������#include������������������������������������������������������������������������#include��������������������#include��������������������������������������������������������������������������������������������������������������������������������������������Java����������������������������������������������
.\}
My.idl file: #include <MyOther.idl> interface My { #include <Embedded.idl> }; MyOther.idl file: interface MyOther { }; Embedded.idl enum E {one, two, three};
idlj My.idl ������������Java����������������������������������������������������������#include����������������������MyOther.java����������������������������������������������#include����������������������E.java������������������Embedded.idl����������My��������������������������������������������������������My������������(��������MyPackage��)��������������������-emitAll����������������������������������������������������������������������������������������
.\}
./MyHolder.java ./MyHelper.java ./_MyStub.java ./MyPackage ./MyPackage/EHolder.java ./MyPackage/EHelper.java ./MyPackage/E.java ./My.java
ABC������������������������������������������������IDL��������������������������������
.\}
Widgets.idl file: module Widgets { interface W1 {...}; interface W2 {...}; };
IDL-to-Java����������������������������������������������W1������W2��������Java������������������Widgets��������������������������������������������������������������������com.<company name>������������������������������������������������������������������������������������com.abc.Widgets��������������������������������������������Widgets����������������������������������������������������
.\}
idlj -pkgPrefix Widgets com.abc Widgets.idl
Widgets.idl����������������������IDL��������������������������������������-pkgPrefix������������������������������������������������IDL������������com.abc.Widgets��������������������Widgets������������������������������������
����������������������������������������������������idl.config������������������������������������������������������������������PkgPrefix.<type>=<prefix>����������������������������������������������PkgPrefix.Widgets=com.abc����������������������������������������ID������������������
������������������������IDL��������������������������������������������������������������������������������������������������������������������������������������������������������������������idlj -d MYDEF My.idl ����My.idl������#define MYDEF��������������������������������
Java������������������������������������������������-keep������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������(��������������������������������������������������������������)��-keep������������������������������idlj -keep My.idl����������������������������������������������������������������������
IDL-to-Java��������������������������������������������������������-v����������������������idlj -v My.idl����������������������������������������
����������������������������������������������������������
IDL-to-Java��������������������������������������������������������idlj -version��-version������������������������
������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������
-d symbol
������������������IDL������������������������������������������������
.\}
#define symbol
-demitAll
#include����������������������������������������������������������������
-fside
������������������������������������side����������������client��server��serverTIE��all������allTIE����������������-fserverTIE������-fallTIE��������������������������������������������������������������������������������������-fclient��������������������������
-i include-path
����������������������������������������������������������������������������������������������������������������������������������������
-i keep
��������������������������������������������������������������������������������������������������������������
-noWarn
����������������������������������������
-oldImplBase
1.4��������JDK ORB������������������������������������������������������POA��������������������������������������������������������������������������������ImplBase����������������������������������������������������������������������������������Java����������������������������������������������
-pkgPrefix type prefix
type����������������������������������������������������������������������������������������������������Java��������������prefix����������������������������type����������������������������������������������������������������������������IDL��������������������������
-pkgTranslate type package
������������������������type��������������������������Java��������������������������������������������������������������package��������������������������pkgPrefix��������������������type������������������������������������������������������������������������������������IDL���������������������������������������������������������������� ���������������������������������������������������������������������������������� ��������:
.\}
pkgTranslate type pkg -pkgTranslate type2.baz pkg2.fizz
.\}
type => pkg type.ext => pkg.ext type.baz => pkg2.fizz type2.baz.pkg => pkg2.fizz.pkg
-skeletonName xxx%yyy
xxx%yyy������������������������������������������������������������������������������������POA����������������������%POA (-fserver������-fall)��oldImplBase��������������_%ImplBase (-oldImplBase)������(-fserver������-fall))��
-td dir
����������������������������������������������������dir����������������
-tieName xxx%yyy
������������������xxx%yyy������������������������������������������POA����������������������%POA (-fserverTie������-fallTie)��oldImplBase tie��������������_%Tie (-oldImplBase)������(-fserverTie������-fallTie))��
-nowarn��-verbose
����������������������������������
-version
����������������������������������
��������������������������������������������������IDL����������������Object������ValueBase����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������
fixed������IDL����������������������������
������������������������������������������������������������������������impl������������������������������������������������������������������ServerDelegate DSI����������NullPointerException����������������
'pl 8.5i 'bp