expanded-QName (XQuery)

Nell'esempio seguente viene illustrata la procedura per modificare il valore di un nodo elemento di tipo QName. L'esempio esegue le operazioni seguenti:

• Crea un insieme di schemi XML che definisce un elemento di tipo QName.

• Crea una tabella con una colonna di tipo xml utilizzando l'insieme di schemi XML.

• Salva un'istanza XML nella tabella.

• Utilizza il metodo modify() del tipo di dati xml per modificare il valore dell'elemento di tipo QName nell'istanza. Per generare il nuovo valore del tipo QName viene utilizzata la funzione expanded-QName().

-- If XML schema collection (if exists)
-- drop xml schema collection SC
-- go
-- Create XML schema collection
CREATE XML SCHEMA COLLECTION SC AS N'
<schema xmlns="http://www.w3.org/2001/XMLSchema"
    xmlns:xs="http://www.w3.org/2001/XMLSchema" 
    targetNamespace="QNameXSD" 
      xmlns:xqo="QNameXSD" elementFormDefault="qualified">
      <element name="Root" type="xqo:rootType" />
      <complexType name="rootType">
            <sequence minOccurs="1" maxOccurs="1">
                        <element name="ElemQN" type="xs:QName" />
            </sequence>
      </complexType>
</schema>'
go
-- Create table.
CREATE TABLE T( XmlCol xml(SC) )
-- Insert sample XML instnace
INSERT INTO T VALUES ('
<Root xmlns="QNameXSD" xmlns:ns="http://myURI">
      <ElemQN>ns:someName</ElemQN>
</Root>')
go
-- Verify the insertion
SELECT * from T
go
-- Result
<Root xmlns="QNameXSD" xmlns:ns="http://myURI">
  <ElemQN>ns:someName</ElemQN>
</Root> 

Nella query seguente il valore dell'elemento <ElemQN> viene sostituito utilizzando il metodo modify() del tipo di dati xml e l'istruzione XML DML "replace value", come illustrato di seguito.

-- the value.
UPDATE T 
SET XmlCol.modify('
  declare default element namespace "QNameXSD"; 
  replace value of /Root[1]/ElemQN 
  with expanded-QName("http://myURI", "myLocalName") ')
go
-- Verify the result
SELECT * from T
go

Di seguito è riportato il risultato. Si noti che l'elemento <ElemQN> di tipo QName ha ora un nuovo valore:

<Root xmlns="QNameXSD" xmlns:ns="urn">
  <ElemQN xmlns:p1="http://myURI">p1:myLocalName</ElemQN>
</Root>

Le istruzioni seguenti rimuovono gli oggetti utilizzati nell'esempio.

-- Cleanup
DROP TABLE T
go
drop xml schema collection SC
go

Non è possibile utilizzare la funzione expanded-QName() nella costruzione di strutture XML. Questa condizione è illustrata nell'esempio seguente. Per ovviare a questa limitazione, nell'esempio viene inserito per prima cosa un nodo, che verrà poi modificato.

-- if exists drop the table T
--drop table T
-- go
-- Create XML schema collection
-- DROP XML SCHEMA COLLECTION SC
-- go
CREATE XML SCHEMA COLLECTION SC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema">
      <element name="root" type="QName" nillable="true"/>
</schema>'
go
 -- Create table T with a typed xml column (using the XML schema collection)
CREATE TABLE T (xmlCol XML(SC))
go
-- Insert an XML instance.
insert into T values ('<root xmlns:a="http://someURI">a:b</root>')
 go
-- Verify
SELECT * 
FROM T

L'istruzione seguente tenta di aggiungere un nuovo elemento <root>, ma ha esito negativo perché la funzione expanded-QName() non è supportata nella costruzione di strutture XML.

update T SET xmlCol.modify('
insert <root>{expanded-QName("http://ns","someLocalName")}</root> as last into / ')
go

Una soluzione consiste nell'inserire un'istanza con un valore per l'elemento <root> e quindi modificarla. In questo esempio quando viene inserito l'elemento <root> viene utilizzato un valore iniziale Null. L'insieme di schemi XML in questo esempio consente un valore Null per l'elemento <root>.

update T SET xmlCol.modify('
insert <root xsi:nil="true"/> as last into / ')
go
-- now replace the nil value with another QName.
update T SET xmlCol.modify('
replace value of /root[last()] with expanded-QName("http://ns","someLocalName") ')
go
 -- verify 
SELECT * FROM T
go
-- result
<root>b</root>

<root xmlns:a="http://someURI">a:b</root>

<root xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p1="http://ns">p1:someLocalName</root>

È possibile confrontare il valore dell'elemento QName, come illustrato nella query seguente. La query restituisce solo l'elemento <root> i cui valori corrispondono al valore di tipo QName restituito dalla funzione expanded-QName().

SELECT xmlCol.query('
    for $i in /root
    return
       if ($i eq expanded-QName("http://ns","someLocalName") ) then
          $i
       else
          ()')
FROM T

Esiste un'unica limitazione: la funzione expanded-QName() accetta la sequenza vuota come secondo argomento e quando il secondo argomento è errato restituisce un valore vuoto invece di generare un errore di run-time.