java_developerkit.htm

写给JSP初级程序员的书

              API，不使用HTML框架，并且不支持内部类。该选项还自动将索引分割成每个字母一个文件。如果想要这种外观，则该选项比javadoc 
              1.1优越之处等于修正了一些错误。<br>
              -sourcepath sourcepathlist <br>
              当将包名传递到javadoc命令中时，指定定位源文件（.java）的搜索路径。注意只有当用 javadoc命令指定包名时才能使用sourcepath选项 
              -- 它将不会查找传递到javadoc命令中的.java文件。如果省略-sourcepath，则javadoc使用类路径查找源文件。<br>
              -classpath classpathlist 指定javadoc将在其中查找引用类的路径 -- 引用类是指带文档的类加上它们引用的任何类。Javadoc将搜索指定路径的所有子目录。classpathlist可以包括多个路径，彼此用逗号分隔。<br>
              -bootclasspath classpathlist 指定自举类所在路径。它们名义上是Java平台类。这个bootclasspath是Javadoc将用来查找源文件和类文件的搜索路径的一部分。在 
              classpathlist中用冒号（:）分隔目录。<br>
              -extdirs dirlist 指定扩展类所在的目录。它们是任何使用Java扩展机制的类。这个 extdirs是Javadoc将用来查找源文件和在文件的搜索路径的一部分。在dirlist中用冒号（:）分隔目录。<br>
              -verbose 在javadoc运行时提供更详细的信息。不使用verbose选项时，将显示加载源文件、生成文档（每个源文件一条信息）和排序的信息。verbose选项导致打印额外的信息，指定解析每个java源文件的毫秒数。<br>
              -locale language_country_variant 指定javadoc在生成文档时使用的环境。<br>
              -encoding name 指定源文件编码名，例如EUCJIS/SJIS。如果未指定该选项，则使用平台缺省转换器。<br>
              -J[flag] 将flag直接传递给运行javadoc的运行时系统java。注意在J和flag之间不能有空格。<br>
              标准 Doclet 提供的选项<br>
              -d directory 指定javadoc保存生成的HTML件的目的目录。省略该选项将导致把文件保存到当前目录中。其中directory可以是绝对路径或相对当前工作目录的相对路径。<br>
              -use 对每个带文档类和包包括一个“用法”页。该页描述使用给定类或包的任何 API 的包、类、方法、构造函数和域。对于给定类 
              C，使用类 C 的任何东西将包括 C 的子类、声明为 C 的域、返回 C 的方法以及具有 C 类型参数的方法和构造函数。 <br>
              -version 在生成文档中包括 @version 文本。缺省地将省略该文本。<br>
              -author 在生成文档中包括 @author 文本。<br>
              -splitindex 将索引文件按字母分割成多个文件，每个字母一个文件，再加上一个包含所有以非字母字符开头的索引项的文件。<br>
              -windowtitle[title] 指定放入 HTML &lt;title&gt; 标记中的标题。它将出现在窗口标题栏中和为该页创建的任何浏览器书签（最喜爱的位置）中。该标题不应该包含任何 
              HTML 标记，因为浏览器将不能正确解释它们。在 title 中的任何内部引号必须转义。如果省略 -windowtitle，则 
              Javadoc 对该选项使用 -doctitle 的值。 <br>
              -doctitle[title] 指定放置在靠近概述概览文件顶部的标题。该标题将作为一级标题，居中地直接放在导航栏下面。title 
              可包含 html 标记和空格，但是如果这样，则必须用引号将它括起。在 title 中的任何内部引号必须转义。<br>
              -title[title] 该选项不再存在。它仅存在于 Javadoc 1.2 的 Beta 版中。它已重命名为 -doctitle。重命名该选项是为了更清楚地表示它定义文档标题而不是窗口标题。<br>
              -header[header] 指定放置在每个输出文件顶部的页眉文本。该页眉将放在上部导航栏的右边。header 可包含 HTML 
              标记和空格，但是如果这样则必须用引号将它括起。在 header 中的任何内部引号必须转义。<br>
              -footer[footer] 指定放置在每个输出文件底部的脚注文本。脚本将放置在下部导航栏的右边。footer 可包含 html 
              标记和空格，但是如果这样，则必须用引号将它括起。在 footer 中的任何内部引号必须转义。<br>
              -bottom[text] 指定放置在每个输出文件底部的文本。该文本将放置在页底，位于下部导航栏的下面。其中 text 可包含 
              HTML 标记和空格，但是如果这样，则必须用引号将它括起。在 text 中的任何内部引号必须转义。<br>
              -link[docURL] 创建链接指向已用 javadoc-生成的外部引用类的文档。参数 docURL是想要链接到的 javadoc-生成的外部文档的 
              URL。该位置可以是相对的或绝对的 URL。<br>
              -linkoffline[docURL][packagelistURL] 该选项为外部引用类名字创建指向文档的链接。<br>
              -group[groupheading]packagepattern:packagepattern:... 将概述页上的包分成指定的组，每组一个表格。用不同的 
              -group 选项指定每个组。各组按命令行中指定的次序出现在页面上。组内的包按字母排序。对于给定 -group 选项，与 packagepattern 
              表达式列表匹配的包出现在标题为 groupheading 的表格中。<br>
              -nodeprecated 防止在文档中生成任何不鼓励使用的 API。它执行-nodeprecatedlist 所做的事情，并且它不在文档其余部分生成任何不鼓励使用的 
              API。当编写代码并不想被不鼓励使用的代码分心时，这是非常有用的。<br>
              -nodeprecatedlist 防止在生成文件中包含不鼓励使用的 API 列表（deprecated-list.html）并防止在导航栏中包含该页的链接。（但是，javadoc 
              继续在文档其余部分生成不鼓励使用的 API。） 如果源代码未包含不鼓励使用的 API，并且想要导航栏更干净，则它是非常有用的。<br>
              -notree 在生成文档中忽略类/接口层次。缺省地，将产生该层次。<br>
              -noindex 在生成文档中忽略索引。缺省地，将产生索引。<br>
              -nohelp 在输出的每页顶部和底部的导航栏中忽略“帮助”链接。<br>
              -nonavbar 防止产生导航栏、页眉和脚注，否则它们将出现在生成页的顶部和底部。它对“bottom”选项没有影响。当只对内容感兴趣并且没有必要导航时，例如仅将文件转换成 
              PostScript 或 PDF 以进行打印，-nonavbar 选项是非常有用的。<br>
              -helpfile[path/filename] 指定顶部和底部导航栏中“帮助”链接所链接到的替代帮助文件 path/filename 
              的路径。不使用该选项时，Javadoc 自动创建帮助文件 help-doc.html，它在 Javadoc 中硬编码。该选项使得可覆盖这种缺省情况。其中 
              filename 可以是任何名字，不局限于 help-doc.html -- Javadoc 将相应调整导航栏中的链接。<br>
              -stylesheetfile[path/filename] 指定替代 HTML 样式表单文件的路径。不使用该选项时，Javadoc 
              将自动创建样式表单文件 stylesheet.css，它在 Javadoc 中硬编码。该选项使得可覆盖这种缺省情况。其中 filename 
              可以是任何名字，不局限于 stylesheet.css。<br>
              -docencoding[name] 指定输出 HTML 文件的编码方式。 </p>
            <p><br>
              javah</p>
            <p>功能说明：<br>
              C 头文件和 Stub 文件生成器。javah 从 Java 类生成 C 头文件和 C 源文件。这些文件提供了连接胶合，使 Java 
              和 C 代码可进行交互。 <br>
              语法：<br>
              javah [ 命令选项 ] fully-qualified-classname. . .<br>
              javah_g [ 命令选项 ] fully-qualified-classname. . .<br>
              补充说明：<br>
              javah 生成实现本地方法所需的 C 头文件和源文件。C 程序用生成的头文件和源文件在本地源代码中引用某一对象的实例变量。.h 
              文件含有一个 struct 定义，该定义的布局与相应类的布局平行。该 struct 中的域对应于类中的实例变量。<br>
              头文件名以及在头文件中所声明的结构名都来源于类名。如果传给 javah 的类是在某个包中，则头文件名和结构名前都要冠以该包名。下划线 
              (_) 用作名称分隔符。<br>
              缺省情况下，javah 为每个在命令行中列出的类都创建一个头文件，且将该文件放在当前目录中。用 -stubs 选项创建源文件。用 
              -o 选项将所有列出类的结果串接成一个单一文件。<br>
              缺省情况下，javah 为每个在命令行中列出的类都创建一个头文件，且将该文件放在当前目录中。用 -stubs 选项创建源文件。用 
              -o 选项将所有列出类的结果串接成一个单一文件。 <br>
              命令选项<br>
              -o[输出文件] 将命令行中列出的所有类的头文件或源文件串接到输出文件中。-o 或 -d 两个选项只能选择一个。<br>
              -d[目录] 设置 javah 保存头文件或 stub 文件的目录。-d 或 -o 两个选项只能选择一个。<br>
              -stubs 使 javah 从 Java 对象文件生成 C 声明。<br>
              -verbose 指明长格式输出，并使 javah 将所生成文件的有关状态的信息输出到标准输出设备中。<br>
              -help 输出 javah 用法的帮助信息。<br>
              -version 输出 javah 的版本信息。 <br>
              -jni 使 javah 创建一输出文件，该文件包含 JNI 风格的本地方法函数原型。这是缺省输出，所以 -jni 的使用是可选的。<br>
              -classpath[路径] 指定 javah 用来查询类的路径。如果设置了该选项，它将覆盖缺省值或 CLASSPATH 环境变量。目录用冒号分隔。<br>
              -bootclasspath[路径] 指定加载自举类所用的路径。缺省情况下，自举类是实现核心 Java 平台的类，位于 jrelib<br>
              t.jar 和 jrelibi18n.jar 中。<br>
              -old 指定应当生成旧 JDK1.0 风格的头文件。<br>
              -force 指定始终写输出文件。</p>
            <p><br>
              javap</p>
            <p>功能说明：<br>
              Java 类文件解析器。<br>
              语法：<br>
              javap [ 命令选项 ] class. . .<br>
              补充说明：<br>
              javap 命令用于解析类文件。其输出取决于所用的选项。若没有使用选项，javap 将输出传递给它的类的 public 域及方法。javap 
              将其输出到标准输出设备上。<br>
              命令选项<br>
              -help 输出 javap 的帮助信息。<br>
              -l 输出行及局部变量表。 <br>
              -b 确保与 JDK 1.1 javap 的向后兼容性。<br>
              -public 只显示 public 类及成员。<br>
              -protected 只显示 protected 和 public 类及成员。<br>
              -package 只显示包、protected 和 public 类及成员。这是缺省设置。<br>
              -private 显示所有类和成员。<br>
              -J[flag] 直接将 flag 传给运行时系统。<br>
              -s 输出内部类型签名。<br>
              -c 输出类中各方法的未解析的代码，即构成 Java 字节码的指令。<br>
              -verbose 输出堆栈大小、各方法的 locals 及 args 数。<br>
              -classpath[路径] 指定 javap 用来查找类的路径。如果设置了该选项，则它将覆盖缺省值或 CLASSPATH 环境变量。目录用冒号分隔。<br>
              - bootclasspath[路径] 指定加载自举类所用的路径。缺省情况下，自举类是实现核心 Java 平台的类，位于 jrelib<br>
              t.jar 和 jrelibi18n.jar 中。<br>
              -extdirs[dirs] 覆盖搜索安装方式扩展的位置。扩展的缺省位置是 jrelibext。 </p>
            <br>
            <!-- #EndEditable --></td>
          <td width="20">&nbsp;</td>
        </tr>
        <tr> 
          <td width="20" height="11">&nbsp;</td>
          <td width="541" height="11"><!-- #BeginEditable "7" --><!-- #EndEditable --></td>
          <td width="101" height="11"> 
            
          </td>
          <td width="20" height="11">&nbsp;</td>
        </tr>
      </table><div align="center"> <br>
      </div>
      
    </td>
  </tr>
</table>
<div align="center"> 
  
  <br>
</div>
</body>
<!-- #EndTemplate -->
</html>