直接エレメント・コンストラクター

直接エレメント・コンストラクターは、XML に類似した表記を使用してエレメント・ノードを作成します。 構成されるノードは、単純なエレメントであるか、属性、テキスト内容、およびネストされたエレメントを含む複合エレメントである可能性があります。

直接エレメント・コンストラクターにより、結果として独自ノード ID を持つ新しいエレメント・ノードが作成されます。 新規エレメント・ノードのすべての属性ノードおよび子孫のノードもまた、それぞれ独自の ID を持つ新規ノードです。

構文

構文図を読む
                    .------------------------------------------------------.   
                    V                                                      |   
>>-<--element-name----+--------------------------------------------------+-+-->
                      +-attribute-name--=--+-'-+--attribute-value--+-'-+-+     
                      |                    '-"-'                   '-"-' |     
                      '-namespace-declaration-attribute------------------'     

>--+-/>----------------------------------------------+---------><
   |    .---------------------.                      |   
   |    V                     |                      |   
   '->----+-----------------+-+--</--element-name-->-'   
          '-element-content-'                            

namespace-declaration-attribute

|--+-xmlns:prefix-to-bind-+--=--URI-literal---------------------|
   '-xmlns----------------'                   

element-name
構成するエレメントの名前を表す XML 修飾名 (QName)。 終了タグの element-name に使用される名前は、対応する開始タグで使用される名前と完全に一致する必要があります (接頭部も一致していなければならず、接頭部がない場合はそれも一致していなければなりません)。 element-name に名前空間接頭部が含まれている場合、静的に既知の名前空間を使用することで、その接頭部は名前空間 URI に解決されます。 element-name に名前空間接頭部がない場合、その名前はデフォルト・エレメント名前空間で暗黙的に修飾されます。 element-name の評価の結果として拡張された QName は、構成されるエレメント・ノードの名前になります。
attribute-name
構成する属性の名前を示す QName。 attribute-name に名前空間接頭部が含まれている場合、静的に既知の名前空間を使用することで、その接頭部は名前空間 URI に解決されます。 attribute-name に名前空間接頭部がない場合、その属性は名前空間に属しません。 attribute-name の評価の結果として拡張された QName は、構成された属性ノードの名前になります。 各属性の拡張された QName は固有である必要があります。 そうでない場合、式の結果がエラーになります。

直接エレメント・コンストラクターの各属性は、独自のノード ID を持つ新しい 1 つの属性ノードを作成します。 新規属性ノードの親は、構成されたエレメント・ノードです。 新規属性ノードは、xs:untypedAtomic のタイプ・アノテーションを持ちます。

attribute-value
属性の値を指定する文字ストリング。 エレメント・コンストラクターの処理時に評価され、値に置き換わる、括弧で囲まれた式 (中括弧で囲んだ式) を属性値の中に含めることができます。 また、事前定義されたエンティティー参照や文字参照も有効で、それらが表す文字に置き換えられます。 以下の表は、attribute-value で有効な特殊文字のリストです。 これらの文字は二重文字またはエンティティー参照によって表される必要があります。
表 1. 属性値の中の特殊文字の表記
文字 属性値の中で必要な表記
{ 2 個の左中括弧 ({{)
} 2 個の右中括弧 (}})
< &lt;
& &amp;
" &quot; または 2 つの二重引用符 ("") (属性値の区切り文字が二重引用符である場合)
' &apos; または 2 つの単一引用符 ('') (属性値の区切り文字が単一引用符である場合)
xmlns
名前空間宣言属性を開始する単語。 QName で接頭部として指定される場合の xmlns は、URI-literal で指定される URI に prefix-to-bind の値がバインドされることを示します。 この名前空間のバインディングは、コンストラクター式、および式の中でネストされているすべての式に関する静的に既知の名前空間に追加されます (ただし、ネストされた名前空間宣言の属性によってバインディングがオーバーライドされる場合を除く)。 例えば、名前空間宣言属性 xmlns:metric = "http://example.org/metric/units" は、接頭部 metric を名前空間 http://example.org/metric/units にバインドします。

接頭部なしの完全 QName として指定される場合、xmlns は、デフォルト・エレメント名前空間が URI-literal の値に設定されることを示します。 このデフォルト・エレメント名前空間は、このコンストラクター式、およびコンストラクター式の中でネストされているすべての式に関して有効です (ただし、ネストされた名前空間宣言の属性によって宣言がオーバーライドされる場合を除く)。 例えば、名前空間宣言属性 xmlns = "http://example.org/animals" は、デフォルト・エレメント名前空間を http://example.org/animals に設定します。

prefix-to-bind
URI-literal で指定されている URI にバインドされる接頭部。 prefix-to-bind の値を xml や xmlns にすることはできません。 このいずれかの値を指定すると、結果としてエラーになります。
URI-literal
URI を表すストリング・リテラル (単一引用符または二重引用符で囲まれたゼロ個以上の文字からなるシーケンス)。 ストリング・リテラルの値は有効な URI である必要があります。 デフォルト・エレメント名前空間を設定するために名前空間宣言の属性が使われる場合にのみ、URI-literal の値をゼロ長ストリングにすることができます。 それ以外の場合、URI-literal にゼロ長ストリングを指定すると、結果としてエラーになります。
element-content
直接エレメント・コンストラクターのコンテンツ。 コンテンツは、コンストラクターの開始タグと終了タグの間にあるすべてのもので構成されます。 エレメント・コンストラクターでの境界空白の処理方法は、プロローグの境界スペース宣言によって制御されます。 結果として、複数のコンテンツ・エンティティーを連結したコンテンツ・シーケンスになります。 (括弧で囲まれた式の結果としてできるテキストを含む) 結果内の隣接するすべてのテキスト文字は、1 つのテキスト・ノードにマージされます。 結果としてできる属性ノードは、結果のコンテンツ・シーケンスの中で他のどのコンテンツよりも前に来る必要があります。
以下に示す任意のコンテンツで element-content を構成することができます。
テキスト文字
テキスト文字はテキスト・ノードを作成します。 隣接する複数のテキスト・ノードは、1 つのテキスト・ノードにマージされます。 文字シーケンス内の行の末尾は、XML 1.0 で指定されている行末処理規則に従って正規化されます。 以下の表は、element-content で有効な特殊文字のリストです。 これらの文字は二重文字またはエンティティー参照によって表される必要があります。
表 2. エレメント・コンテンツ内の特殊文字の表記
文字 エレメント・コンテンツで必要な表記
{ 2 個の左中括弧 ({{)
} 2 個の右中括弧 (}})
< &lt;
& &amp;
ネストされた直接コンストラクター
直接エレメント・コンストラクターの中に、任意の直接コンストラクターをネストすることができます。
CDataSections
CDataSections は <![CDATA[contents]]> という構文を使って指定されます (contents は一連の複数の文字)。 contents に指定される文字 (< や & などの特殊文字を含む) は、区切り文字としてではなく、リテラル文字として扱われます。 ]]> というシーケンスは CDataSection を終了するため、contents 内ではこれを使用できません。
文字参照および定義済みのエンティティー参照
処理中に、定義済みのエンティティー参照および文字参照は、参照されるストリングに展開されます。
括弧で囲まれた式
括弧で囲まれた式とは、中括弧で囲まれた XQuery 式のことです。 例えば、{5 + 7} は括弧で囲まれた式です。 括弧で囲まれた式の値として、複数のノードおよびアトミック値からなるシーケンスが可能です。 括弧で囲まれた式を直接エレメント・コンストラクターのコンテンツ内で使用することで、構成されるノードのコンテンツと属性を計算できます。 括弧で囲まれた式から戻されるノードごとに、そのノードおよびすべての子孫からなる新規コピーが作成され、元のタイプ・アノテーションがそれらに保持されます。 element-content から戻されるすべての属性ノードは、結果としてできるコンテンツ・シーケンスの最初の位置に来る必要があります。 これらの属性ノードは、構成されるエレメントの属性になります。 element-content から戻されるエレメント、コンテンツ、または処理命令のノードは、新しく構成されるノードの子になります。 element-content から戻されるアトミック値は、ストリングに変換されてテキスト・ノードに保管されます。 このノードは、構成されるノードの子になります。 隣接する複数のテキスト・ノードは、1 つのテキスト・ノードにマージされます。
重要: XMLQUERY、XMLEXISTS および XMLTABLE では単一引用符を使って XQuery 式を囲むので、直接エレメント・コンストラクター内の単一引用符 (') は 2 つの単一引用符 ('') に置き換える必要があります。

例

  • 以下の直接エレメント・コンストラクターは、ブック・エレメントを作成します。 ブック・エレメントには、属性ノード、複数のネストされたエレメント・ノード、および複数のテキスト・ノードを含む複合コンテンツが入ります。
    <book isbn="isbn-0060229357">
        <title>Harold and the Purple Crayon</title>
        <author>
            <first>Crockett</first>
            <last>Johnson</last>
        </author>
    </book>
  • 以下の例は、エレメント・コンテンツが直接エレメント・コンストラクターでどのように処理されるかを示しています。
    • 以下の式は、1 つの子 (値「1」を含むテキスト・ノード) を持つエレメント・ノードを構成します。
      <a>{1}</a>
    • 以下の式は、1 つの子 (値「1 2 3」を含むテキスト・ノード) を持つエレメント・ノードを構成します。
      <a>{1, 2, 3}</a>
    • 以下の式は、1 つの子 (値「123」を含むテキスト・ノード) を持つエレメント・ノードを構成します。
      <c>{1}{2}{3}</c>
    • 以下の式は、1 つの子 (値「1 2 3」を含むテキスト・ノード) を持つエレメント・ノードを構成します。
      <b>{1, "2", "3"}</b>
    • 以下の式は、1 つの子 (値「I saw 8 cats」を含むテキスト・ノード) を持つエレメント・ノードを構成します。
      <fact>I saw {5 + 3} cats.</fact>