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

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

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

用法

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

• 包

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

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

    @javax.xml.bind.annotation.XmlSchema (
      namespace = "https://www.example.com/MYPO1"
    )
    
    <!-- XML Schema fragment -->
    <schema
      xmlns=...
      xmlns:po=....
      targetNamespace="https://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="https://www.example.com/myPO1"),

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

示例 3：自定义 elementFormDefault

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

从以下版本开始：

JAXB2.0

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

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。