java_developerkit.htm

写给JSP初级程序员的书

              jarsigner [ 命令选项 ] jar-file alias<br>
              jarsigner -verify [ 命令选项 ] jar-file<br>
              补充说明：<br>
              jarsigner 工具用于两个目的： <br>
              1:为 Java 归档 (JAR) 文件签名 <br>
              2:校验已签名的 JAR 文件的签名和完整性<br>
              命令选项<br>
              -keystore[url] 指定密钥仓库的 URL。缺省值是用户的宿主目录中的 .keystore 文件，它由系统属性“user.home”决定。<br>
              -storetype[storetype] 指定要被实例化的密钥仓库类型。默认的密钥仓库类型是安全属性文件中 &quot;keystore.type&quot; 
              属性值所指定的那个类型，由 java.security.KeyStore 中的静态方法 getDefaultType 返回。<br>
              -storepass[password] 指定访问密钥仓库所需的口令。这仅在签名（不是校验）JAR 文件时需要。在这种情况下，如果命令行中没有提供 
              -storepass 选项，用户将被提示输入口令。<br>
              -keypass[password] 指定用于保护密钥仓库项（由命令行中指定的别名标出）的私钥的口令。使用 jarsigner 
              为 JAR 文件签名时需要该口令。如果命令行中没有提供口令，且所需的口令与密钥仓库的口令不同，则将提示用户输入它。<br>
              -sigfile[file] 指定用于生成 .SF 和 .DSA 文件的基本文件名。<br>
              -signedjar[file] 指定用于已签名的 JAR 文件的名称。<br>
              -verify 如果它出现在命令行中，则指定的 JAR 文件将被校验，而不是签名。如果校验成功，将显示“jar verified”。如果试图校验未签名的 
              JAR 文件，或校验被不支持的算法（例如未安装 RSA 提供者时使用的 RSA）签名的 JAR 文件，则将有如下显示： &quot;jar 
              is unsigned. (signatures missing or not parsable)&quot; 。<br>
              -certs 如果它与 -verify 和 -verbose 选项一起出现在命令行中，则输出将包括 JAR 文件的每个签名人的证书信息。<br>
              -verbose 如果它出现在命令行中，则代表“verbose”模式，它使 jarsigner 在 JAR 签名或校验过程中输出额外信息。<br>
              -internalsf 过去，JAR 文件被签名时产生的 .DSA（签名块）文件包含一个同时产生的 .SF 文件（签名文件）的完整编码副本。这种做法已被更改。为了减小输出 
              JAR 文件的整个大小，缺省情况下 .DSA 文件不再包含 .SF 文件的副本。但是如果 -internalsf 出现在命令行中，将采用旧的做法。该选项主要在测试时有用；实际上不应使用它，因为这样将消除有用的优化。<br>
              -sectionsonly 如果它出现在命令行中，则 JAR 文件被签名时生成的 .SF 文件（签名文件）将不包括含有整个清单文件的散列的头。它仅包含 
              与 JAR 中每个单独的源文件相关的信息和散列。该选项主要在测试时有用；实际上不应使用它，因为这样将消除有用的优化。<br>
              -J[javaoption] 将指定的 javaoption 串直接传递到 Java 解释器。(（jarsigner 实际上是解释器的一个 
              “wrapper”）。该选项不应含有任何空格。它有助于调整执行环境或内存使用。要获得可用的解释器选项的清单，可在命令行键入 java 
              -h 或 java -X。 <br>
            </p>
            <br>
            keytool 
            <p>功能说明：<br>
              管理由私钥和认证相关公钥的 X.509 证书链组成的密钥仓库（数据库）。还管理来自可信任实体的证书。<br>
              语法：<br>
              keytool [ 命令 ]<br>
              补充说明：<br>
              keytool 是个密钥和证书管理工具。它使用户能够管理自己的公钥/私钥对及相关证书，用于（通过数字签名）自我认证（用户向别的用户/服务认证自己）或数据完整性以及认证服务。它还允许用户储存他们的通信对等者的公钥（以证书形式）。</p>
            <p><br>
              native2ascii</p>
            <p>功能说明：<br>
              将含有本地编码字符（既非 Latin1 又非 Unicode 字符）的文件转换为 Unicode 编码字符的文件。<br>
              语法：<br>
              native2ascii [options] [inputfile [outputfile]]<br>
              补充说明：<br>
              Java 编译器和其它 Java 工具只能处理含有 Latin-1 和/或 Unicode 编码（udddd 记号）字符的文件。native2ascii 
              将含有其它字符编码的文件转换成含 Latin-1 和/或 Unicode 编码字符的文件。若省略 outputfile，则使用标准输出设备输出。此外，如果也省略 
              inputfile，则使用标准输入设备输入。 <br>
              命令选项<br>
              -reverse 执行相反的操作：将含 Latin-1 和/或 Unicode 编码字符的文件转换成含本地编码字符的文件。<br>
              -encoding[encoding_name] 指定转换过程使用的编码名称。缺省的编码从系统属性 file.encoding 
              中得到。</p>
            <p><br>
              appletviewer</p>
            <p>功能说明：<br>
              Java applet 浏览器。appletviewer 命令可在脱离万维网浏览器环境的情况下运行 applet。<br>
              语法：<br>
              appletviewer [ threads flag ] [ 命令选项 ] urls ...<br>
              补充说明：<br>
              appletviewer 命令连接到 url 所指向的文档或资源上，并在其自身的窗口中显示文档引用的每个 applet。注意：如果 
              url 所指向的文档不引用任何带有 OBJECT、EMBED 或 APPLET 标记的 applet，那么 appletviewer 
              就不做任何事情。<br>
              命令选项<br>
              -debug 在 Java 调试器 jdb 中启动 appletviewer，使您可以调试文档中的 applet。 <br>
              -encoding[编码名称] 指定输入 HTML 文件的编码名称。<br>
              -J[javaoption] 将 javaoption 字符串作为单个参数传给运行 appletviewer 的 Java 解释器。参数不能含有空格。由多重参数组成的字符串，其中的每个参数都必须以前缀 
              -J 开头，该前缀以后将被除去。这在调整编译器的执行环境或内存使用时将很有用。</p>
            <p><br>
              extcheck</p>
            <p>功能说明：<br>
              extcheck 检测目标 jar 文件与当前安装方式扩展 jar 文件间的版本冲突。<br>
              语法：<br>
              extcheck [ -verbose ] targetfile.jar<br>
              补充说明：<br>
              extcheck 实用程序检查指定 Jar 文件的标题和版本与 JDK TM 软件中所安装的扩展是否有冲突。在安装某个扩展前，可以用该实用程序查看是否已安装了该扩展的相同版本或更高的版本。<br>
              extcheck 实用程序将 targetfile.jar 文件清单的 specification-title 和 specification-version 
              头与当前安装在扩展目录下所有 Jar 文件的相对应的头进行比较（缺省扩展目录为 jre/lib/ext）。extcheck 实用程序比较版本号的方式与 
              java.lang.Package.isCompatibleWith 方法相同。若未检测到冲突，则返回代码为 0。如果扩展目录中任何一个 
              jar 文件的清单有相同的 specification-title 和相同的或更新的 specification-version 
              号，则返回非零错误代码。如果 targetfile.jar 的清单中没有 specification-title 或 specification-version 
              属性，则同样返回非零错误代码。<br>
              命令选项<br>
              -verbose 对扩展目录中的 Jar 文件进行检查时，列出文件。此外，还报告目标 jar 文件的清单属性及所有冲突的 jar 
              文件。</p>
            <p><br>
              jar</p>
            <p>功能说明：<br>
              Java归档工具<br>
              语法：<br>
              jar [ 命令选项 ] [manifest] destination input-file [input-files]<br>
              补充说明：<br>
              jar工具是个java应用程序，可将多个文件合并为单个JAR归档文件。jar是个多用途的存档及压缩工具，它基于ZIP和ZLIB压缩格式。然而，设计jar的主要目的是便于将java 
              applet或应用程序打包成单个归档文件。将applet或应用程序的组件(.class 文件、图像和声音)合并成单个归档文件时，可以用java代理(如浏览器)在一次HTTP事务处理过程中对它们进行下载，而不是对每个组件都要求一个新连接。这大大缩短了下载时间。jar还能压缩文件，从而进一步提高了下载速度。此外，它允许applet的作者对文件中的各个项进行签名，因而可认证其来源。jar工具的语法基本上与tar命令的语法相同。<br>
              命令选项<br>
              -c 在标准输出上创建新归档或空归档。<br>
              -t 在标准输出上列出内容表。<br>
              -x[file] 从标准输入提取所有文件，或只提取指定的文件。如果省略了file，则提取所有文件；否则只提取指定文件。<br>
              -f 第二个参数指定要处理的jar文件。在-c(创建)情形中，第二个参数指的是要创建的jar文件的名称(不是在标准输出上)。在-t(表(或-x(抽取)这两种情形中，第二个参数指定要列出或抽取的jar文件。<br>
              　-v 在标准错误输出设备上生成长格式的输出结果。<br>
              -m 包括指定的现有清单文件中的清单信息。用法举例：“jar cmf myManifestFile myJarFile *.class”<br>
              -0 只储存，不进行 ZIP 压缩。<br>
              -M 不创建项目的清单文件。<br>
              -u 通过添加文件或更改清单来更新现有的 JAR 文件。例如：“jar -uf foo.jar foo.class”将文件 foo.class 
              添加到现有的JAR文件foo.jar中，而“jar umf manifest foo.jar”则用manifest中的信息更新foo.jar的清单。<br>
              -C 在执行 jar 命令期间更改目录。例如：“jar -uf foo.jar -C classes *”将classes目录内的所有文件加到foo.jar中，但不添加类目录本身。<br>
              程序示例<br>
              1:将当前目录下所有CLASS文件打包成新的JAR文件：<br>
              jar cf file.jar *.class<br>
              2:显示一个JAR文件中的文件列表<br>
              jar tf file.jar<br>
              3:将当前目录下的所有文件增加到一个已经存在的JAR文件中 <br>
              jar cvf file.jar *<br>
            </p>
            <br>
            javadoc
            <p>功能说明<br>
              Java API文档生成器从Java源文件生成API文档HTML页。<br>
              语法：<br>
              javadoc [ 命令选项 ] [ 包名 ] [ 源文件名 ] [ @files ]<br>
              其中[ 包名 ]为用空格分隔的一系列包的名字，包名不允许使用通配符，如（*）。[ 源文件名 ]为用空格分隔的一系列的源文件名，源文件名可包括路径和通配符，如（*）。[ 
              @files ]是以任何次序包含包名和源文件的一个或多个文件。<br>
              补充说明<br>
              Javadoc解析Java源文件中的声明和文档注释，并产生相应的HTML页缺省），描述公有类、保护类、内部类、接口、构造函数、方法和域。<br>
              在实现时，Javadoc要求且依赖于java编译器完成其工作。Javadoc调用部分javac编译声明部分，忽略成员实现。它建立类的内容丰富的内部表示，包括类层次和“使用”关系，然后从中生成HTML。Javadoc还从源代码的文档注释中获得用户提供的文档。<br>
              当Javadoc建立其内部文档结构时，它将加载所有引用的类。由于这一点，Javadoc必须能查找到所有引用的类，包括引导类、扩展类和用户类。<br>
              命令选项<br>
              -overview i&gt;path/filename 指定javadoc应该从path/filename所指定的“源”文件中获取概述文档，并将它放到概述页中（overview-summary.html）。其中path/filename 
              是相对于-sourcepath的相对路径名。<br>
              -public 只显示公有类及成员。<br>
              -protected 只显示受保护的和公有的类及成员。这是缺省状态。<br>
              -package 只显示包、受保护的和公有的类及成员。<br>
              -private 显示所有类和成员。<br>
              -help 显示联机帮助，它将列出这些javadoc和doclet命令行选项。<br>
              -doclet class 指定启动用于生成文档的docle 的类文件。该doclet定义了输出的内容和格式。如果未使用-doclet选项，则javadoc使用标准doclet生成缺省HTML格式。该类必须包含start(Root)法。该启动类的路径由 
              -docletpath选项定义。<br>
              -docletpath classpathlist 指定doclet类文件的路径，该类文件用-doclet选项指定。如果doclet已位于搜索路径中，则没有必要使用该选项。<br>
              -1.1 生成具有用Javadoc 1.1生成的文档的外观和功能的文档。也就是说，页的背景为灰色，用图像做页眉，使用bullet列表而不是表格，具有单层目的目录结构，不包含继承