|
|
|
@@ -0,0 +1,117 @@ |
|
|
|
<html> |
|
|
|
|
|
|
|
<head> |
|
|
|
<meta http-equiv="Content-Language" content="en-us"> |
|
|
|
<title>Ant</title> |
|
|
|
</head> |
|
|
|
|
|
|
|
<body> |
|
|
|
|
|
|
|
<h2><a name="zip">Javah</a></h2> |
|
|
|
<h3>Description</h3> |
|
|
|
<p>Generates JNI headers from a Java class.</p> |
|
|
|
<p> When this task executes, it will generate the C header and source files that |
|
|
|
are needed to implement native methods. JNI operates differently depending on |
|
|
|
whether <a href="http://java.sun.com/j2se/1.3/docs/tooldocs/win32/javah.html">JDK1.2</a> |
|
|
|
(or later) or <a href="http://java.sun.com/products/jdk/1.1/docs/tooldocs/win32/javah.html">pre-JDK1.2</a> |
|
|
|
systems are used.</p> |
|
|
|
<h3>Parameters</h3> |
|
|
|
<table border="1" cellpadding="2" cellspacing="0"> |
|
|
|
<tr> |
|
|
|
<td valign="top"><b>Attribute</b></td> |
|
|
|
<td valign="top"><b>Description</b></td> |
|
|
|
<td valign="top" align="center"><b>Required</b></td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">class</td> |
|
|
|
<td valign="top">the fully-qualified name of the class (or classes, |
|
|
|
separated by commas)</td> |
|
|
|
<td align="center" valign="top">Yes</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">outputFile</td> |
|
|
|
<td valign="top">concatenates the resulting header or source files for all the classes listed into this file</td> |
|
|
|
<td align="center" valign="middle" rowspan="2">Yes</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">destdir</td> |
|
|
|
<td valign="top">sets the directory where javah saves the header files or the |
|
|
|
stub files.</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">force</td> |
|
|
|
<td valign="top">specifies that output files should always be written (JDK1.2 only)</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">old</td> |
|
|
|
<td valign="top">specifies that old JDK1.0-style header files should be generated |
|
|
|
(otherwise output file contain JNI-style native method function prototypes) (JDK1.2 only)</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">stubs</td> |
|
|
|
<td valign="top">generate C declarations from the Java object file (used with old)</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">verbose</td> |
|
|
|
<td valign="top">causes Javah to print a message concerning the status of the generated files</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">classpath</td> |
|
|
|
<td valign="top">the classpath to use.</td> |
|
|
|
<td align="center" valign="top">No</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">bootclasspath</td> |
|
|
|
<td valign="top">location of bootstrap class files.</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">extdirs</td> |
|
|
|
<td valign="top"> location of installed extensions.</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
</table> |
|
|
|
<p>Either outputFile or destdir must be supplied, but not both. </p> |
|
|
|
<h3>Examples</h3> |
|
|
|
<pre> <javah destdir="c" class="org.foo.bar.Wibble" /></pre> |
|
|
|
<p>makes a JNI header of the named class, using the JDK1.2 JNI model. Assuming |
|
|
|
the directory 'c' already exists, the file <tt>org_foo_bar_Wibble.h</tt> |
|
|
|
is created there. If this file already exists, it is left unchanged.</p> |
|
|
|
<pre> <javah outputFile="wibble.h"> |
|
|
|
<class name="org.foo.bar.Wibble,org.foo.bar.Bobble"/> |
|
|
|
</javah></pre> |
|
|
|
<p>is similar to the previous example, except the output is written to a file |
|
|
|
called <tt>wibble.h</tt> |
|
|
|
in the current directory.</p> |
|
|
|
<pre> <javah destdir="c" force="yes"> |
|
|
|
<class name="org.foo.bar.Wibble"/> |
|
|
|
<class name="org.foo.bar.Bobble"/> |
|
|
|
<class name="org.foo.bar.Tribble"/> |
|
|
|
</javah></pre> |
|
|
|
<p>writes three header files, one for each of the classes named. Because the |
|
|
|
force option is set, these header files are always written when the Javah task |
|
|
|
is invoked, even if they already exist.</p> |
|
|
|
<pre> <javah destdir="c" verbose="yes" old="yes" force="yes"> |
|
|
|
<class name="org.foo.bar.Wibble"/> |
|
|
|
<class name="org.foo.bar.Bobble"/> |
|
|
|
<class name="org.foo.bar.Tribble"/> |
|
|
|
</javah> |
|
|
|
<javah destdir="c" verbose="yes" stubs="yes" old="yes" force="yes"> |
|
|
|
<class name="org.foo.bar.Wibble"/> |
|
|
|
<class name="org.foo.bar.Bobble"/> |
|
|
|
<class name="org.foo.bar.Tribble"/> |
|
|
|
</javah></pre> |
|
|
|
<p>writes the headers for the three classes using the 'old' JNI format, then |
|
|
|
writes the corresponding .c stubs. The verbose option will cause Javah to |
|
|
|
describe its progress.</p> |
|
|
|
|
|
|
|
<hr> |
|
|
|
|
|
|
|
</body> |
|
|
|
|
|
|
|
</html> |
|
|
|
|
Conor MacNeill