mirror of
https://github.com/apache/ant.git
synced 2025-05-18 14:04:48 +00:00
ff348804c1
git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@276069 13f79535-47bb-0310-9956-ffa450edef68
121 lines
4.7 KiB
HTML
121 lines
4.7 KiB
HTML
<html>
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Language" content="en-us">
|
|
<title>Javah Task</title>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<h2><a name="javah">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>
|
|
|
|
<hr>
|
|
<p align="center">Copyright © 2001-2002,2004 The Apache Software Foundation. All rights
|
|
Reserved.</p>
|
|
</body>
|
|
|
|
</html>
|
|
|