Actionsciprt 3 XML Sınıfı (E4X)

10 Kasım 2007 – 00:05

Actionscript 3  içerisinde XML kütüphanesi köklü değişiklikler oldu.Şu anda ECMAScript for XML (E4X) denen bir sistem kullanıyor, ve kullanımı Actionscript 2 ye göre daha da kolaylaştırıldı.Validating Parser ile xml dosyalarınızın hatalı olup olmadığını kontrol ediyor, yani tagların düzgün kapatılıp kapatılmadığını, dügümlerin eksik mi yada yanlış yerlerde olup olmadığını kontrol ediyor.Bu özellik ile aslında büyük bir yükün altından kalkıyoruz.

Bu makalede Xml in Actionscript 3 ile Flash ın içerisinde temel olarak nasıl kullanıldığını ve XML sınıfını kısaca anlatmaya çalışacağım.
Bu yazıda kullanacağımız örnek xml sayfası;
<?xml version=”1.0″ encoding=”utf-8″?>
<list>
    <title>XML Test</title>
    <link>http://www.stayupdatedonweb.com</link>
    <item id=”001″>
    <book >Şehir Mektupları</book>
    <author> Ahmet Rasim </author>
    </item>
 <item id=”002″>
  <book  >Sınırlar Arasında</book>
    <author>Banu Avar</author>
 </item>
    <item id=”003″>
    <book >Yedek Parça</book>
    <author>Aziz Nesin”</author>
 </item>
</list>

İlk olarak bir xml dökümanını Flashın içerisine nasıl  yüklenebileceğini anlatacağım .Flashın dışında bulunan bir xml flasha yüklemek için  URLLoader sınıfını kullanılıyor.

  1. //Kullandığımız Türkçe karakterlerin doğru olarak görüntülenmesi için useCodePage özelliğini kullanıyoruz.
  2. System.useCodePage = true;
  3. //İlk olarak yeni bir xml tanımlıyoruz.
  4. var myXML:XML = new XML();
  5. //URLRequest
  6. var myXMLURL:URLRequest = new URLRequest("test.xml");
  7. //URLLoader
  8. var myLoader:URLLoader = new URLLoader(myXMLURL);
  9. //EventLİsterner ekliyoruz
  10. myLoader.addEventListener(Event.COMPLETE, xmlLoaded);
  11. //Yüklendiğinde çalışacak olan Fonksiyon
  12. function xmlLoaded(event:Event):void {
  13.             //myLoader daki bilgiyi alip xml le yüklüyor
  14.  myXML = XML(myLoader.data);
  15.             //XML yüklenen bilginin tamamının trace metodu ile çıktısını alıyoruz
  16.  trace(myXML);//Tamamı
  17. }

XMl i başarılı bir şekilde yüklediğimize göre xml i ayrıştırmaya geçebiliriz.Aşağıda vereceğim kodları xmlLoaded fonksiyonu içerisinde trace ederek sonuça ulaşabilirsiniz.
XMl de bir ilk düğümün altında duran bir  tagın içindeki bilgiyi almak için tek yapmanız gereken belirttiğiniz xml objesi ve tagın adını yazmak.

  1. trace(myXML.title) // XML Test
  2. trace(myXML.link) // http://www.stayupdatedonweb.com

Buradaki sıra tamamen önemli değil yani eğer  ilk düğümdeki title tagı xml’in sonunda da olsa başında da olsa aynı metodla ulaşabilirsiniz.

Peki eğer bir tag birden fazla sefer mevcutsa.Mesela kullandığımız örnek xml de 3 tane item tagı var, bu tagları almak için aynı metodu kullanacağız, ama bu bize tüm item taglarını verecektir.Belli bir tagı almak için ise item tagından sonra sıra numarası belirtmemiz gerekecek.Sıra numaraları tabii sıfır(0) dan başlayacaktır.

  1. trace(myXML.item)
  2. trace(myXML.item[0])

İstediğimiz Item tagını aldık, sırada ise item tagının içindeki book ve author taglarına ulaşmak.Bunun için ise item tagından sonra çağırmak istediğimiz tagı çağıracagız.

  1. trace(myXML.item[0].book) //Şehir Mektupları
  2. trace(myXML.item[0].author) //Ahmet Rasim

Şu ana kadar çektiğimiz tüm bilgiler taglar arasındaki bilgilerdi, peki herhangi bir attribute (öznitelik diye geçiyor sözlükte) nasıl çağırabiliz.Oda çok basit tabiki.Item tagından sonra @ işareti koyarak attribute adını yazmamız yeterli.item tagının attribute almak için

  1. trace(myXML.item[0].@id) // 001

Attribute lerin tamamına ulaşmak isterseniz yapmanız gereken  @ işaretinden sonra * işareti koymaktır.Bu size belirttiğiniz düğümdeki tüm attributeleri verecektir.

  1. trace(myXML.item.@*)

Ayrıca xml den bilgi alırken bu bilgileri filtreleyebiliyoruz.Mesela ismini bildiğiniz bir yazarın kitabını aratmak gibi.Bunun için ise tabii eşleştireceğiniz daha doğrusu filtreleyeğiniz bilginin bilinmesi gerekiyor.Düğümün tamamına ulaşmak için kullanacağınız metod;

  1. myXML.item.(author == "Banu Avar");

Sadece kitap ismini istiyorsak eğer  book tagını kodun sonuna ekleyerek ulaşabiliriz.

  1. myXML.item.(author == "Banu Avar").book; //Sınırlar Arasında

Aynı yöntemle item id numarasınada ulaşabiliriz.Tabii id numarası attribute olduğundan dolayı @ işareti kullanmanız gerekiyor.

  1. trace(myXML.item.(author == "Banu Avar").@id) //002

Filtreleme yöntemi için ihtiyaç duyduğunuz bilgi çeşidi ve xml inize göre düzenleyebilirsiniz.Ben sadece iki örenek daha verip filtreleme kısmını geçeceğim.

  1. myXML.item.(@id == 001);  // ikinci düğümün tamamını  size verecektir.
  2. myXML.item.(@id &gt; 002);  //iki den küçük olan tüm id lerin  düğümünü  size verecektir.

Sırada ise length özelliği var .length() ile xml in içindeki belli bir düğümünün sayısına yada element sayısına ulaşabilirsiniz.Aşağıdaki kod ile item düğümünün toplam saysını ulaşabilirsiniz.

  1. trace(myXML.item.length()); //item uzunluğu

Şimdiye kadar yukarıda vurguladım metodlar ve teknikler xml ayrıştırmanıza yardımcı olacak derecedir.Tabii bunların yanısıra farklı kod kombinasyonları kullanılabilir.
Mesela;

  1. trace(myXML.item.length()); //item uzunluğu
  2. trace(myXML.child("item").length());  // item uzunluğu
  3. trace(myXML.item); //item tamamı
  4. trace(myXML.child("item"));//item tamamı

yukarıdaki kodlar tamamen  aynı sonucu döndürecektir,tabiki  kullanım tercihiniz tamamen size aittir.

Kısacası actionscript 3 xml çözümleme yönünden eskisine göre şu anda daha güçlü ve kolay bir yapıya sahip.

Kaynak Kodlar
Kolay Gelsin…
Engin!

Bu makale ile ilgili olabilecek yazılar



  1. 3 Responses to “Actionsciprt 3 XML Sınıfı (E4X)”

  2. hocam bu “length ()” özelliğindeki () parantezler ne işe yarıyor xml yuklerken ve diğer bazı uygulamalarda aradaki farkı anlamak için parantez koydum hata verdi.. bazen parantezler kullanılmıyor bu özellikle birlikte sebebi nedir acaba… f1 ile çözülebilcek gibi değil…

    By emrah atılkan on Tem 1, 2008

  3. Merhaba Emrah,
    ilk olarak F1 i kullandığına sevindim, genelde kimse bakmıyorda. Şimdi lenght olayını izah edim. Flash içerisindeki sınıf yapılarının XML harici diğerlerinde lenght için herhangi bir parantez işareti kullanmazsın. Mesela bir string değerinin uzunluğu öğrenmek istiyorsa;

    var a:String = new String(”Test”);
    trace(a.length);

    Yukarıdaki kodda çıkacak olan sonuç 4 olacak. Dikkat ettiysen buradai length için herhangi bir paranztez eklenmedi. Bu Arraylar içinde geçerli.
    Esas soru şu aslında neden XML de parantez işaretleri kullanıyoruz?
    Cevap ise basit, XML deki bir metot, diğerleri ise birer özellik. Actionscrpt içerisine metotları kullanırken parantez açıp kapamak zorundasın.Temel fonksiyon çağırmak gibi yani.

    Umarım yardımcı olmuştur Emrah
    Kolay gelsin

    By Engin Yöyen on Tem 1, 2008

  4. çok yardımı oldu kesinlikle
    sayfanı takip edip elimden geldiğince az soru sormaya özen göstereceğim ama kafamda o kadar çok soru varki bir an önce kitabının çıkışını bekliyorum… teşekürler..

    By emrah atılkan on Tem 1, 2008

Yorum Ekleyin


Creative Commons License İçerik Hakkı Engin Yöyen'e ait olup sitedeki makaleler Creative Commons Attribution-Noncommercial 3.0 Unported lisansı ile lisanslanmıştır.