{"id":42480,"date":"2026-06-11T21:09:24","date_gmt":"2026-06-11T18:09:24","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/xmlden-jsona-donusum-gorunmez-tuzaklardan-nasil-kacinilir\/"},"modified":"2026-06-11T21:10:03","modified_gmt":"2026-06-11T18:10:03","slug":"xmlden-jsona-donusum-gorunmez-tuzaklardan-nasil-kacinilir","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/xmlden-jsona-donusum-gorunmez-tuzaklardan-nasil-kacinilir\/","title":{"rendered":"XML’den JSON’a D\u00f6n\u00fc\u015f\u00fcm: G\u00f6r\u00fcnmez Tuzaklardan Nas\u0131l Ka\u00e7\u0131n\u0131l\u0131r?"},"content":{"rendered":"

XML’den JSON’a D\u00f6n\u00fc\u015f\u00fcm: G\u00f6r\u00fcnmez Tuzaklardan Nas\u0131l Ka\u00e7\u0131n\u0131l\u0131r?<\/h2>\n

Modern web uygulamalar\u0131 ve API’ler d\u00fcnyas\u0131nda, veri formatlar\u0131 aras\u0131ndaki d\u00f6n\u00fc\u015f\u00fcm ka\u00e7\u0131n\u0131lmaz bir gereklilik haline gelmi\u015ftir. \u00d6zellikle k\u00f6kl\u00fc sistemlerin ve eski nesil servislerin vazge\u00e7ilmezi olan XML ile g\u00fcn\u00fcm\u00fcz\u00fcn hafif, okunabilir ve JavaScript dostu format\u0131 JSON aras\u0131nda k\u00f6pr\u00fc kurmak, bir\u00e7ok geli\u015ftiricinin kar\u015f\u0131la\u015ft\u0131\u011f\u0131 temel bir g\u00f6revdir. Ancak bu d\u00f6n\u00fc\u015f\u00fcm s\u00fcreci, san\u0131ld\u0131\u011f\u0131ndan daha fazla gizli tuzak bar\u0131nd\u0131r\u0131r ve do\u011fru y\u00f6netilmedi\u011finde ciddi veri kay\u0131plar\u0131na, tutars\u0131zl\u0131klara ve sistem hatalar\u0131na yol a\u00e7abilir. Peki, XML’in karma\u015f\u0131k hiyerar\u015fisini JSON’\u0131n d\u00fcz yap\u0131s\u0131na aktar\u0131rken kar\u015f\u0131la\u015f\u0131lan bu “\u0131s\u0131ran” tuzaklardan nas\u0131l ka\u00e7\u0131nabiliriz? Bu makalede, XML’den JSON’a d\u00f6n\u00fc\u015f\u00fcm\u00fcn inceliklerini, s\u0131k kar\u015f\u0131la\u015f\u0131lan sorunlar\u0131 ve bu sorunlar\u0131 a\u015fmak i\u00e7in kullanabilece\u011finiz pratik stratejileri ad\u0131m ad\u0131m inceleyece\u011fiz. Amac\u0131m\u0131z, hem yeni ba\u015flayanlar\u0131n temel kavramlar\u0131 anlamas\u0131n\u0131 sa\u011flamak hem de deneyimli geli\u015ftiricilerin g\u00f6zden ka\u00e7\u0131rabilece\u011fi detaylara dikkat \u00e7ekerek daha sa\u011flam ve g\u00fcvenilir d\u00f6n\u00fc\u015f\u00fcm s\u00fcre\u00e7leri olu\u015fturmalar\u0131na yard\u0131mc\u0131 olmakt\u0131r.<\/p>\n

XML ve JSON: Temel Farklar ve Neden D\u00f6n\u00fc\u015f\u00fcme \u0130htiya\u00e7 Duyar\u0131z?<\/h2>\n

Veri al\u0131\u015fveri\u015fi s\u00f6z konusu oldu\u011funda, XML (Extensible Markup Language) ve JSON (JavaScript Object Notation) en yayg\u0131n kullan\u0131lan iki formatt\u0131r. Her ikisi de yap\u0131land\u0131r\u0131lm\u0131\u015f veri depolama ve iletme yetene\u011fine sahip olsa da, temel felsefeleri ve kullan\u0131m alanlar\u0131 bak\u0131m\u0131ndan \u00f6nemli farkl\u0131l\u0131klar g\u00f6sterirler. Bu farkl\u0131l\u0131klar\u0131 anlamak, d\u00f6n\u00fc\u015f\u00fcm s\u00fcrecindeki zorluklar\u0131 kavraman\u0131n ilk ad\u0131m\u0131d\u0131r. XML, hiyerar\u015fik bir yap\u0131ya sahiptir ve veriyi etiketler (tagler) aras\u0131na yerle\u015ftirir. Bu etiketler, verinin ne anlama geldi\u011fini a\u00e7\u0131klayan semantik bir katman sa\u011flar. Ayr\u0131ca, XML DTD (Document Type Definition) veya XML Schema gibi mekanizmalar arac\u0131l\u0131\u011f\u0131yla verinin yap\u0131s\u0131n\u0131 ve t\u00fcr\u00fcn\u00fc tan\u0131mlama yetene\u011fi sunar. Bu durum, \u00f6zellikle kurumsal sistemlerde ve s\u0131k\u0131 veri do\u011frulama gerektiren alanlarda (\u00f6rne\u011fin, finans veya sa\u011fl\u0131k) XML’i g\u00fc\u00e7l\u00fc bir se\u00e7enek haline getirir. Ancak XML’in bu a\u00e7\u0131klay\u0131c\u0131 yap\u0131s\u0131, beraberinde daha fazla “g\u00fcr\u00fclt\u00fc” (verbose) ve dosya boyutu getirir. \u00d6rne\u011fin, bir kitap bilgisini XML olarak temsil etmek istedi\u011fimizde a\u015fa\u011f\u0131daki gibi bir yap\u0131 ortaya \u00e7\u0131kabilir:<\/p>\n

\n
\n<kitap>\n    <baslik>K\u00fcrk Mantolu Madonna<\/baslik>\n    <yazar id=\"yazar1\">Sabahattin Ali<\/yazar>\n    <yil>1943<\/yil>\n    <turler>\n        <tur>Roman<\/tur>\n        <tur>Edebiyat<\/tur>\n    <\/turler>\n<\/kitap>\n  <\/code><\/pre>\n<\/div>\n
\u00d6te yandan JSON, ad\u0131ndan da anla\u015f\u0131laca\u011f\u0131 gibi JavaScript nesne g\u00f6sterimine dayal\u0131d\u0131r. Anahtar-de\u011fer \u00e7iftleri (key-value pairs) ve diziler (arrays) kullanarak veriyi temsil eder. XML’e g\u00f6re \u00e7ok daha hafif, az yer kaplayan ve taray\u0131c\u0131 tabanl\u0131 uygulamalarla do\u011frudan uyumlu bir yap\u0131 sunar. Bu \u00f6zellikleri sayesinde JSON, modern web servisleri (RESTful API’ler), mobil uygulamalar ve tek sayfal\u0131k uygulamalar (SPA’lar) i\u00e7in tercih edilen veri format\u0131 haline gelmi\u015ftir. Ayn\u0131 kitap bilgisini JSON olarak ifade etti\u011fimizde daha kompakt bir g\u00f6r\u00fcn\u00fcm elde ederiz:<\/p>\n
\n
\n{\n  \"kitap\": {\n    \"baslik\": \"K\u00fcrk Mantolu Madonna\",\n    \"yazar\": {\n      \"id\": \"yazar1\",\n      \"ad\": \"Sabahattin Ali\"\n    },\n    \"yil\": 1943,\n    \"turler\": [\n      \"Roman\",\n      \"Edebiyat\"\n    ]\n  }\n}\n  <\/code><\/pre>\n<\/div>\n
Peki, bu iki format aras\u0131nda neden d\u00f6n\u00fc\u015f\u00fcme ihtiya\u00e7 duyar\u0131z? Temel olarak, mevcut sistemlerin ve veritabanlar\u0131n\u0131n hala XML format\u0131nda veri \u00fcretti\u011fi veya t\u00fcketti\u011fi durumlar ile yeni geli\u015ftirilen uygulamalar\u0131n JSON tabanl\u0131 API’lerle \u00e7al\u0131\u015ft\u0131\u011f\u0131 senaryolar aras\u0131nda bir k\u00f6pr\u00fc kurmak i\u00e7in. \u00d6rne\u011fin, eski bir kurumsal ERP sistemi XML \u00e7\u0131kt\u0131s\u0131 verirken, bu veriyi modern bir mobil uygulamada g\u00f6stermek istedi\u011fimizde JSON’a d\u00f6n\u00fc\u015ft\u00fcrmemiz gerekir. Benzer \u015fekilde, baz\u0131 \u00fc\u00e7\u00fcnc\u00fc taraf servisler XML tabanl\u0131 API’ler sunarken, kendi backend servisimiz bu veriyi i\u015flemek i\u00e7in JSON bekleyebilir. D\u00f6n\u00fc\u015f\u00fcm, farkl\u0131 teknolojiler ve platformlar aras\u0131ndaki uyumlulu\u011fu sa\u011flamak, performans\u0131 art\u0131rmak (JSON genellikle daha h\u0131zl\u0131 ayr\u0131\u015ft\u0131r\u0131l\u0131r) ve geli\u015ftirme kolayl\u0131\u011f\u0131 sunmak (JavaScript ile do\u011frudan kullan\u0131labilirlik) gibi avantajlar sunar. Ancak bu s\u00fcre\u00e7te, XML’in zengin yap\u0131s\u0131n\u0131n JSON’\u0131n daha yal\u0131n yap\u0131s\u0131na nas\u0131l aktar\u0131laca\u011f\u0131 konusunda dikkatli olmak gerekir. \u00c7\u00fcnk\u00fc XML’in baz\u0131 \u00f6zellikleri (nitelikler, namespace’ler, kar\u0131\u015f\u0131k i\u00e7erik) JSON’da do\u011frudan bir kar\u015f\u0131l\u0131k bulmaz ve bu durum d\u00f6n\u00fc\u015f\u00fcm s\u0131ras\u0131nda veri kayb\u0131na veya yanl\u0131\u015f temsile yol a\u00e7abilir.<\/p>\n
Otomatik D\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fcler Her Zaman \u0130deal \u00c7\u00f6z\u00fcm m\u00fcd\u00fcr? Kar\u015f\u0131la\u015f\u0131lan \u0130lk Engeller Nelerdir?<\/h2>\n
XML’den JSON’a d\u00f6n\u00fc\u015f\u00fcm i\u00e7in piyasada bir\u00e7ok otomatik ara\u00e7 ve k\u00fct\u00fcphane bulunmaktad\u0131r. Python’da xmltodict<\/code>, Java’da JAXB veya Jackson k\u00fct\u00fcphaneleri, JavaScript’te fast-xml-parser<\/code> gibi pop\u00fcler se\u00e7enekler, \u00e7o\u011fu basit senaryoda i\u015finizi h\u0131zla g\u00f6rebilir. Bu ara\u00e7lar, genellikle XML a\u011fac\u0131n\u0131 tarayarak etiketleri JSON anahtarlar\u0131na, metin i\u00e7eriklerini de\u011ferlere d\u00f6n\u00fc\u015ft\u00fcr\u00fcrler. Hatta baz\u0131lar\u0131, temel d\u00fczeyde nitelik (attribute) ve dizi (array) alg\u0131lamas\u0131 da yapabilir. \u00d6rne\u011fin, bir XML belgesindeki tekrarlayan etiketleri otomatik olarak JSON dizilerine \u00e7evirme yetene\u011fine sahiptirler. Ancak, bu otomatik d\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fclerin \u00e7o\u011fu, “tek boyutlu” ve basit XML yap\u0131lar\u0131 i\u00e7in optimize edilmi\u015ftir. Ger\u00e7ek d\u00fcnya senaryolar\u0131nda kar\u015f\u0131la\u015f\u0131lan karma\u015f\u0131k XML belgeleriyle ba\u015fa \u00e7\u0131kmakta zorlanabilirler ve bu noktada “ilk engeller” ortaya \u00e7\u0131kar.<\/p>\n
En s\u0131k kar\u015f\u0131la\u015f\u0131lan ilk engellerden biri, XML niteliklerinin (attributes) JSON’a nas\u0131l aktar\u0131laca\u011f\u0131d\u0131r. XML’de bir etiketin hem metin i\u00e7eri\u011fi hem de nitelikleri olabilir. \u00d6rne\u011fin: <urun id=\"123\" stok=\"true\">Laptop<\/urun><\/code>. Otomatik d\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fcler, bu nitelikleri genellikle \u00f6zel bir \u00f6nek (\u00f6rne\u011fin, @<\/code> veya _<\/code>) kullanarak ayr\u0131 anahtarlar olarak JSON’a aktar\u0131r veya bazen tamamen g\u00f6z ard\u0131 edebilirler. Bu durum, JSON \u00e7\u0131kt\u0131s\u0131n\u0131n bekledi\u011finizden farkl\u0131 olmas\u0131na ve hatta veri kayb\u0131na yol a\u00e7abilir. Yukar\u0131daki \u00f6rnek, otomatik bir d\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fc taraf\u0131ndan a\u015fa\u011f\u0131daki gibi bir JSON \u00e7\u0131kt\u0131s\u0131 verebilir:<\/p>\n
\n
\n{\n  \"urun\": {\n    \"@id\": \"123\",\n    \"@stok\": \"true\",\n    \"#text\": \"Laptop\"\n  }\n}\n  <\/code><\/pre>\n<\/div>\n
Burada @<\/code> \u00f6neki ve #text<\/code> anahtar\u0131, XML’in yap\u0131s\u0131n\u0131 JSON’da temsil etme \u00e7abas\u0131d\u0131r, ancak bu, hedef sistemin bekledi\u011fi temiz ve standart JSON yap\u0131s\u0131ndan uzakla\u015fabilir. Bir di\u011fer engel, “kar\u0131\u015f\u0131k i\u00e7erik” (mixed content) olarak bilinen durumdur. XML’de bir etiketin i\u00e7inde hem metin hem de ba\u015fka etiketler bulunabilir. \u00d6rne\u011fin: <paragraf>Bu bir <b>kal\u0131n<\/b> metindir.<\/paragraf><\/code>. Otomatik d\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fcler, bu t\u00fcr yap\u0131lar\u0131 genellikle d\u00fczg\u00fcn bir \u015fekilde JSON’a \u00e7eviremezler. Metin par\u00e7alar\u0131n\u0131 birle\u015ftirme veya i\u00e7 i\u00e7e etiketleri yok sayma e\u011filiminde olabilirler, bu da orijinal XML belgesindeki bilginin kaybolmas\u0131na neden olur. JSON, temel olarak anahtar-de\u011fer \u00e7iftleri ve diziler \u00fczerine kurulu oldu\u011fu i\u00e7in, metin ve etiketlerin ayn\u0131 seviyede bulundu\u011fu bu t\u00fcr karma\u015f\u0131k yap\u0131lar\u0131 temsil etmekte zorlan\u0131r.<\/p>\n
Son olarak, XML’deki namespace’ler (isim uzaylar\u0131) de otomatik d\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fcler i\u00e7in bir ba\u015f belas\u0131d\u0131r. Namespace’ler, ayn\u0131 etiket adlar\u0131n\u0131n farkl\u0131 ba\u011flamlarda \u00e7ak\u0131\u015fmas\u0131n\u0131 \u00f6nlemek i\u00e7in kullan\u0131l\u0131r. \u00d6rne\u011fin, <soap:Envelope><\/code> veya <ns:data><\/code> gibi yap\u0131lar. Otomatik d\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fcler, bu namespace’leri genellikle JSON anahtarlar\u0131na dahil ederler (\u00f6rne\u011fin, \"soap:Envelope\"<\/code> veya \"ns:data\"<\/code> \u015feklinde). Bu durum, JSON \u00e7\u0131kt\u0131s\u0131n\u0131n daha az okunabilir olmas\u0131na ve \u00f6zellikle hedef sistemin bu t\u00fcr \u00f6nekli anahtarlar\u0131 do\u011frudan i\u015fleyememesi durumunda sorunlara yol a\u00e7ar. Otomatik ara\u00e7lar, ba\u015flang\u0131\u00e7ta h\u0131zl\u0131 bir \u00e7\u00f6z\u00fcm sunsa da, yukar\u0131da bahsedilen nitelik, kar\u0131\u015f\u0131k i\u00e7erik ve namespace gibi karma\u015f\u0131k XML \u00f6zellikleriyle kar\u015f\u0131la\u015f\u0131ld\u0131\u011f\u0131nda, genellikle yetersiz kal\u0131r. Bu noktada, d\u00f6n\u00fc\u015f\u00fcm s\u00fcrecine daha fazla kontrol ve \u00f6zelle\u015ftirme getiren manuel veya yar\u0131-otomatik yakla\u015f\u0131mlar devreye girmelidir.<\/p>\n
Nitelik (Attribute) ve Metin \u0130\u00e7eri\u011fi (Text Content) \u00c7ak\u0131\u015fmalar\u0131: Veri Kayb\u0131n\u0131 Nas\u0131l \u00d6nleriz?<\/h2>\n
XML’den JSON’a d\u00f6n\u00fc\u015f\u00fcmde en s\u0131k kar\u015f\u0131la\u015f\u0131lan ve veri kayb\u0131na yol a\u00e7abilen tuzaklardan biri, bir XML etiketinin hem niteliklere (attributes) hem de metin i\u00e7eri\u011fine (text content) sahip olmas\u0131d\u0131r. XML’in esnekli\u011fi, bir etiketin i\u00e7indeki veriyi hem metin olarak hem de nitelikler arac\u0131l\u0131\u011f\u0131yla ta\u015f\u0131mas\u0131na olanak tan\u0131r. Ancak JSON, bu ikili yap\u0131y\u0131 do\u011frudan temsil etmek i\u00e7in do\u011fal bir mekanizmaya sahip de\u011fildir. JSON’da bir anahtar\u0131n de\u011feri ya basit bir veri tipi (string, number, boolean, null) ya da yap\u0131land\u0131r\u0131lm\u0131\u015f bir nesne veya dizi olabilir. Bu durumda, XML’deki nitelikleri ve metin i\u00e7eri\u011fini nas\u0131l birle\u015ftirece\u011fimiz kritik bir karar haline gelir.<\/p>\n
\u00d6rne\u011fin, bir \u00fcr\u00fcn listesinden gelen XML par\u00e7as\u0131n\u0131 d\u00fc\u015f\u00fcnelim:<\/p>\n
\n
\n<urunler>\n    <urun id=\"A101\" stokAdedi=\"50\">Masa Lambas\u0131<\/urun>\n    <urun id=\"B202\" stokAdedi=\"12\">Ergonomik Klavye<\/urun>\n<\/urunler>\n  <\/code><\/pre>\n<\/div>\n
Yukar\u0131daki XML’de her <urun><\/code> etiketi hem id<\/code> ve stokAdedi<\/code> niteliklerine hem de bir metin i\u00e7eri\u011fine (“Masa Lambas\u0131”, “Ergonomik Klavye”) sahiptir. Otomatik d\u00f6n\u00fc\u015ft\u00fcr\u00fcc\u00fcler bu durumu farkl\u0131 \u015fekillerde ele alabilir:<\/p>\n
    \n
  1. Nitelikleri \u00f6zel bir \u00f6nekle (\u00f6rne\u011fin @<\/code>) ayr\u0131 anahtarlar olarak, metin i\u00e7eri\u011fini ise #text<\/code> veya benzeri bir anahtarla temsil etme. Bu, yukar\u0131da bahsetti\u011fimiz gibi JSON \u00e7\u0131kt\u0131s\u0131n\u0131 karma\u015f\u0131kla\u015ft\u0131r\u0131r ve \u00e7o\u011fu zaman istenmeyen bir durumdur.<\/li>\n
  2. Nitelikleri bir nesnenin i\u00e7inde, metin i\u00e7eri\u011fini ise o nesnenin belirli bir anahtar\u0131 olarak (\u00f6rne\u011fin \"value\"<\/code> veya \"ad\"<\/code>) g\u00f6sterme. Bu yakla\u015f\u0131m daha temiz bir JSON yap\u0131s\u0131 sunabilir.<\/li>\n
  3. Basit durumlarda, nitelikleri tamamen g\u00f6z ard\u0131 etme veya metin i\u00e7eri\u011fini tek ba\u015f\u0131na alma. Bu durum, ciddi veri kayb\u0131na yol a\u00e7ar.<\/li>\n<\/ol>\n
    Bu \u00e7ak\u0131\u015fmalar\u0131 \u00f6nlemek ve veri kayb\u0131n\u0131 engellemek i\u00e7in stratejik yakla\u015f\u0131mlar geli\u015ftirmek \u00f6nemlidir. \u0130\u015fte baz\u0131 etkili y\u00f6ntemler:<\/p>\n