repo_zf1/documentation/manual/pt-br/module_specs/Zend_Json-xml2json.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20792 -->
<!-- Reviewed: no -->
<sect1 id="zend.json.xml2json">
    <title>Conversão de XML para JSON</title>

    <para>
        <classname>Zend_Json</classname> fornece um conveniente método para transformar dados
        formatados em <acronym>XML</acronym> para o formato <acronym>JSON</acronym>. Este recurso
        foi inspirado em um <ulink
            url="http://www.ibm.com/developerworks/xml/library/x-xml2jsonphp/">artigo do
            IBM developerWorks</ulink>.
    </para>

    <para>
        <classname>Zend_Json</classname> inclui uma função estática chamada
        <methodname>Zend_Json::fromXml()</methodname>. Esta função irá gerar um
        <acronym>JSON</acronym> a partir de uma entrada em <acronym>XML</acronym>. Esta função
        recebe qualquer string arbitrária em <acronym>XML</acronym> como um parâmetro de entrada.
        Tem também um parâmetro de entrada opcional do tipo booleano que instrui a lógica de
        conversão para ignorar ou não os atributos <acronym>XML</acronym> durante o processo de
        conversão. Se esse parâmetro de entrada opcional não é dado, então o comportamento padrão
        é ignorar os atributos <acronym>XML</acronym>. Esta chamada de função é feita como mostrado
        abaixo:
    </para>

    <programlisting language="php"><![CDATA[
// a função fromXml simplesmente recebe uma String contendo conteúdo
// em XML como entrada.
$jsonContents = Zend_Json::fromXml($xmlStringContents, true);
]]></programlisting>

    <para>
        A função <methodname>Zend_Json::fromXml()</methodname> faz a conversão da string formata
        em <acronym>XML</acronym> do parâmetro de entrada e retorna o equivalente como uma string
        formatada em <acronym>JSON</acronym>. No caso de qualquer erro de formatação do
        <acronym>XML</acronym> ou erro na lógica de conversão, esta função irá lançar uma exceção.
        A lógica de conversão também utiliza técnicas recursivas para percorrer a árvore
        <acronym>XML</acronym>. Ele suporta até 25 níveis de profundidade de recursão. Se passar
        dessa profundidade, será lançado um <classname>Zend_Json_Exception</classname>. Existem
        vários arquivos <acronym>XML</acronym> com vários graus de complexidade fornecidos no
        diretório de testes de Zend Framework. Eles podem ser usados para testar a
        funcionalidade do recurso xml2json.
    </para>

    <para>
        O simples exemplo a seguir mostra uma string <acronym>XML</acronym> passada como entrada e
        uma string <acronym>JSON</acronym> de saída retornada como resultado da função
        <methodname>Zend_Json::fromXml()</methodname>. Este exemplo usa o parâmetro opcional da
        função para não ignorar os atributos <acronym>XML</acronym> durante a conversão.
        Consequentemente, você pode notar que a string <acronym>JSON</acronym> resultante inclui
        uma representação dos atributos <acronym>XML</acronym> presentes na string
        <acronym>XML</acronym> de entrada.
    </para>

    <para>
        String <acronym>XML</acronym> passada como entrada para a função
        <methodname>Zend_Json::fromXml()</methodname>:
    </para>

    <programlisting language="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>
        String <acronym>JSON</acronym> de saída retornada da função
        <methodname>Zend_Json::fromXml()</methodname>:
    </para>

    <programlisting language="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>
        Mais detalhes sobre o recurso xml2json podem ser encontrados na proposta original em si.
        Dê uma olhada na <ulink url="http://tinyurl.com/2tfa8z">proposta Zend_xml2json</ulink>.
    </para>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->