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 和前綴的關聯性。

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