XmlSchema (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：必需 | 可选

详细信息：元素

javax.xml.bind.annotation
注释类型 XmlSchema

@Retention(value=RUNTIME) @Target(value=PACKAGE) public @interface XmlSchema

将包名称映射到 XML 名称空间。

用法

XmlSchema 注释可以与以下程序元素一起使用：

这是一个包级别注释，它遵循 JSR 175 的第 III 节“注释”中的建议和限制。因此用法受到以下约束和建议的限制：

正如 JSR 175 的第 III 节“注释”中所指出的那样，只能有一个包声明。
JSR 175 建议对包级别注释使用 package-info.java。遵循此建议的 JAXB 提供者将允许在 package-info.java 中定义包级别注释。

示例 1：自定义包将要映射到的 XML 名称空间名。

    @javax.xml.bind.annotation.XmlSchema (
      namespace = "http://www.example.com/MYPO1"
    )
    
    <!-- XML Schema fragment -->
    <schema
      xmlns=...
      xmlns:po=....
      targetNamespace="http://www.example.com/MYPO1"
    >
    <!-- prefixes generated by default are implementation
            depedenent -->

示例 2：自定义名称空间前缀、名称空间 URI 映射

    // Package level annotation
    @javax.xml.bind.annotation.XmlSchema (
      xmlns = { 
        @javax.xml.bind.annotation.XmlNs(prefix = "po", 
                   namespaceURI="http://www.example.com/myPO1"),

        @javax.xml.bind.annotation.XmlNs(prefix="xs",
                   namespaceURI="http://www.w3.org/2001/XMLSchema")
      )
    )
 
    <!-- XML Schema fragment -->
    <schema
        xmlns:xs="http://www.w3.org/2001/XMLSchema"
        xmlns:po="http://www.example.com/PO1"
        targetNamespace="http://www.example.com/PO1">

示例 3：自定义 elementFormDefault

    @javax.xml.bind.annotation.XmlSchema (
      elementFormDefault=XmlNsForm.UNQUALIFIED
      ...
    )
 
    <!-- XML Schema fragment -->
    <schema
        xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:po="http://www.example.com/PO1"
        elementFormDefault="unqualified">

从以下版本开始：: JAXB2.0

可选元素摘要

XmlNsForm attributeFormDefault
          属性的名称空间限制。

XmlNsForm elementFormDefault
          元素的名称空间限制。

String namespace
          XML 名称空间名。

XmlNs[] xmlns
          自定义名称空间 URI 和前缀的关联性。

可选元素摘要
`XmlNsForm`	`attributeFormDefault` 属性的名称空间限制。
`XmlNsForm`	`elementFormDefault` 元素的名称空间限制。
`String`	`namespace` XML 名称空间名。
`XmlNs[]`	`xmlns` 自定义名称空间 URI 和前缀的关联性。

xmlns

public abstract XmlNs[] xmlns

自定义名称空间 URI 和前缀的关联性。默认情况下，XML 名称空间的名称空间前缀是由 JAXB 提供者以与实现相关的方式生成的。

默认值：: {}

namespace

public abstract String namespace

XML 名称空间名。

默认值：: ""

elementFormDefault

public abstract XmlNsForm elementFormDefault

元素的名称空间限制。默认情况下，元素默认属性不在 XML 模式片段中。

默认值：: javax.xml.bind.annotation.XmlNsForm.UNSET

attributeFormDefault

public abstract XmlNsForm attributeFormDefault

属性的名称空间限制。默认情况下，attributesFormDefault 不在 XML 模式片段中。

默认值：: javax.xml.bind.annotation.XmlNsForm.UNSET

概述