1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20792 -->
<!-- Reviewed: no -->
<sect1 id="zend.json.xml2json">
<title>XML to JSON conversion</title>
<para>
<classname>Zend_Json</classname> fournit une méthode de convenance pour transformer
des données au format <acronym>XML</acronym> en un format <acronym>JSON</acronym>. Ce dispositif est inspiré <ulink
url="http://www.ibm.com/developerworks/xml/library/x-xml2jsonphp/">d'un article de
developerWorks d'IBM</ulink>.
</para>
<para>
<classname>Zend_Json</classname> inclut une fonction statique appelée
<methodname>Zend_Json::fromXml()</methodname>. Cette fonction produira du <acronym>JSON</acronym> à partir d'une
entrée au format <acronym>XML</acronym>. Cette fonction prend n'importe quelle chaîne arbitraire <acronym>XML</acronym> comme
paramètre d'entrée. Elle prend également un paramètre booléen facultatif d'entrée pour
informer la logique de conversion d'ignorer ou non les attributs <acronym>XML</acronym> pendant le processus de
conversion. Si ce paramètre facultatif d'entrée n'est pas donné, alors le comportement par
défaut est d'ignorer les attributs <acronym>XML</acronym>. Cet appel de fonction est réalisé comme ceci
:
</para>
<programlisting language="php"><![CDATA[
// la fonction fromXml prend simplement une chaîne
// contenant le XML comme entrée
$jsonContents = Zend_Json::fromXml($xmlStringContents, true);
]]></programlisting>
<para>
La fonction <methodname>Zend_Json::fromXml()</methodname> fait la conversion du
paramètre d'entrée (chaîne au format <acronym>XML</acronym>) et renvoie le rendu équivalent sous forme de
chaîne au format <acronym>JSON</acronym>. En cas d'erreur, de format <acronym>XML</acronym> ou de logique de conversion, cette
fonction lèvera une exception. La logique de conversion emploie également des techniques
récursives à travers l'arbre <acronym>XML</acronym>. Il supporte la récursivité jusqu'à 25 niveaux de
profondeur. Au delà de cette profondeur, elle lèvera une
<classname>Zend_Json_Exception</classname>. Il y a plusieurs fichiers <acronym>XML</acronym>, avec différents
niveaux de complexité, fournis dans le répertoire tests de Zend Framework. Ils peuvent être
utilisés pour tester la fonctionnalité du dispositif xml2json.
</para>
<para>
Ce qui suit est un exemple simple qui montre à la fois la chaîne <acronym>XML</acronym> fournie et la
chaîne <acronym>JSON</acronym> retournée en résultat de la fonction
<methodname>Zend_Json::fromXml()</methodname>. Cet exemple utilise le paramètre facultatif
pour ne pas ignorer les attributs <acronym>XML</acronym> pendant la conversion. Par conséquent, vous pouvez
noter que la chaîne résultante <acronym>JSON</acronym> inclut une représentation des attributs <acronym>XML</acronym> actuels de
la chaîne <acronym>XML</acronym> fournie.
</para>
<para>Chaîne <acronym>XML</acronym> fournie à la fonction <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>
Chaîne <acronym>JSON</acronym> retournée par la fonction <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>
Plus de détails au sujet de ce dispositif xml2json peuvent être trouvés dans la
proposition originale elle-même. Jetez un oeil à la <ulink
url="http://framework.zend.com/wiki/display/ZFPROP/Zend_xml2json+-+Senthil+Nathan">proposition
Zend_xml2json</ulink>.
</para>
</sect1>
|
