Co elementFormDefault robi w XSD?

Rozważmy następujący ComplexType AuthorType używany przez author element

<xsd:complexType name="AuthorType">
  <!-- compositor goes here -->
  <xsd:sequence>
     <xsd:element name="name" type="xsd:string"/>
     <xsd:element name="phone" type="tns:Phone"/>
  </xsd:sequence>
  <xsd:attribute name="id" type="tns:AuthorId"/>
</xsd:complexType>
<xsd:element name="author" type="tns:AuthorType"/>

If elementFormDefault="unqualified"

Następnie następująca instancja XML jest poprawna

<x:author xmlns:x="http://example.org/publishing">
   <name>Aaron Skonnard</name>
   <phone>(801)390-4552</phone>
</x:author>

Atrybut nazwy autorów jest dozwolony bez podawania przestrzeni nazw (bez zastrzeżeń). Wszystkie elementy, które są częścią <xsd:complexType> są uważane za lokalne dla complexType.

If elementFormDefault="qualified"

Wtedy instancja powinna mieć kwalifikowane lokalne elementy

<x:author xmlns:x="http://example.org/publishing">
   <x:name>Aaron Skonnard</name>
   <x:phone>(801)390-4552</phone>
</x:author>

Proszę zapoznać się z ten link po więcej szczegółów

_{Nowa, szczegółowa odpowiedź i Wyjaśnienie starego, często zadawanego pytania...}

Krótka odpowiedź: jeśli nie dodasz elementFormDefault="qualified" do xsd:schema, wtedy domyślna wartość unqualified oznacza, że lokalnie zadeklarowane elementy są w BEZ przestrzeni nazw .

Jest wiele zamieszania odnośnie tego, co robi elementFormDefault, ale można to szybko wyjaśnić krótkim przykładem...

Usprawniona wersja twojego XSD:

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:target="http://www.levijackson.net/web340/ns"
        targetNamespace="http://www.levijackson.net/web340/ns">
  <element name="assignments">
    <complexType>
      <sequence>
        <element name="assignment" type="target:assignmentInfo" 
                 minOccurs="1" maxOccurs="unbounded"/>
      </sequence>
    </complexType>
  </element>
  <complexType name="assignmentInfo">
    <sequence>
      <element name="name" type="string"/>
    </sequence>
    <attribute name="id" type="string" use="required"/>
  </complexType>
</schema>

Klucz punkty:

• element assignment jest lokalnie zdefiniowany.
• Elementy lokalnie zdefiniowane w XSD domyślnie nie mają przestrzeni nazw.
  • jest tak dlatego, że domyślną wartością dla elementFormDefault jest unqualified.
  • to prawdopodobnie błąd projektowy twórców XSD.
  • standardową praktyką jest zawsze używać elementFormDefault="qualified" tak, że assignment znajduje się w docelowej przestrzeni nazw, tak jak spodziewaj się.

Pozornie poprawny XML

Ten XML wygląda na to, że powinno być poprawne zgodnie z powyższym XSD:

<assignments xmlns="http://www.levijackson.net/web340/ns"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://www.levijackson.net/web340/ns try.xsd">
  <assignment id="a1">
    <name>John</name>
  </assignment>
</assignments>

Notice:

• domyślna przestrzeń nazw na assignments umieszcza assignments i wszystkie jej potomkinie w domyślnej przestrzeni nazw (http://www.levijackson.net/web340/ns).

Perplexing Validation Error

Pomimo poprawnego wyglądu, powyższy XML daje następujący mylący błąd walidacji:

[błąd] spróbuj.xml: 4: 23: CVC-complex-type.2.4.Odp: Nieprawidłowa treść była znalezione zaczynające się od elementu / align = "left" / Jednym z "{assignment} " jest oczekiwane.

Uwagi:

• nie byłbyś pierwszym programistą, który przeklinał tę diagnostykę, która wydaje się mówić, że treść jest nieprawidłowa, ponieważ oczekiwała, że znajdzie element assignment, ale faktycznie znalazła element assignment. (WTF )
• Co to tak naprawdę znaczy: { i } wokół assignment oznacza, że Walidacja oczekiwała assignment in no namespace proszę. Niestety, kiedy mówi, że znalazł element assignment, nie wspomina, że znalazł go w domyślnej przestrzeni nazw, która różni się od żadnej przestrzeni nazw.

Rozwiązanie

• zdecydowana większość czasu: dodaj {[2] } do xsd:schema elementu XSD. Oznacza to, że poprawny XML musi umieszczać elementy w docelowej przestrzeni nazw, gdy lokalnie jest zadeklarowany w XSD; w przeciwnym razie poprawny XML musi umieszczać elementy lokalnie zadeklarowane w żadnej przestrzeni nazw.
• mała mniejszość czas: Zmień XML, aby był zgodny z XSD wymaganie, aby {[6] } nie było w żadnej przestrzeni nazw. Można to osiągnąć, na przykład poprzez dodanie xmlns="" do elementu assignment.

Należy pamiętać, że elementFormDefault ma zastosowanie do lokalnie zdefiniowanych elementów, typowo nazwanych wewnątrz bloku complexType, w przeciwieństwie do elementów globalnych zdefiniowanych na najwyższym poziomie schematu. Za pomocą elementFormDefault = "qualified" możesz zwracać się do lokalnych elementów schematu z poziomu dokumentu xml, używając docelowej przestrzeni nazw schematu jako domyślnej przestrzeni nazw dokumentu.

W praktyce, użyj elementFormDefault="qualified", aby móc zadeklarować elementy w zagnieżdżonych blokach, w przeciwnym razie będziesz musiał zadeklarować wszystkie elementy na najwyższym poziomie i odwoływać się do nich w schemacie w zagnieżdżonych elementach za pomocą atrybutu ref, co skutkuje znacznie mniej zwartym schematem.

Ten bit w XML Schema Primer mówi o tym: http://www.w3.org/TR/xmlschema-0/#NS

ElementFormDefault="qualified" jest używany do kontrolowania użycia przestrzeni nazw w dokumentach instancji XML (.plik xml), a nie przestrzenie nazw w samym dokumencie schematu (.plik xsd).

Poprzez podanie elementFormDefault= "qualified" wymuszamy deklarację przestrzeni nazw, która ma być używana w dokumentach potwierdzonych tym schematem.

Powszechną praktyką jest określanie tej wartości, aby zadeklarować, że elementy powinny być kwalifikowane, a nie niekwalifikowane. Jednakże, ponieważ attributeFormDefault = "unqualified"jest wartością domyślną, nie musi być określona w dokumencie schematu, jeśli nie chce się kwalifikować przestrzeni nazw.

Zauważyłem, że XMLSpy (przynajmniej w wersji 2011)wymaga zdefiniowanej przestrzeni targetNameSpace, jeśli używany jest elementFormDefault= "qualified". Inaczej się nie potwierdzi. A także nie będzie generować xmlów z prefiksami przestrzeni nazw