repo_zf1/documentation/manual/de/module_specs/Zend_Json-xml2json.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15156 -->
<!-- Reviewed: no -->
<sect1 id="zend.json.xml2json">
    <title>XML zu JSON Konvertierung</title>
    <para>
        <classname>Zend_Json</classname> bietet eine bequeme Methode für das transformieren von XML formatierten Daten
        in das JSON Format. Dieses Feature wurde inspiriert durch einen
        <ulink url="http://www.ibm.com/developerworks/xml/library/x-xml2jsonphp/">
        IBM developerWorks Artikel</ulink>.
    </para>

    <para>
        <classname>Zend_Json</classname> enthält eine statische Funktion die <classname>Zend_Json::fromXml()</classname> heißt.
        Diese Funktion erzeugt JSON von einer angegebenen XML Eingabe. Diese Funktion nimmt jeglichen
        beliebigen XML String als Eingabe Parameter. Sie nimmt auch einen optionalen Boolschen Eingabe Parameter
        um die Konvertierungslogik zu instruieren ob XML Attribute wärend des Konvertierungsprozesses ignoriert
        werden sollen oder nicht. Wenn dieser optionale Eingabeparameter nicht angegeben wurde, besteht das
        Standardverhalten darun XML Attribute zu ignorieren. Der Funktionsaufruf wird wie folgt durchgeführt:
    </para>
    <programlisting role="php"><![CDATA[
// Die fromXml Funktion nimmt einfach einen String der XML
// Inhalt als Eingabe enthält.
$jsonContents = Zend_Json::fromXml($xmlStringContents, true);
]]></programlisting>

    <para>
        Die <classname>Zend_Json::fromXml()</classname> Funktion führt die Konvertierung des XML formatierten String
        Eingabeparameters durch und gibt eine äquivalente JSON formatierte String Ausgabe zurück. Im Fall eines
        XML Eingabeformat Fehlers oder eines Konvertierungslogik Fehlers wird diese Funktion eine Ausnahme werfen.
        Die Konvertierungslogik verwendet rekursive Techniken um den XML Baum zu durchlaufen. Sie unterstützt
        Rekursionen die bis zu 25 Levels tief sind. Über diese Tiefe hinweg wird Sie eine
        <classname>Zend_Json_Exception</classname> werfen. Es gibt verschiedenste XML Dateien mit unterschiedlichem Grad an
        Komplexität die im tests Verzeichnis des Zend Frameworks vorhanden sind. Sie können verwendet werden um
        die Funktionalität des xml2json Features zu testen.
    </para>

    <para>
        Das folgende ist ein einfaches Beispiel das beides zeigt, den XML Eingabe String zu JSON übergeben wird,
        und den JSON Ausgabe String der als Ergebnis von der <classname>Zend_Json::fromXml()</classname> Funktion
        zurückgegeben wird. Dieses Beispiel verwendet den optionalen Funktionsparameter um die XML Attribute
        nicht wärend der Konvertierung zu ignorieren. Demzufolge kann man sehen das der resultierende JSON String
        eine Repräsentation der XML Attribute enthält die im XML Eingabestring vorhanden sind.
    </para>

    <para>
        XML Eingabe String der an die <classname>Zend_Json::fromXml()</classname> Funktion übergeben wird:
    </para>

    <programlisting role="php"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<books>
    <book id="1">
        <title>Code Generation in Action</title>
        <author><first>Jack</first><last>Herrington</last></author>
        <publisher>Manning</publisher>
    </book>

    <book id="2">
        <title>PHP Hacks</title>
        <author><first>Jack</first><last>Herrington</last></author>
        <publisher>O'Reilly</publisher>
    </book>

    <book id="3">
        <title>Podcasting Hacks</title>
        <author><first>Jack</first><last>Herrington</last></author>
        <publisher>O'Reilly</publisher>
    </book>
</books>
]]></programlisting>

    <para>
        JSON Ausgabe String der von der <classname>Zend_Json::fromXml()</classname> Funktion zurückgegeben wird:
    </para>

    <programlisting role="php"><![CDATA[
{
   "books" : {
      "book" : [ {
         "@attributes" : {
            "id" : "1"
         },
         "title" : "Code Generation in Action",
         "author" : {
            "first" : "Jack", "last" : "Herrington"
         },
         "publisher" : "Manning"
      }, {
         "@attributes" : {
            "id" : "2"
         },
         "title" : "PHP Hacks", "author" : {
            "first" : "Jack", "last" : "Herrington"
         },
         "publisher" : "O'Reilly"
      }, {
         "@attributes" : {
            "id" : "3"
         },
         "title" : "Podcasting Hacks", "author" : {
            "first" : "Jack", "last" : "Herrington"
         },
         "publisher" : "O'Reilly"
      }
   ]}
}
]]></programlisting>

    <para>
        Weitere Details über das xml2json Feature können im originalen Proposal selbst gefunden werden.
        Siehe <ulink url="http://tinyurl.com/2tfa8z">Zend_xml2json proposal</ulink>.
    </para>

</sect1>
<!--
vim:se ts=4 sw=4 et:
-->