パッケージ名を XML 名前空間にマップします。

使用方法

XmlSchema アノテーションは、次のプログラム要素で使用できます。

• パッケージ

これはパッケージレベルのアノテーションであり、JSR175 のセクション III「アノテーション」に含まれている推奨事項と制限に従います。使用箇所には次の制約と推奨事項があります。

• JSR 175、セクション III、「アノテーション」に記載されているように、パッケージ宣言は 1 つしか存在できません。
• JSR 175 は、パッケージレベルのアノテーションに package-info.java を推奨しています。この推奨事項に従う Jakarta XML Binding Providers では、パッケージレベルのアノテーションを package-info.java で定義できます。

例 1: パッケージがマップされる XML 名前空間の名前をカスタマイズします。

    @jakarta.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
    @jakarta.xml.bind.annotation.XmlSchema (
      xmlns = {
        @jakarta.xml.bind.annotation.XmlNs(prefix = "po",
                   namespaceURI="http://www.example.com/myPO1"),

        @jakarta.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 をカスタマイズする

    @jakarta.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">