The IDL-to-Java compiler generates Java bindings for a given Interface Definition Language (IDL) file.
The command to invoke the IDL-to-Java code compiler has the general form:
idlj [options] source_IDL
where source_IDL is the name of a file that contains IDL definitions and [options] is any combination of the options in the following list. Options can appear in any order, but must precede the IDL file specification.
Option | Description |
-d symbol | Defines a symbol before compilation. This is equivalent to putting the line #define symbol in an IDL file. It is useful when you want to define a symbol for compilation that is not defined within the IDL file, for example to include debugging code in the bindings. |
-emitAll | Emits all types, including those found in #include files. By default, only those types found in idl file are emitted. For more information, see "Emitting bindings for include files". |
-fside | Defines what bindings to emit. side is one of client, server, all, serverTie, and allTie. This assumes -fclient if the flag is not specified. For more information, see "Emitting client and server bindings" |
-i include_ path | By default, the current directory is scanned for included files. This option adds another directory. For more information, see "Specifying alternative locations for include files". |
-keep | Preserves preexisiting bindings. The default is to generate all of the files without considering if they already exist. If the Java binding files do already exist, this option stops the compiler from overwriting them. This is useful if you have customized those files, which you should not do unless you are very comfortable with their contents. |
-pkgPrefix type package | Wherever type is encountered, ensures it resides within package in
all generated files. Note: type must be a fully qualified, Java-style name. For more information, see "Inserting package prefixes". |
-td target_directory | By default, the compiler outputs bindings to the directory from which it was invoked (the current directory). To direct the output to another directory, specify the target directory immediately following the -td flag. The target directory can be absolute or relative. |
-v, -verbose | Generates status messages so that you can track the progress of compilation. If this option is not selected, messages are not outputed unless there are errors. |
-version | Displays
the build version of the IDL-to-Java compiler. Any additional options appearing
on the command line are ignored. Note: Version information also appears within the bindings generated by the compiler. |