Invokes the JacORB idl compiler.
To use the jacidl task, the user should copy the idl.jar file from
the jacorb distribution into the $ANT_HOME/lib directory.
The second step would be to add a taskdef line into the build.xml
file:
The task currently supports all options of the idl compiler except for the<taskdef name="jacidl" classname="org.jacorb.idl.JacIDL"/>
-i2jpackage
and the -i
options.Attribute | Description | Required |
srcdir | location of the idl files. | Yes |
destdir | location of the generated java files. | Yes |
includes | comma-separated list of patterns of files that must be included; all files are included when omitted. |
No |
includesfile | the name of a file that contains include patterns | No |
excludes | comma-separated list of patterns of files that must be excluded; files are excluded when omitted. |
No |
excludesfile | the name of a file that contains exclude patterns | No |
defaultexcludes | indicates whether default excludes should be used (yes
| no) ; defaultexcludes are used when omitted |
No |
includepath | the path the idl compiler will use to search for included files. | No |
packageprefix | apply <prefix> to all names in the generated
Java code and put code into package <prefix> . |
No |
parseonly | only perform syntax check without generating code; defaults to false. | No |
noskel | disables generation of POA skeletons; defaults to false. | No |
nostub | disables generation of client stubs; defaults to false. | No |
sloppyforward | allow forward declarations without later definitions; defaults to false. | No |
sloppynames | less strict checking of names for backward compatibility; defaults to false. | No |
generateir | generate information required by the Interface Repository; defaults to false. | No |
globalimport | generated Java code will include import statements for all globay types; defaults to false. | No |
all | generate code for all IDL files, even included ones; defaults to false. | No |
nofinal | generate class definitions that are not final; defaults to false. | No |
debuglevel | set the debug level from 0 to 4; defaults to 0. | No |
<define>
and
<undefine>
elements.
The task also supports nested<include>
,
<exclude>
and
<patternset>
elements
<jacidl destdir="${generate}" srcdir="${idl}" />
compiles all *.idl files under the ${idl} directory and stores the .java files in the ${generate} directory.
<jacidl destdir="${generate}" srcdir="${idl}"> <define key="GIOP_1_1" value="1"< </jacidl>
like above, but additionaly defines the symbol GIOP_1_1 and sets its (optional) value to 1.
<jacidl destdir="${generate}" srcdir="${idl}" excludes="**/*foo.idl" />
like the first example, but exclude all files which end with foo.idl.