JAXB 应用程序的 schemagen 命令

使用模式生成器工具 schemagen 来生成使用 Java™ XML 绑定体系结构 (JAXB) 的 XML 模式。

使用 JAXB API 和工具在 XML 模式和 Java 类之间建立映射。XML 模式描述 XML 文档中的数据元素和关系。在数据映射或绑定存在后,可以在 XML 文档和 Java 对象之间进行转换。现在不必理解数据结构即可访问 XML 文档中存储的数据。

可以使用 schemagen 模式生成器工具从 Java 类生成模式文件以创建 XML 模式。在 XML 模式与 Java 类之间存在映射后,通过使用 JAXB 绑定运行时 API,可以在 XML 实例文档与 Java 对象之间进行转换。生成的 Java 类包含 JAXB 运行时解析 XML 以进行编组和取消编组所需的所有必需信息。可以在“针对 XML Web Service 的 Java API”(JAX-WS) 应用程序或非 JAX-WS Java 应用程序中使用 JAXB 类来处理 XML 数据。

支持的配置 支持的配置: z/OS® 平台不支持 wsimportwsgenschemagenxjc 命令行工具。随在 z/OS 平台上运行的 WebSphere® Application Server 一起提供的组装工具提供了此功能。请针对 JAX-WS 应用程序查看这些命令行工具,以更多地了解这些工具。sptcfg
最佳实践 最佳实践: WebSphere Application Server 提供 Java API for XML-Based Web Services (JAX-WS) 和 Java XML 绑定体系结构 (JAXB) 工具。wsimportwsgenschemagenxjc 命令行工具位于 WebSphere Application Server(传统)app_server_root\bin\ 目录中。xjcschemagen 命令位于 Liberty 概要文件中的 app_server_root\jaxb\bin\ 目录中。在某些情况下,由 WebSphere Application Server 提供的工具以及 JDK 两者所生成的工件支持相同级别的规范。总之,JDK 工具生成的工件可在其他顺应的运行时环境之间移植。然则,最好是使用本产品附带提供的工具来在 WebSphere Application Server 环境内实现无缝集成并利用可能仅在 WebSphere Application Server 中受支持的功能部件。要利用 JAX-WS 和 JAXB V2.2 工具,请使用应用程序服务器附带提供的工具,这些工具位于 app_server_root\bin\ 目录。bprac
避免故障 避免故障: 运行 schemagen 工具以处理 JavaBeans 时,模式生成器将不会自动处理现有 package-info.class 文件中的 @XmlSchema 注释来派生 targetNamespace。为确保 schemagen 工具正确地处理名称空间值,请使用以下其中一种方法:
  • schemagen 调用中显式指定 package-info.java 源文件;例如:
    schemagen sample.Address sample\package-info.java
  • Use the @XmlType annotation namespace attribute within your JavaBeans to specify a namespace; for example:
    @XmlType(namespace="http://myNameSpace")
    public class Address {...}
gotcha

除了从命令行使用 schemagen 工具外,还可以从 Ant 构建环境中调用此 JAXB 工具。从 Ant 构建环境中使用 com.sun.tools.jxc.SchemaGenTask Ant 任务来调用 schemagen 模式生成器工具。为了正常运行,此 Ant 任务需要您使用 ws_ant 脚本来调用 Ant。

语法

命令行语法为:

[Windows]
app_server_root\bin\schemagen.bat [options] <java_files>
[AIX][HP-UX][Linux][Solaris]
app_server_root/bin/schemagen.sh [options] <java_files>
[IBM i]
app_server_root/bin/schemagen [options] <java_files>

参数

对于 schemagen 命令,以下参数是可选参数:

-classpath <path>
指定 Java 源文件或类文件的位置。
-cp <path>
指定 Java 源文件或类文件的位置。
-d <path>
指定用于放置处理器和所生成 Java 类文件的位置。
-episode<file_name>
指定此选项以生成 Episode 文件,用于单独的编译。
-encoding <encoding>
指定此选项以在调用 -apt 或 -javac 工具时使用编码。 此属性适用于 JAXB 2.2 及更高版本。
-help
显示帮助菜单。
-version
打印版本信息。如果指定此选项,那么只输出版本信息,而不执行典型的命令处理。

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_schemagen
文件名:rwbs_schemagen.html