URLStream  - AS3

Girdi arabelleğindeki okunmak için bekleyen bayt sayısını döndürür. Kodunuzu okumayı read yöntemlerinden biriyle okumayı denemeden önce kodunuz, yeterli verinin bulunduğundan emin olmak için bytesAvailable öğesini çağırmalıdır.

Bu URLStream nesnesinin o anda bağlı olup olmadığını gösterir. URLStream nesnesi bağlıysa bu özelliğe yapılan bir çağrı true değerini, aksi halde false değerini döndürür.

Veri için bayt sırasını belirtir. Olası değerler şunlardır: Endian.BIG_ENDIAN veya Endian.LITTLE_ENDIAN.

Varsayılan değer şudur Endian.BIG_ENDIAN.

İlgili API Öğeleri

Bir nesneyi okurken veya yazarken kullanılan Action Message Format (AMF) sürümünü kontrol eder.

İlgili API Öğeleri

Hemen akışı kapatır ve indirme işlemini iptal eder. close() yöntemi çağrıldıktan sonra akıştan hiçbir veri okunamıyor.

request parametresinde belirtilen URL'yi indirmeye başlar.

Not: İndirilen bir dosya ASCII olmayan karakterler içeriyorsa (İngilizce dışındaki birçok dilde görüldüğü gibi) dosyayı, ASCII gibi Unicode olmayan bir biçimin aksine UTF-8 veya UTF-16 kodlamasıyla kaydetmeniz önerilir.

Yükleme işlemi anında başarısız oluyorsa, hatayı açıklayan bir IOError veya SecurityError (yerel dosya güvenlik hatası da dahil) istisnası atılır. Aksi halde URL indirmesi, indirme işlemini başarıyla başlatıyorsa bir open olayı gönderilir veya bir hata oluşması durumunda bir error olayı gönderilir.

Varsayılan olarak, çağıran SWF dosyası ve yüklediğiniz URL tamamen aynı etki alanında olmalıdır. Örneğin www.adobe.com adresindeki bir SWF dosyası yalnızca www.adobe.com adresinde bulunan kaynaklardan veri yükleyebilir. Farklı bir etki alanından veri yüklemek için, verileri barındıran sunucuya bir URL ilke dosyası yerleştirin.

Flash Player'da genel olarak rezerve edilen bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.

Flash Player ve sonrasında SWF içeriğini kapsayan HTML sayfasındaki object ve embed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.

Flash Player 10 ve daha sonrası ile AIR 1.5 ve daha sonrasında, yükleme (POST gövdesi içinde "content-disposition" başlığında "filename" parametresiyle belirtilir) içeren çok bölümlü bir Content-Type (örneğin, "multipart/form-data") kullanıyorsanız, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabidir.

• Fare tıklatma veya tuş basışı gibi kullanıcı tarafından başlatılan bir eyleme yanıt olarak POST işleminin gerçekleştirilmesi gerekir.
• POST işlemi etki alanları arasıysa (POST hedefi, POST isteğini gönderen SWF dosyasıyla aynı sunucuda değilse), hedef sunucunun etki alanları arası erişime izin veren bir URL ilke dosyası sağlaması gerekir.

Ayrıca çok bölümlü herhangi bir Content-Type için sözdiziminin geçerli olması gerekir (RFC2046 standartlarına göre). Sözdizimi geçersiz görünüyorsa, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabi olur.

Bu kurallar, uygulama dışı sanal alanlardaki AIR içeriğine de uygulanır. Ancak, Adobe AIR'da uygulama sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kullanılmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Developer Center Konusu: Güvenlik.

AIR'da, bir URLRequest nesnesi httpResponse durum olayı için kaydedilebilir. httpStatus olayından farklı olarak, httpResponseStatus olayı herhangi bir yanıt verisinden önce teslim edilir. Ayrıca, httpResponseStatus olayı, responseHeaders ve responseURL özelliklerine yönelik değerleri (httpStatus olayı için tanımsızdır) içerir. httpResponseStatus olayının (varsa) herhangi bir complete veya error olayından önce (ve buna ek olarak) gönderileceğini unutmayın.

Bir httpResponseStatus olay dinleyicisi bulunuyorsa, yanıt mesajının gövdesi her zaman gönderilir; ve HTTP durum kodu yanıtları her zaman bir complete olayıyla sonuçlanır. Bu, HTTP yanıt durumu bir başarıyı da bir hatayı da gösterse geçerlidir.

AIR'da, httpResponseStatus olay dinleyicisi bulunmuyorsa, davranış SWF sürümüne göre değişir:

• SWF 9 içeriği için, HTTP yanıt mesajının gövdesi yalnızca HTTP yanıt durumu başarıyı gösterdiğinde gönderilir. Aksi takdirde (hata varsa), gövde gönderilmez ve URLRequest nesnesi bir IOError olayı gönderir.
• SWF 10 içeriği için, HTTP yanıt mesajının gövdesi her zaman gönderilir. Hata oluştuğunda, URLRequest nesnesi bir IOError olayı gönderir.

Parametreler

Akıştan bir Boolean değeri okur. Tek bir bayt okunur, bayt sıfır olmayansa true, aksi halde false döndürülür.

Akıştan işaretli bir bayt okur.

Döndürülen değer -128...127 aralığındadır.

Akıştan gelen lenghts veri baytı okur. Baytlar, başlangıç offset baytları ByteArray nesnesine gidecek şekilde bytes tarafından ByteArray nesnesine okunur.

Parametreler

Akıştan bir IEEE 754 çift kesinlikli kayar nokta sayısı okur.

Akıştan bir IEEE 754 tek kesinlikli kayan nokta sayı okur.

Akıştan işaretli bir 32 bitlik tam sayı okur.

Döndürülen değer -2147483648...2147483647 aralığındadır.

Bayt akışından, belirtilen karakter kümesini kullanarak belirtilen uzunlukta çok baytlı bir dize okur.

Parametreler

Soketten gelen ve Action Message Format (AMF) olarak kodlanmış bir nesne okur.

İlgili API Öğeleri

Akıştan işaretli bir 16 bitlik tam sayı okur.

Döndürülen değer -32768...32767 aralığındadır.

Akıştan işaretsiz bir bayt okur.

Döndürülen değer 0...255 aralığındadır.

Akıştan işaretsiz bir 32 bitlik tam sayı okur.

Döndürülen değer 0...4294967295 aralığındadır.

Akıştan işaretsiz bir 16 bitlik tam sayı okur.

Döndürülen değer 0...65535 aralığındadır.

Akıştan bir UTF-8 dizesi okur. Uzunluğu bayt olarak gösteren işaretsiz bir kısa değişkenin dizeye önek yapıldığı varsayılır.

Akıştan bir dizi length UTF-8 baytı okur ve bir dize döndürür.

Parametreler

Veriler başarılı şekilde yüklendiğinde gönderilir.

Bu olay şu özelliklere sahiptir:

URLStream.load() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.

Bir URLStream nesnesi httpStatusEvent olayı için kaydolursa, içerik olmalarına rağmen hata yanıtları teslim edilir. Bu nedenle, hata verileri URLStream öğesine yüklendikçe, URLStream bir ioError olayı göndermek yerine, progress ve complete olaylarını gönderir.

HTTPStatusEvent.HTTP_RESPONSE_STATUS sabiti, httpResponseStatus olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

URLStream.load() çağrısı HTTP üzerinden verilere erişmeye çalışıyorsa ve Flash Player veya Adobe AIR istek için durum kodunu algılayabiliyor ve döndürebiliyorsa gönderilir. (Bazı tarayıcı ortamları, bu bilgiyi sağlayamayabilir.) httpStatus öğesinin (varsa) herhangi bir complete veya error olayından önce (veya buna ek olarak) gönderileceğini unutmayın.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir yükleme işleminin başarısız olmasına neden olan bir girdi/çıktı hatası ortaya çıktığında gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir yükleme işlemi başladığında gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

İndirme işlemi ilerlerken veri alındığında gönderilir. Alınan veri, URLStream sınıfının yöntemleri kullanılarak hemen okunabilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

URLStream.load() öğesine yapılan bir çağrı, güvenlik sanal alanının dışındaki bir sunucudan veri yüklemeye çalıştığında gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Örneği çalıştırmak için, SWF dosyanızla aynı dizine URLStreamExample.swf adlı bir dosya yerleştirin.

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:Event):void {
            trace("progressHandler: " + event);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}