japize - 云端在线

程序：

您的姓名

japize - 以机器可读的格式生成 API 列表。

概要

日本化 [解压] [作为 ] 蜜蜂 | ... +|- ...

商品描述

日本化 是 japitools 的一部分，旨在测试 Java API 之间的兼容性。

它们最初是为测试 Java 本身的免费实现而设计的
与 Sun 的 JDK 兼容，但它们也可用于测试向后兼容性
任何 API 的版本之间。

这些工具是 japize 和 japicompat。 Japize 是一个 Java 程序，它发出一个列表
机器可读格式的 API。 Japicompat 然后获取两个这样的列表并进行比较
它们用于二进制兼容性，正如 Sun 在 Java 语言规范中定义的那样。

至少一个 + 是必须的。 将附加“.japi”和/或“.gz”作为
适当。

“apis”这个词可以用“explicitly”、“byname”、“packages”或“classes”代替。 这些
选项指示是否应将“abC”形式的内容视为类或
包裹。 您可以使用其中一种形式“abcpackage”明确指定这一点，或者
“ab，CClass”。

配置

拉开拉链 禁用使用 gzip 压缩输出。 强烈建议压缩输出
因为它节省了大量的空间。 您可能不想要的唯一情况
使用 gzip 压缩是在内存和 CPU 使用率非常紧张或
您的 JVM 没有正确实现 GZIPOutputStream（在这种情况下，您可能
仍然想手动 gzip 生成的文件）。

as
指定这个选项会告诉 japize 把它的输出写到一个文件中
指定名称。 使用“as”选项写入文件时，japize 坚持
写入以 .japi.gz 结尾的文件名（对于压缩文件）或 .japi（对于压缩文件）
未压缩的文件。 如果您指定的文件名没有正确的扩展名，
japize 将向其添加部件以确保它确实如此。

如果省略“as”选项，japize 将写入标准输出。 在这种情况下
japize 无法控制您使用的文件名，但强烈建议您
使用具有正确扩展名的文件名（“.japi.gz”，除非“解压缩”选项是
指定的）。 如果您使用任何其他扩展，japicompat 和其他工具可能
无法识别格式。

蜜蜂 | 明确地 | 按名字 | 包 | 类
这个选项有双重作用：它表示 japize 选项之间的边界
(unzip, as) 和其他参数（文件和包），但也告诉 japize 如何
处理含糊不清的指定参数。 见“+|- "下面的详细信息
每个选项的行为。 如果您不确定要指定哪个，“apis”是一个安全的
选择。

蜜蜂
abc 既作为包又作为类进行尝试。 这将永远做你想做的
（这就是 apis 被描述为安全默认值的原因）但可能会以牺牲
做额外的不必要的处理试图找到错误的东西。

明确地
abc 形式的 pkgpaths 是非法的 - 您必须使用显式形式。

按名字
如果 "c" 以小写字母开头，则 abc 将作为包处理，或者作为
class 如果它以大写字母开头。 这通常会做你想做但失败的事情
诸如 org.omg.CORBA 之类的东西。

包
abc 将作为一个包进行处理。 如果需要处理一个类，它必须
明确规定。

类
abc 将作为一个类进行处理。 如果需要处理一个包裹，它必须
明确规定。

|
"apis" 之后不以 "+" 或 "-" 开头的任何参数都被视为
zip 文件或目录。 这些应该完全按照您将它们放入的方式指定
您的 CLASSPATH（用空格而不是冒号分隔的除外）。 任何是
文件将被假定为 zip（或 jar）文件，因此您不能指定 .class 文件
直接 - 如果您需要这样做，您应该指定包含它的文件夹和
然后命名要处理的类。

+|-
要指定包含哪些类，请使用 +pkgpath 添加要扫描的 pkgpath
和 -pkgpath 排除这些的子 pkgpaths。 您必须至少指定一个
+pkgpath 选项指定要包含哪个 pkgpath，否则 Japize 会很高兴
扫描所有 zipfiles 和目录，但不实际处理任何
类。 因为那将是无用的事情，所以 japize 反而给出了一个错误。

“pkgpath”指的是一个包（其中包括，隐含地，所有子
它的包）或单个类。 一个包的 pkgpath 看起来像
“com.foo.pkg.sub”和一个类的 pkgpath 看起来像“com.foo.pkg,Cls”。 这
逗号的存在和位置明确表示路径的类型
意。

但是，在大多数情况下，必须在名称中使用逗号是很痛苦的
而是熟悉点，并完全正确地放置逗号。 为了这
原因，japize 接受只包含点的 pkgpaths，并让您告诉它要做什么
组成这些名字。 “abc”作为 pkgpath 的解释取决于
您明确地、按名称、包或类指定了 api。

例

Sun 的 JDK 1.1 包括 java.awt.peer 和 java.text.resources 中的类
公共 API 的一部分，即使它们是公共类； 然而，每个其他班级
java.* 包层次结构是公共 API 的一部分。 构造有用的语法
因此 jdk11.japi.gz 将是：

$ japize as jdk11 api classes.zip +java -java.awt.peer -java.text.resources

请注意，由于这里的所有 pkg​​path 参数都是包，因此您可以节省少量
通过这样做来处理：

$ japiize as jdk11 packages classes.zip +java -java.awt.peer -java.text.resources

甚至这个：

$ japize as jdk11 明确classes.zip +java, -java.awt.peer, -java.text.resources,

使用 onworks.net 服务在线使用 japize