javax.xml.bind.annotation
注釈型 XmlSchema

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

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

使用法

XmlSchema 注釈は、次のプログラム要素で使用できます。

• package

これは、パッケージレベルの注釈であり、JSR 175、3 節の「Annotations」に含まれる推奨事項と制限に従います。そのため、これの使用には次の制約と推奨事項が適用されます。

• JSR 175、3 節の「Annotations」で記述されているとおり、パッケージ宣言は 1 つだけです。
• 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	location この名前空間 (namespace() によって指定される) に含まれるスキーマがすでに外部で使用可能であり、この場所で使用できることを示します。
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 Schema フラグメントに含まれません。

デフォルト:

javax.xml.bind.annotation.XmlNsForm.UNSET

attributeFormDefault

public abstract XmlNsForm attributeFormDefault

属性の名前空間修飾です。デフォルトでは、attributesFormDefault は XML Schema フラグメントに含まれません。

デフォルト:

javax.xml.bind.annotation.XmlNsForm.UNSET

location

public abstract String location

この名前空間 (namespace() によって指定される) に含まれるスキーマがすでに外部で使用可能であり、この場所で使用できることを示します。

これは、コンポーネントをスキーマ内に生成するのとは対照的に、ただ単に指し示されたスキーマを参照するように JAXB スキーマジェネレータに指示します。このスキーマは、スキーマジェネレータによってそのほかに生成されるもの (同じ要素名、同じ型名など) に対応するものとします。

この機能は、Java クラスセットが、外部で定義されたスキーマに対応するように手書きで作成された既存のスキーマから最初に生成されるときに使用するためのものであり、生成されたスキーマは手動で変更されます。

値には、絶対 URI (http://example.org/some.xsd など) を指定できます。また、空の文字列を指定することもでき、その場合はスキーマが外部で使用可能であるが、場所は指定されていない (したがって生成されたスキーマの場所を決めるのは読み取り側の責任となる) ことを示します。最後に、このプロパティーのデフォルト値 "##generate" は、スキーマジェネレータがこの名前空間用のコンポーネントを生成しようとしていることを示します (JAXB 2.0 以降)。

複数のパッケージの複数の XmlSchema 注釈が同じ namespace() の管理を許可されています。このような場合は、そのすべてに同じ location() 値を指定する必要があります。

実装者への注意

より正確には、値は "" または "##generate" にするか、<scheme>: で始まる xs:anyURI の有効な字句表現にする必要があります。

スキーマジェネレータは、対応する <xs:import namespace="..." schemaLocation="..."/> (空の文字列を指定した場合は schemaLocation 属性なし) を生成することになっています。ただし、スキーマジェネレータは、ユーザーがコマンド行インタフェースを介してリソースのローカルコピーを指定できるようにする場合など、schemaLocation 属性に別の値を使用すること (そのような属性を生成しないことを含む) が許可されています。

導入されたバージョン:

JAXB2.1

デフォルト:

"##generate"