I namespace in XML 1.1 (seconda edizione)

1.1 Appunto sulla notazione e l'uso

Dove ENFATIZZATE, le parole chiave [n.d.t. e loro coniugazioni in italiano] DEVE (MUST), NON DEVE (MUST NOT), È RICHIESTO (REQUIRED), DOVREBBE (SHOULD), NON DOVREBBE (SHOULD NOT), PUÒ (MAY) in questo documento sono da considerarsi usate come descritto in [Parole chiave].

Si noti che molti dei simboli non terminali coinvolti nella produzione di questa specifica non sono definiti qui bensí nella specifica dell'XML [XML]. Quando i simboli non terminali definiti qui hanno nomi uguali ai simboli definiti nella specifica dell'XML, le regole di produzione presenti qui in tutti i casi correlano un sottoinsieme di stringhe che vengono correlate dalle corrispondenti regole la.

Nelle regole di produzione in questo documento, NSC [n.d.t. dall'inglese Namespace Contraints] è un "vincolo al namespace ", una delle regole che i documenti conformi a questa specifica DEVONO seguire.

2.1 Concetti di base

[Definizione: Un namespace XML è identificato da un riferimento IRI [RFC3987]; nomi di elementi e nomi di attributi possono essere posti in un namespace XML utilizzando il meccanismo descritto in questa specifica. ]

[Definizione: Un nome esteso è una coppia cosistente di un nome di namespace e di un nome locale. ] [Definizione: Per un nome N in un name space identificato da un IRI I, il nome del namespace è I. Per un nome N che non è in un namespace, il nome del namespace non ha valore. ] [Definizione: in entrambi i casi il nome locale è N. ] È questa combinazione di gestione universale dei namespace tramite IRI con i nomi locali del vocabolario che è efficace nell'evitare conflitti di nomi.

I riferimenti IRI possono contenere caratteri non consentiti nei nomi, e sono spesso sconvenientemente lunghi, così i nomi estesi non vengono usati direttamente per denominare elementi e attributi in documenti XML. Vengono invece usati nomi qualificati. [Definizione: Un nome qualificato è un nome soggetto ad interpretazione del namespace. ] Nei documenti che siano conformi a questa specifica, i nomi degli elementi e degli attributi appaiono come nomi qualificati. Sintatticamente, sono o nomi con prefissi o nomi senza prefissi. Una sintassi di dichiarazione basata sugli attributi viene fornita per legare prefissi a nomi di un namespace e per legare un namespace di default applicabile a nomi di elementi senza prefissi; l'ambito di validità di queste dichiarazioni è determinato dagli elementi in cui essi appaiono cosicché trovare combinazioni diverse in diverse parti di un documento. I processori che si conformino a questa specifica DEVONO riconoscere queste dichiarazioni e prefissi e agire sulla base di essi.

2.2 Uso di IRI come nomi di un namespace

2.3 Confronto tra riferimenti IRI

Riferimenti IRI che identificano namespace vengono messi a confronto ogni volta che si cerchi di stabilire se un nome appartenga o no ad un dato namespace o se due nomi appartengano allo stesso namespace. [Definizione: due IRI sono trattati come stringhe e sono identici se e solo se tali stringhe sono identiche, cioè, se sono la stessa sequenza di caratteri. ] Nel confronto si distingue tra maiuscole e minuscole e % non viene considerato un carattere di escape.

Una conseguenza di questo è che riferimenti IRI che non siano identici in questo senso possono risultare in riferimenti alla stessa risorsa. Esempi includono riferimenti IRI che differiscono solo nell'uso di maiuscole e minuscole o per l'uso di % come carattere di escape, o che siano entità esterne che abbiano un diverso URI base (ma si noti che l'uso di IRI relativi per nomi di namespace viene scoraggiato).

Nelle dichiarazioni di un namespace, il riferimento IRI è il valore normalizzato dell'attributo, cosicché sostituzioni di caratteri XML e riferimenti ad entità sono già stati fatti prima di qulasiasi confronto.

Esempi:

I riferimenti IRI sotto riportati sono tutti differenti agli effetti della identificazione dei namespace, visto che differiscono nell'uso delle maiuscole e delle minuscole:

• http://www.example.org/wine

• http://www.Example.org/wine

• http://www.example.org/Wine

Anche i riferimenti IRI sotto riportati sono tutti differenti agli effetti della identificazione dei namespace:

• http://www.example.org/rosé

• http://www.example.org/ros%c3%a9

• http://www.example.org/ros%c3%A9

• http://www.example.org/ros%C3%a9

• http://www.example.org/ros%C3%A9

Come lo sono questi:

• http://www.example.org/~wilbur

• http://www.example.org/%7ewilbur

• http://www.example.org/%7Ewilbur

Se l'entità eacute é definita in modo che sia é, tutti i tag iniziali sotto indicati contengono dichiarazioni di namespace correlanti i prefissi p allo stesso riferimento IRI, http://example.org/rosé.

• <p:foo xmlns:p="http://example.org/rosé">

• <p:foo xmlns:p="http://example.org/ros&#xe9;">

• <p:foo xmlns:p="http://example.org/ros&#xE9;">

• <p:foo xmlns:p="http://example.org/ros&#233;">

• <p:foo xmlns:p="http://example.org/ros&eacute;">

A causa del rischio di confusione tra IRI che sarebbero eqivalenti se dereferenziati, l'uso di caratteri di escape % nei nomi di namespace è fortemente sconsigliato.

6.1 Visibilità del namespace

Il nome esteso corrispondente ad un nome con prefisso di attributo o elemento ha l'IRI, al quale il prefisso è legato in qualità di nome del namespace, e la parte locale in qualità del suo nome locale.

<?xml version="1.1"?>

<html:html xmlns:html='http://www.w3.org/1999/xhtml'>

  <html:head><html:title>Frobnostication</html:title></html:head>
  <html:body><html:p>Moved to 
    <html:a href='http://frob.example.com'>here.</html:a></html:p></html:body>
</html:html>

Come attributi di un singolo elemento possono essere dichiarati molteplici prefissi per namespace, come viene mostrato in questo esempio:

<?xml version="1.1"?>
<!-- sono disponibili per tutto l'elemento entrambi i prefissi di namespace  -->
<bk:book xmlns:bk='urn:loc.gov:books'
         xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <bk:title>Cheaper by the Dozen</bk:title>
    <isbn:number>1568491379</isbn:number>
</bk:book>

Il valore dell'attributo in una dichiarazione di namespace per un prefisso PUÒ essere nullo. Questo ha l'effetto, nell'ambito della dichiarazione, di rimuovere ogni associazione del prefisso con un nome di namespace. Ulteriori dichiarazioni POSSONO dichiarare nuovamente il prefisso:

<?xml version="1.1"?>
<x xmlns:n1="http://www.w3.org">
    <n1:a/>               <!-- legale; il prefisso n1 viene legato a http://www.w3.org -->
    <x xmlns:n1="">
        <n1:a/>           <!-- illegale; il prefisso n1 non viene legato qui -->
	<x xmlns:n1="http://www.w3.org">
            <n1:a/>       <!-- legale; il prefisso n1 viene legato nuovamente -->
        </x>
    </x>
</x>

6.2 Default per i namespace

La visibilità per la dichiarazione di un namespace di default si estende dall'inizio del tag iniziale dove essa appare sino alla fine del corrispodente tag finale, ad esclusione dell'ambito di dichiarazioni di namespace di default più interne. Nel caso di un tag vuoto, l'ambito di visibilità è il tag stesso.

Una dichiarazione di namespace di default si applicata, nel suo ambito, a tutti i nomi di elemento non senza prefisso. Le dichiarazioni del namespace di default non si applicano direttamente ai nomi degli attributi; l'interpretazione degli attributi senza prefisso è determinata dall'elemento in cui figurano.

Se viene dichiarato un namespace di default in un cero ambito di visibilità, il nome esteso corrispondente ad un nome di elemento senza prefisso prende l'IRI del namespace di default come suo nome di namespace. Se non è dichiato un namespace di default in un certo ambito di visibilit`, il namespace non ha valore. Il nome del namespace per un nome di attributo senza prefisso non ha mai alcun valore. In ogni caso, il nome locale è la parte locale (che è naturalmente coincide col nome senza prefisso).

<?xml version="1.1"?>
<!-- Gli elementi sono nello spazio di nomi dell'HTML, in questo caso di default -->
<html xmlns='http://www.w3.org/1999/xhtml'>
  <head><title>Frobnostication</title></head>
  <body><p>Moved to 
    <a href='http://frob.example.com'>here</a>.</p></body>
</html>

<?xml version="1.1"?>
<!-- I tipi di elementi senza prefisso vengono da "books" -->
<book xmlns='urn:loc.gov:books'
      xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <title>Cheaper by the Dozen</title>
    <isbn:number>1568491379</isbn:number>
</book>

Un più esteso esempio dell'ambito di validità dei namespace:

<?xml version="1.1"?>
<!-- Inizialmente, il namespace di default è "books" -->
<book xmlns='urn:loc.gov:books'
      xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <title>Cheaper by the Dozen</title>
    <isbn:number>1568491379</isbn:number>
    <notes>
      <!-- Fa dell'HTML il namespace di default per alcuni commenti -->
      <p xmlns='http://www.w3.org/1999/xhtml'>
          This is a <i>funny</i> book!
      </p>
    </notes>
</book>

Il valore dell'attributo in una dichiarazione di namespace di default PUÒ essere vuota. Questo ha lo stesso effetto, nell'ambito di visibilità della dichiarazione, di quando non ci fosse alcun namespace di default.

<?xml version='1.1'?>
<Beers>
  <!-- Il namespace di default all'interno delle tabelle è quello dell'HTML -->
  <table xmlns='http://www.w3.org/1999/xhtml'>
   <th><td>Name</td><td>Origin</td><td>Description</td></th>
   <tr> 
     <!-- All'interno delle celle non c'è alcun namespace di default -->
     <td><brandName xmlns="">Huntsman</brandName></td>
     <td><origin xmlns="">Bath, UK</origin></td>
     <td>
       <details xmlns=""><class>Bitter</class><hop>Fuggles</hop>
         <pro>Wonderful hop, light alcohol, good summer beer</pro>
         <con>Fragile; excessive variance pub to pub</con>
         </details>
        </td>
      </tr>
    </table>
  </Beers>

6.3 Unicità degli attributi

1. abbiano nomi identici, o

2. abbiano nomi qualificati con la stessa parte locale e con i prefissi che siano legati a nomi di namespace identici.

Questa estrizione è equivalente a richiedere che nessun elemento abbia due attributi con lo stesso nome esteso.

Per esempio, ognuno dei tag dell'elemento bad vuoto non è consentito nel seguente frammento:

<!-- http://www.w3.org è legato ad n1 e n2 -->
<x xmlns:n1="http://www.w3.org" 
   xmlns:n2="http://www.w3.org" >
  <bad a="1"     a="2" />
  <bad n1:a="1"  n2:a="2" />
</x>

Comunque, ognuno dei seguenti è consentito, il secondo perché il namespace di default non si applica ai nomi di attributi:

<!-- http://www.w3.org &egarve; legato ad n1 ed è di default -->
<x xmlns:n1="http://www.w3.org" 
   xmlns="http://www.w3.org" >
  <good a="1"     b="2" />
  <good a="1"     n1:a="2" />
</x>