repo_zf1/documentation/manual/es/module_specs/Zend_Json-Objects.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 14000 -->
<!-- Reviewed: no -->
<sect1 id="zend.json.advanced">
    <title>Uso Avanzado de Zend_Json</title>

    <sect2 id="zend.json.advanced.objects1">
        <title>Objetos JSON</title>
        <para>Cuando se codifican objetos <acronym>PHP</acronym> como <acronym>JSON</acronym>, todas las propiedades
            públicas de ese objeto serán codificadas en un objeto <acronym>JSON</acronym>.</para>
        <para><acronym>JSON</acronym> no permite referencias a objetos, de manera que debe tenerse cuidado de no
            codificar objetos con referencias recursivas. Si tiene problemas con la recursión,
                <methodname>Zend_Json::encode()</methodname> y
                <methodname>Zend_Json_Encoder::encode()</methodname> permiten un segundo parámetro
            opcional para comprobar si hay recursión; si un objeto es serializado dos veces, se
            emitirá una excepción.</para>
        <para>La decodificación de objetos <acronym>JSON</acronym> plantea una dificultad adicional, sin embargo, ya
            que los objetos Javascript se corresponden más estrechamente a un array asociativo de
                <acronym>PHP</acronym>. Algunos sugieren que debe pasarse un identificador de clase,
            y una instancia del objeto de esa clase debe crearse y alimentarla con datos de pares
            clave/valor del objeto <acronym>JSON</acronym>; otros consideran que esto podría plantear un considerable
            riesgo de seguridad.</para>
        <para>Por defecto, <classname>Zend_Json</classname> decodificará objetos <acronym>JSON</acronym> como arrays
            asociativos. Sin embargo, si desea retornar un objeto, puede especificar esto:</para>
        <programlisting language="php"><![CDATA[
// Decodifica objetos JSON como objetos PHP
$phpNative = Zend_Json::decode($encodedValue, Zend_Json::TYPE_OBJECT);
]]></programlisting>
        <para>Por lo tanto, cualquiera de los objetos decodificados son devueltos como objetos
                <methodname>StdClass</methodname> con propiedades correspondientea a pares
            clave/valor en la notación <acronym>JSON</acronym>.</para>
        <para>La recomendación de Zend Framework es que el desarrollador debe decidir cómo
            decodificar objetos <acronym>JSON</acronym>. Si debe crearse un objeto de un determinado tipo, puede ser
            creado en el código del desarrollador y alimentado con datos de los valores
            decodificados utilizando <classname>Zend_Json</classname>.</para>
    </sect2>

    <sect2 id="zend.json.advanced.objects2">
        <title>Codificando Objetos PHP</title>

        <para>Si se codifican objetos <acronym>PHP</acronym> por defecto, el mecanismo de
            codificación sólo tiene acceso a las propiedades públicas de estos objetos. Cuando se
            implementa un método <methodname>toJson()</methodname> en un objeto a codificar,
                <classname>Zend_Json</classname> llama a este método y espera que el objeto devuelva
            una representación <acronym>JSON</acronym> de su estado interno.</para>
    </sect2>

    <sect2 id="zend.json.advanced.internal">
        <title>Codificador/Decodificador Interno</title>

        <para>Zend_Json tiene dos modos diferentes dependiendo de si ext/json está habilitada o no
            en su instalación <acronym>PHP</acronym>. Si ext/json está instalado por defecto, las
            funciones <methodname>json_encode()</methodname> y
                <methodname>json_decode()</methodname> se utilizan para la codificación y
            decodificación <acronym>JSON</acronym>. Si ext/json no está instalado, una implementación de Zend Framework
            en código <acronym>PHP</acronym> es utilizada para la codificación/decodificación. Esto
            es considerablemente más lento que usando la extensión de <acronym>PHP</acronym>, pero
            se comporta exactamente igual.</para>

        <para>También algunas veces puede querer utilizar el codificador/decodificador interno
            incluso si tiene ext/json instalado. Puede hacer esto llamando a:</para>

        <programlisting language="php"><![CDATA[
Zend_Json::$useBuiltinEncoderDecoder = true:
]]></programlisting>
    </sect2>

    <sect2 id="zend.json.advanced.expr">
        <title>Expresiones JSON</title>

        <para>Javascript hace uso intenso de las funciones anónimas de llamadas de retorno, que
            pueden guardarse en variables del objeto <acronym>JSON</acronym>. Aunque solo funcionan si no regresaron
            dentro comillas dobles, que es lo que hace naturalmente
            <classname>Zend_Json</classname>. Con la Expression de apoyo para Zend_Json este apoyo
            puede codificar objetos <acronym>JSON</acronym> con callbacks validos de javascript. Esto funciona tanto
            con <methodname>json_encode()</methodname> como con el codificador interno.</para>

        <para>Un callback javascript se representa usando el objero
                <classname>Zend_Json_Expr</classname>. Este implementa el patrón del objeto valor y
            es inmutable. Se puede establecer la expresión de javascript como el primer argumento
            del constructor. Por defecto <classname>Zend_Json::encode</classname> no codifica
            callbacks javascript, usted tiene que pasar la opción <methodname>'enableJsonExprFinder'
                = true</methodname> dentro de la función <methodname>encode</methodname>. Si se
            habilita, la expresión de apoyo trabaja para todas las expresiones anidadas en grandes
            estructuras de objetos. Un ejemplo de uso se vería así:</para>

        <programlisting language="php"><![CDATA[
$data = array(
    'onClick' => new Zend_Json_Expr('function() {'
              . 'alert("Yo soy un callback válido de javascript '
              . 'creado por Zend_Json"); }'),
    'other' => 'sin expresión',
);
$jsonObjectWithExpression = Zend_Json::encode(
    $data,
    false,
    array('enableJsonExprFinder' => true)
);
]]></programlisting>
    </sect2>
</sect1>