idlj.1 revision 12442:aa8e52dfeee9
t
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

"idlj" "1" "2013��11��21��" "JDK 8" "Java IDL������RMI-IIOP������"
-----------------------------------------------------------------
* 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 - ��������������������������������(IDL)����������������Java����������������������������
"����"

.\}

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
 
.\} ������������org��org.omg��������org.omg������������������������������������������������������������������������������������������������������������-pkgTranslate������������������������������������������������������������������������������

-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