XML respons warisan sebagai JSON: bagus untuk pemeriksaan, berisiko untuk kod

Ia berfungsi dengan satu hasil dan pecah dengan dua — suapan XML yang kelihatan seperti objek JSON yang kemas sehingga elemen kedua muncul

Sampel XML dengan satu hasil memetakan anaknya kepada objek atau rentetan; adik beradik kedua menukar harta yang sama kepada tatasusunan. Oleh itu, kod yang ditulis terhadap sampel yang ditukar pertama boleh gagal apabila kardinaliti berubah. JSON ialah unjuran kejadian yang diperhatikan, bukan kontrak yang menyedari skema.

ToolAcre menjadikan pemetaan boleh diramal tetapi tidak boleh mengalih keluar kekaburan satu lawan banyak ini. Untuk penyepaduan jangka panjang, normalkan laluan pengumpulan yang diketahui daripada XSD atau kontrak yang didokumenkan dan uji kedua-dua kardinaliti terhadap pembaca XML yang sebenarnya digunakan dalam pengeluaran.

Sebab penukaran sangat baik untuk membaca — bersarang diratakan menjadi pendakap biasa, atribut muncul sebagai kunci dan keseluruhan respons boleh diimbas sekaligus

Penukaran sangat baik untuk membaca kerana elemen bersarang menjadi objek biasa, adik beradik berulang menjadi tatasusunan dan atribut muncul sebagai kunci `@`. Sampul surat yang besar boleh diimbas dengan cepat tanpa padanan mental tag penutup. Inferens jenis boleh kekal dimatikan supaya teks tidak diteka secara senyap menjadi nombor atau boolean.

Pandangan yang boleh dibaca amat berguna semasa triage insiden, di mana mencari kod ralat atau muatan adalah lebih penting daripada mengekalkan penanda pengarang. Simpan sumber di sebelah JSON kerana unjuran mungkin tidak mengekalkan setiap perbezaan yang diperlukan oleh kod aplikasi.

Sebab bentuk yang ditukar tidak stabil — elemen berulang menjadi tatasusunan sahaja apabila diulang, awalan atribut dan nod teks yang muncul atau hilang

Bentuk yang ditukar bergantung pada kiraan kejadian, awalan terpelihara dan sama ada elemen mempunyai atribut atau anak. Teks biasa boleh runtuh kepada rentetan; teks yang sama bergerak di bawah `#text` apabila struktur ditambah. CDATA muncul di bawah `#cdata` dan atribut menggunakan `@`.

Peralihan ini adalah konvensyen yang didokumenkan, bukan kemalangan pelaksanaan yang tidak stabil. Mereka menjadi berisiko sahaja apabila kod menganggap satu sampel mentakrifkan semua bentuk XML pada masa hadapan. Model sedar skema boleh menyatakan kebolehulangan dan pilihan; penghurai generik tidak boleh.

Perkara yang hilang yang mungkin diperlukan oleh kod itu — ruang nama, susunan elemen, kandungan bercampur, CDATA sempadan dan ulasan

Awalan ruang nama kekal dalam nama harta dan pengisytiharan kekal sebagai `@xmlns:*`; mereka tidak berazam untuk mengembangkan nama. CDATA kekal ditanda di bawah kunci khasnya. Ulasan, pengisytiharan dan arahan pemprosesan digugurkan. Teks bercampur di sekeliling elemen kanak-kanak digabungkan dan kehilangan kedudukan relatif.

Susunan elemen antara sifat yang dinamakan berbeza bukanlah pengganti yang selamat untuk jujukan nod XML selepas unjuran ke dalam objek. Jika susunan dokumen, prosa bercampur atau sempadan CDATA tepat penting, gunakan pokok XML atau penghurai peristiwa dan bukannya paparan berbentuk JSON ini.

Awalan ruang nama dan nilai CDATA kekal kelihatan, manakala susunan dan sempadan nod boleh hilang

Gunakan dokumen berbentuk sampul surat dengan awalan ruang nama, satu anak badan dan dua elemen hasil. Penukaran mendedahkan laluan badan, mengekalkan awalan literal dan menghasilkan tatasusunan hasil. Contoh menunjukkan navigasi tanpa menuntut kesilapan WSDL, SOAP atau sokongan resolusi ruang nama.

Kemudian ulangi dengan satu hasil dan perhatikan tatasusunan hilang. Pasangan itu ialah keperluan kod aplikasi lekapan regresi. ToolAcre boleh mendedahkan perbezaannya; ia tidak boleh memutuskan sama ada domain anda harus sentiasa membungkus nilai dalam tatasusunan.

Contoh berfungsi: dokumen XML berbentuk sampul surat tanpa menuntut sokongan skema SOAP

Bergantung pada penukaran boleh menjadi munasabah untuk XML berpusatkan data apabila pemetaan didokumenkan, kardinaliti dinormalkan dan lekapan meliputi atribut, nilai kosong, kandungan bercampur dan ruang nama. Anggap pemetaan itu sendiri sebagai antara muka yang dimiliki oleh aplikasi anda.

Pastikan inferens jenis jelas. Dengan itu, nilai adalah rentetan; dengan ia dihidupkan, heuristik parser memilih nombor dan boolean. Pemetaan yang stabil tidak seharusnya menogol pilihan itu secara tidak sengaja antara persekitaran.

Perkara ini tidak meliputi — alat WSDL dan XSD untuk menjana pelanggan yang ditaip, yang merupakan laluan yang teguh untuk penyepaduan jangka panjang

Tiada perkakas WSDL atau XSD disertakan. Penukar mengesahkan XML yang dibentuk dengan baik, menolak setiap DOCTYPE dan menayangkan nod; ia tidak menjana pelanggan yang ditaip, mengesahkan urutan atau menguatkuasakan aspek domain. Tugas-tugas tersebut memerlukan perisian sedar skema.

DOCTYPE penolakan juga bermakna sesetengah dokumen warisan tidak akan dihuraikan walaupun pengisytiharannya tidak berbahaya. Ini ialah sempadan keselamatan yang menghalang pengembangan entiti, bukan bukti bahawa tindak balas perkhidmatan asas adalah salah bentuk.

Bawa pulang: tukar untuk memahami, menghuraikan untuk melaksanakan — dan cara panel penukar Sintaks memberikan anda paparan yang boleh dibaca dalam beberapa saat

Tukar untuk memahami; menghuraikan terhadap kontrak yang dimiliki untuk dilaksanakan. Pandangan JSON boleh mendedahkan muatan dalam beberapa saat, manakala XML yang asal kekal sebagai bukti pesanan, kardinaliti dan ruang nama.

Penukar sintaks jujur ​​tentang unjuran dan amarannya. Gunakan keterlihatan itu untuk mereka bentuk ujian kes tepi dan bukannya membiarkan satu sampel kemas mentakrifkan penyepaduan yang pecah pada elemen berulang seterusnya.

Set lekapan tahan lama harus termasuk sifar, satu dan beberapa kejadian untuk elemen boleh berulang; atribut dan anak berkongsi nama; elemen penutup diri; teks bercampur; CDATA; dan awalan ruang nama literal. Jalankan lekapan tersebut melalui pemetaan yang sebenarnya anda gunakan dan tegaskan objek domain yang dinormalkan, bukan teks JSON yang diformatkan ToolAcre. Pendekatan itu menggunakan penukar untuk meneroka bentuk sambil mengekalkan tingkah laku pengeluaran terikat dengan kontrak penghurai yang jelas.