Java Enterprise in a Nutshell, Second Edition

Name

idlj: The Java IDL Compiler — JDK 1.3 and later^[48]

Synopsis

idlj [ options ] IDLfile

Description

The idlj compiler generates Java source files from interfaces, modules, and type descriptions defined in IDL. The compiler implements the standard IDL-to-Java mapping defined by the OMG.

The idlj compiler accepts the standard IDL preprocessor directives, such as #include, which includes declarations from another IDL file, and #define, which defines symbols to be used for conditional compilation with #ifdef directives.

Run with no arguments at all, idlj generates all the client-side Java classes mapped from the specified IDL file. To generate both client and server-side Java bindings, you need to use the -fall option described later.

As of JDK 1.4, idlj generates POA-compliant server-side classes. The server skeletons inherit from org.omg.PortableServer.Servant and use the POA operations to implement the skeleton. In JDK 1.3, idlj generates server classes based on the nonstandard ImplBase inheritance scheme. The ImplBase scheme can also be used in JDK 1.4, by using the -oldImplBase option described later.

Options

-d symbol

Defines the named symbol during preprocessing of the IDL file. Invoking idlj:

% idlj -d foobar Account.idl

is equivalent to placing the following preprocessing directive at the top of the Account.idl file:

#define foobar

-emitAll

By default, idlj emits Java mappings only for entities found directly in the specified IDL file. This options causes idlj to emit Java mappings ...