Fallbacks

(Auszug aus "XML in a Nutshell" von Elliotte Rusty Harold & W. Scott Means)

Dokumente, die Ressourcen auf anderen Sites referenzieren, sind all den üblichen Problemen des Webs unterworfen: Dokumente werden gelöscht, Dokumente werden verschoben, Server stürzen ab, DNS-Einträge werden nicht schnell genug aktualisiert und vieles mehr. Die bisher aufgeführten Beispiele scheitern vollständig, wenn die Ressource am anderen Ende eines href-Attributs nicht gefunden werden kann. XInclude bietet Autoren jedoch ein Mittel, im Fall eines fehlenden Dokuments einen alternativen Inhalt anzugeben. Jedes XInclude-Element kann ein einziges xi:fallback-Kindelement enthalten. Wenn das entfernte Dokument nicht geladen werden kann, ersetzt anstelle des Inhalts des entfernten Dokuments der Inhalt des xi:fallback-Elements das xi:include-Element. Zum Beispiel:

Es gibt keine Einschränkungen dafür, was ein xi:fallback-Element enthalten kann. Es kann einfachen Text enthalten, ein Kindelement, gemischten Inhalt oder auch ein anderes xi:include-Element, das aufgelöst werden soll, wenn das oberste nicht aufgelöst werden kann. Dieses xi:include-Element versucht beispielsweise dasselbe Dokument von drei unterschiedlichen Sites zu laden:

Ein xi:include-Element darf nicht mehr als ein xi:fallback-Kind haben und darf keine anderen xi:include-Kindelemente oder andere Kindelemente aus dem XInclude-Namensraum enthalten. Sonst werden alle Kinder eines xi:include-Elements ignoriert, die sich nicht im XInclude-Namensraum befinden, und erscheinen nach dem Einschließen nicht im Ergebnisdokument. Das xi:fallback-Element wird ignoriert, wenn die Ressource, die vom href-Attribut des xi:include-Elternelements angegeben wird, erfolgreich geladen wurde. Ein xi:fallback-Element darf nur als Kind eines xi:include-Elements erscheinen. Es ist ein fataler Fehler, wenn es ein anderes Elternelement hat.

Fallbacks werden nur bei Ressourcenfehlern verarbeitet, meist bei I/O-Fehlern, die beim Laden der entfernten Ressource auftreten. Andere Probleme – beispielsweise, wenn das Dokument nicht wohlgeformt ist, aber parse="xml" angegeben wurde, oder wenn ein einzuschließenden Textdokument Zeichen enthält, die in XML unzulässig sind, oder wenn es innerhalb des xi:include-Elements einen Syntax-Fehler gibt – sind fatale Fehler. Wenn eines dieser Dinge passiert, hört der Prozessor einfach mit der Verarbeitung auf und meldet einen Fehler.