Paket | flash.net |
Sınıf | public class Socket |
Miras Alma | Socket EventDispatcher Object |
Uygular | IDataInput, IDataOutput |
Alt Sınıflar | SecureSocket |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Socket sınıfı, ikili protokoller kullanan sunucularla çalışmak için faydalıdır.
Socket sınıfının yöntemlerini kullanmak için, bir Socket nesnesi oluşturmak üzere ilk olarak new Socket
yapıcısını kullanın.
Bir soket eşzamansız olarak veri iletip alır.
Bazı işletim sistemlerinde, flush() öğesi yürütme kareleri arasında otomatik olarak çağrılır ancak Windows gibi diğer işletim sistemlerinde, flush()
öğesini açıkça çağırmadığınız sürece veri gönderilmez. Uygulamanızın tüm işletim sistemlerinde güvenilir bir şekilde davrandığından emin olmak için, her mesajı (veya ilişkili veri grubunu) sokete yazdıktan sonra flush()
yöntemini çağırmak iyi bir uygulamadır.
Adobe AIR'de, dinleyen bir ServerSocket öğesi harici bir işlemden bağlantı alırsa da Socket nesneleri oluşturulur. Bağlantıyı temsil eden Socket nesnesi, bir ServerSocketConnectEvent öğesinde gönderilir. Uygulamanız bu Socket nesnesine yapılan bir başvuruyu korumaktan sorumludur. Bunu yapmazsanız, Socket nesnesi çöp toplama için uygun hale gelir ve bir uyarı olmaksızın çalışma zamanı tarafından silinebilir.
Dosya sistemi ile yerel güvenlik sanal alanında çalışan SWF içeriği, soketleri kullanamaz.
Hedef ana bilgisayardaki soket ilke dosyaları, SWF dosyalarının soket bağlantıları yapabileceği ana bilgisayarları ve bu bağlantıların yapılabileceği bağlantı noktalarını belirtir. Soket güvenlik dosyasıyla ilgili güvenlik gereksinimleri, son birkaç Flash Player sürümünde daha sıkı hale gelmiştir. Tüm Flash Player sürümlerinde, Adobe bir soket ilke dosyasının kullanılmasını önerir; bazı durumlarda soket ilke dosyası gerekir. Bu nedenle, Socket nesneleri kullanıyorsanız, hedef ana bilgisayarın gerektiğinde bir soket ilke dosyası sağladığından emin olun.
Aşağıdaki listede, farklı Flash Player sürümlerindeki soket ilke dosyası gereksinimleri özetlenmektedir:
- Flash Player 9.0.124.0 ve sonraki sürümlerde, herhangi bir soket bağlantısı için bir soket ilke dosyası gerekir. Başka bir deyişle, hangi bağlantı noktasına bağlanırsanız bağlanın, hedef ana bilgisayarda bir soket ilke dosyası gerekir ve hatta SWF dosyasını sunan aynı ana bilgisayardaki bir bağlantı noktasına bağlandığınızda da bu dosya gerekir.
- Flash Player 9.0.115.0 ve önceki sürümlerde, 1024'ten düşük bir bağlantı noktası numarasına bağlanmak istiyorsanız veya SWF dosyasını sunan ana bilgisayardan başka bir ana bilgisayara bağlanmak istiyorsanız, hedef ana bilgisayarda bir soket ilke dosyası gerekir.
- Flash Player 9.0.115.0'da, soket ilke dosyası gerekmese de, hedef ana bilgisayar bir soket ilke dosyası sunmuyorsa, Flash Debug Player kullanılırken bir uyarı görüntülenir.
- AIR'de, uygulama güvenlik sanal alanında çalışan içerik için bir soket ilke dosyası gerekmez. AIR uygulama güvenlik sanal alanı dışında çalışan içeriğin oluşturduğu herhangi bir soket bağlantısı için soket ilke dosyaları gerekir.
Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Developer Center Konusu: Güvenlik
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
bytesAvailable : uint [salt okunur]
Girdi arabelleğinde okunabilen verilerin bayt sayısı. | Socket | ||
bytesPending : uint [salt okunur]
Yazma arabelleğinde kalan bayt sayısını belirtir. | Socket | ||
connected : Boolean [salt okunur]
Bu Socket nesnesinin halen bağlı olup olmadığını gösterir. | Socket | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
endian : String
Veri için bayt sırasını belirtir. | Socket | ||
localAddress : String [salt okunur]
Yerel makinede bu soketin bağlı olduğu IP adresi. | Socket | ||
localPort : int [salt okunur]
Yerel makinede bu soketin bağlı olduğu bağlantı noktası. | Socket | ||
objectEncoding : uint
Bir nesneyi okurken veya yazarken kullanılan AMF sürümünü kontrol eder. | Socket | ||
remoteAddress : String [salt okunur]
Bu soketin bağlandığı uzak makinenin IP adresi. | Socket | ||
remotePort : int [salt okunur]
Bu soketin bağlandığı uzak makinenin bağlantı noktası. | Socket | ||
timeout : uint
Bağlantı için beklenilecek milisaniye sayısını belirtir. | Socket |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Yeni Socket nesnesi oluşturur. | Socket | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | ||
Soketi kapatır. | Socket | ||
Soketi belirtilen ana makineye ve bağlantı noktasına bağlar. | Socket | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
Soketin çıktı arabelleğinde birikmiş tüm verileri temizler. | Socket | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
Soketten bir Boolean değeri okur. | Socket | ||
Soketten işaretli bir bayt okur. | Socket | ||
Soketten length parametresinde belirtilen sayıda veri baytı okur. | Socket | ||
Soketten bir IEEE 754 çift kesinlikli kayar nokta sayısı okur. | Socket | ||
Soketten bir IEEE 754 tek kesinlikli kayar nokta sayısı okur. | Socket | ||
Soketten işaretli bir 32 bit tam sayı okur. | Socket | ||
Bayt akışından, belirtilen karakter kümesini kullanarak çok baytlı bir dize okur. | Socket | ||
readObject():*
Soketten AMF serileştirilmiş biçimde kodlanmış bir nesne okur. | Socket | ||
Soketten işaretli bir 16 bit tam sayı okur. | Socket | ||
Soketten işaretsiz bir bayt okur. | Socket | ||
Soketten işaretsiz bir 32 bit tam sayı okur. | Socket | ||
Soketten işaretsiz bir 16 bit tam sayı okur. | Socket | ||
Soketten bir UTF-8 dizesi okur. | Socket | ||
Soketten length parametresinde belirtilen sayıda UTF-8 veri baytı okur ve bir dize döndürür. | Socket | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher | ||
Sokete bir Boolean değeri yazar. | Socket | ||
Sokete bir bayt yazar. | Socket | ||
Belirtilen bayt dizisinden bir bayt sırası yazar. | Socket | ||
Sokete IEEE 754 çift kesinlikli kayar nokta sayısı yazar. | Socket | ||
Sokete IEEE 754 tek keskinlikli kayar nokta sayısı yazar. | Socket | ||
Sokete 32 bit işaretli tam sayı yazar. | Socket | ||
Belirtilen karakter kümesini kullanarak bayt akışından çok baytlı bir dize yazar. | Socket | ||
Sokete AMF serileştirilmiş biçimde bir nesne yazar. | Socket | ||
Sokete 16 bit tam sayı yazar. | Socket | ||
Sokete 32 bit bir imzasız tam sayı yazar. | Socket | ||
Şu verileri sokete yazar: belirtilen UTF-8 dizesinin uzunluğunu bayt cinsinden belirten 16 bit imzasız tam sayı ve ardından dizenin kendisi. | Socket | ||
Sokete bir UTF-8 dizesi yazar. | Socket |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
Sunucu, soket bağlantısını kapattığında gönderilir. | Socket | |||
Bir ağ bağlantısı kurulduğunda gönderilir. | Socket | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Bir gönderme veya yükleme işleminin başarısız olmasına neden olan bir girdi/çıktı hatası ortaya çıktığında gönderilir. | Socket | |||
Bir yuva yazma arabelleğinden ağ aktarım katmanına veri taşıdığında gönderilir | Socket | |||
Socket.connect() öğesine yapılan bir çağrı, çağıranın güvenlik sanal alanı tarafından yasaklanan bir sunucuya veya 1024'ten düşük numaralı bir bağlantı noktasına bağlanmaya çalışırsa ve böyle bir bağlantıya izin verecek bir soket ilke dosyası yoksa gönderilir. | Socket | |||
Bir soket tarafından veri alındığında gönderilir. | Socket |
bytesAvailable | özellik |
bytesAvailable:uint
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Girdi arabelleğinde okunabilen verilerin bayt sayısı.
Kodunuz, read
yöntemlerinin birini kullanarak okumayı denemeden önce yeterli verinin bulunduğundan emin olmak için bytesAvailable
öğesini çağırmalıdır.
Uygulama
public function get bytesAvailable():uint
bytesPending | özellik |
bytesPending:uint
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3.0 |
Yazma arabelleğinde kalan bayt sayısını belirtir.
Bu özelliği OutputProgressEvent ile birlikte kullanın. OutputProgressEvent; veriler, yazma arabelleğinden ağa yazıldığında atılır. Olay işleyicisinde, arabellekte yazılmayı bekleyen kalan veri miktarını görmek için bytesPending
öğesine göz atabilirsiniz. bytesPending
0 değerini döndürürse bu, tüm verilerin yazma arabelleğinden ağa aktarıldığı anlamına gelir ve olay işleyicilerini kaldırma, soket başvurularını null değerine ayarlama, bir sırada bir sonraki yüklemeyi başlatma, vb. işlemleri gerçekleştirmek güvenlidir.
Uygulama
public function get bytesPending():uint
İlgili API Öğeleri
connected | özellik |
connected:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bu Socket nesnesinin halen bağlı olup olmadığını gösterir. Soket o anda bağlıysa bu özelliğe yapılan bir çağrı true
değerini, aksi halde false
değerini döndürür.
Uygulama
public function get connected():Boolean
endian | özellik |
endian:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Verilerin bayt sırasını gösterir. Olası değerler flash.utils.Endian sınıfından Endian.BIG_ENDIAN
veya Endian.LITTLE_ENDIAN
sabitleridir.
Varsayılan değer şudur Endian.BIG_ENDIAN.
Uygulama
public function get endian():String
public function set endian(value:String):void
İlgili API Öğeleri
localAddress | özellik |
localPort | özellik |
objectEncoding | özellik |
objectEncoding:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir nesneyi okurken veya yazarken kullanılan AMF sürümünü kontrol eder.
Uygulama
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
İlgili API Öğeleri
remoteAddress | özellik |
remoteAddress:String
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Bu soketin bağlandığı uzak makinenin IP adresi.
Bu özelliği ServerSocket nesnesi tarafından bir ServerSocketConnectEvent öğesinin içinde gönderilen istemci soketinin IP adresini belirlemek için kullanabilirsiniz. İsterseniz bir IP adresini etki alanına dönüştürmek için DNSResolver sınıfını kullanın.
Uygulama
public function get remoteAddress():String
İlgili API Öğeleri
remotePort | özellik |
remotePort:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Bu soketin bağlandığı uzak makinenin bağlantı noktası.
Bu özelliği ServerSocket nesnesi tarafından bir ServerSocketConnectEvent öğesinin içinde gönderilen istemci soketinin bağlantı noktası numarasını belirlemek için kullanabilirsiniz.
Uygulama
public function get remotePort():int
İlgili API Öğeleri
timeout | özellik |
timeout:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Bağlantı için beklenilecek milisaniye sayısını belirtir.
Belirtilen süre içinde bağlantı başarılı olmazsa, bağlantı gerçekleşmez. Varsayılan değer 20.000'dir (yirmi saniye).
Uygulama
public function get timeout():uint
public function set timeout(value:uint):void
Socket | () | Yapıcı |
public function Socket(host:String = null, port:int = 0)
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Yeni Socket nesnesi oluşturur. Hiçbir parametre belirtilmemişse, belirtilen bir ana bilgisayara veya bağlantı noktasına bir bağlantı yapılmaya çalışılır. Parametreler belirtilmişse, belirtilen ana bilgisayara ve bağlantı noktasına bir bağlantı yapılmaya çalışılır.
Not: Parametreler olmadan yapıcı formunu kullanmanız, daha sonra olay dinleyicilerini eklemeniz ve ardından host
ve port
parametreleriyle connect
yöntemini çağırmanız kesinlikle önerilir. Böylece tüm olay dinleyicilerinin düzgün şekilde çalışması güvence altına alınır.
host:String (default = null ) — Tam nitelikli bir DNS etki alanı adı veya IP adresi. IPv4 adresleri, noktalı ondalık notasyonunda belirtilir, örn. 192.0.2.0. Flash Player 9.0.115.0 ile AIR 1.0 ve sonraki sürümlerinde,2001:db8:ccc3:ffff:0:444d:555e:666f gibi onaltılı iki nokta notasyonunu kullanarak IPv6 adreslerini belirtebilirsiniz. Ayrıca, SWF dosyasının bulunduğu ana bilgisayar sunucusuna bağlanmak için null değerini belirtebilirsiniz. Bu çağrıyı başlatan SWF dosyası bir web tarayıcısında çalışıyorsa, host öğesi, SWF dosyasının geldiği aynı etki alanında olmalıdır.
| |
port:int (default = 0 ) — Bir bağlantı kurmak için kullanılan, hedef ana bilgisayar üzerindeki TCP bağlantı noktası numarası. Flash Player 9.0.124.0 veya sonraki sürümlerde, hedef ana bilgisayar, SWF dosyası sunan ana bilgisayardan belirtilen bağlantı noktasına soket bağlantılarına izin verildiğini belirten bir soket ilke dosyası sunmalıdır. Önceki Flash Player sürümlerinde, yalnızca 1024'ten düşük bir bağlantı noktası numarasına bağlanmak istediğinizde veya SWF dosyasını sağlayan ana bilgisayardan farklı bir ana bilgisayara bağlanmak istediğinizde bir soket ilke dosyası gerekir.
|
Olaylar
connect: — Bir ağ bağlantısı kurulduğunda gönderilir.
| |
ioError: — Bağlantının başarısız olmasına neden olan bir girdi/çıktı hatası meydana geldiğinde gönderilir.
| |
securityError: —
Socket.connect() öğesine yapılan bir çağrı, soket ilke dosyası sunmayan bir sunucuya veya ilke dosyası, çağıran ana bilgisayarın belirtilen bağlantı noktasına erişmesine olanak vermeyen bir sunucuya bağlanmayı denerse gönderilir. İlke dosyalarıyla ilgili daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzunda bulunan "Web sitesi denetimleri (ilke dosyaları)" ve Flash Player Geliştirici Merkezi Konusu: Güvenlik.
|
Atar
SecurityError — SWF içeriğinde aşağıdaki nedenlerle hata oluşur:
|
close | () | yöntem |
public function close():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketi kapatır. close()
yöntemi çağrıldıktan sonra veri yazamazsınız ve okuyamazsınız.
close
olayı yalnızca sunucu bağlantıyı kapattığında gönderilir; close()
yöntemini çağırdığınızda gönderilmez.
connect()
yöntemini üzerinde tekrar çağırarak Socket nesnesini kullanabilirsiniz.
Atar
IOError — Soket kapatılamadı veya soket açık değildi.
|
connect | () | yöntem |
public function connect(host:String, port:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketi belirtilen ana makineye ve bağlantı noktasına bağlar.
Bağlantı hemen başarısız olursa bir olay gönderilmiştir veya bir istisna atılmıştır: bir ana bilgisayar belirtilmişse bir hata olayı gönderilir ve herhangi bir ana bilgisayar belirtilmemişse bir istisna atılır. Aksi halde, bağlantının durumu bir olay tarafından bildirilir. Soket önceden bağlanmışsa, ilk olarak varolan bağlantı kapatılır.
Parametreler
host:String — Bağlanılacak ana bilgisayarın adı veya IP adresi. Herhangi bir ana bilgisayar belirtilmemişse temas kurulan ana bilgisayar, çağıran dosyasının bulunduğu ana bilgisayardır. Bir ana bilgisayar belirtmezseniz, bağlantının başarılı olup olmadığını belirlemek için bir olay dinleyicisi kullanın.
| |
port:int — Bağlanılacak bağlantı noktası numarası.
|
Olaylar
connect: — Bir ağ bağlantısı kurulduğunda gönderilir.
| |
ioError: — Bir ana bilgisayar belirtilirse ve bağlantının başarısız olmasına neden olan bir girdi/çıktı hatası meydana gelirse gönderilir.
| |
securityError: — Socket.connect() öğesine yapılan bir çağrı, soket ilke dosyası sunmayan bir sunucuya veya ilke dosyası, çağıran ana bilgisayarın belirtilen bağlantı noktasına erişmesine olanak vermeyen bir sunucuya bağlanmayı denerse gönderilir. İlke dosyalarıyla ilgili daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzunda bulunan "Web sitesi denetimleri (ilke dosyaları)" ve Flash Player Geliştirici Merkezi Konusu: Güvenlik.
|
Atar
IOError — Herhangi bir ana bilgisayar belirtilmemiş ve bağlantı başarısız.
| |
SecurityError — SWF içeriğinde aşağıdaki nedenlerle hata oluşur:
|
flush | () | yöntem |
public function flush():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketin çıktı arabelleğinde birikmiş tüm verileri temizler.
Bazı işletim sistemlerinde, flush() öğesi yürütme kareleri arasında otomatik olarak çağrılır ancak Windows gibi diğer işletim sistemlerinde, flush()
öğesini açıkça çağırmadığınız sürece veri gönderilmez. Uygulamanızın tüm işletim sistemlerinde güvenilir bir şekilde davrandığından emin olmak için, her mesajı (veya ilişkili veri grubunu) sokete yazdıktan sonra flush()
yöntemini çağırmak iyi bir uygulamadır.
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readBoolean | () | yöntem |
public function readBoolean():Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten bir Boolean değeri okur. Yöntem tek bir baytı okuduktan sonra, baytın sıfır olmaması durumunda true
, aksi halde false
değerini döndürür.
Boolean — Okunan veri sıfır değilse bir true değeri, aksi halde bir false değeri.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readByte | () | yöntem |
public function readByte():int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten işaretli bir bayt okur.
Döndürürint — -128 ile 127 arasında bir değer.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readBytes | () | yöntem |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten length parametresinde belirtilen sayıda veri baytı okur. Baytlar, offset
tarafından belirtilen konumdan başlayarak belirtilen bayt dizisine okunur.
Parametreler
bytes:ByteArray — Verinin içine okunacağı ByteArray nesnesi.
| |
offset:uint (default = 0 ) — Veri okuma işleminin bayt dizisinde başlaması gereken uzaklık.
| |
length:uint (default = 0 ) — Okunacak bayt sayısı. Varsayılan 0 değeri mevcut tüm verilerin okunmasına neden olur.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readDouble | () | yöntem |
public function readDouble():Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten bir IEEE 754 çift kesinlikli kayar nokta sayısı okur.
DöndürürNumber — Bir IEEE 754 çift kesinlikli kayar nokta sayısı.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readFloat | () | yöntem |
public function readFloat():Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten bir IEEE 754 tek kesinlikli kayar nokta sayısı okur.
DöndürürNumber — Bir IEEE 754 tek keskinlikli kayar nokta sayısı.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readInt | () | yöntem |
public function readInt():int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten işaretli bir 32 bit tam sayı okur.
Döndürürint — -2147483648 ile 2147483647 arasında bir değer.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readMultiByte | () | yöntem |
public function readMultiByte(length:uint, charSet:String):String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bayt akışından, belirtilen karakter kümesini kullanarak çok baytlı bir dize okur.
Parametreler
length:uint — Okunacak bayt akışından gelen bayt sayısı.
| |
charSet:String — Baytları yorumlamak için kullanılacak karakter kümesini gösteren dize. Olası karakter kümesi dizeleri "shift_jis" , "CN-GB" ve "iso-8859-1" şeklindedir. Tam liste için, bkz. Desteklenen Karakter Kümeleri.
Not: |
String — UTF-8 kodlu bir dize.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
|
readObject | () | yöntem |
public function readObject():*
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten AMF serileştirilmiş biçimde kodlanmış bir nesne okur.
Döndürür* — Serileştirilmemiş nesne.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
readShort | () | yöntem |
public function readShort():int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten işaretli bir 16 bit tam sayı okur.
Döndürürint — -32768 ile 32767 arasında bir değer.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readUnsignedByte | () | yöntem |
public function readUnsignedByte():uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten işaretsiz bir bayt okur.
Döndürüruint — 0 ile 255 arasında bir değer.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readUnsignedInt | () | yöntem |
public function readUnsignedInt():uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten işaretsiz bir 32 bit tam sayı okur.
Döndürüruint — 0 ile 4294967295 arasında bir değer.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readUnsignedShort | () | yöntem |
public function readUnsignedShort():uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten işaretsiz bir 16 bit tam sayı okur.
Döndürüruint — 0 ile 65535 arasında bir değer.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readUTF | () | yöntem |
public function readUTF():String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten bir UTF-8 dizesi okur. Dizenin önekinin uzunluğu bayt olarak gösteren işaretsiz bir kısa tam sayı olduğu varsayılır.
DöndürürString — Bir UTF-8 dizesi.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
readUTFBytes | () | yöntem |
public function readUTFBytes(length:uint):String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Soketten length
parametresinde belirtilen sayıda UTF-8 veri baytı okur ve bir dize döndürür.
Parametreler
length:uint — Okunacak bayt sayısı.
|
String — Bir UTF-8 dizesi.
|
Atar
EOFError — Okunacak yeterli miktarda veri mevcut değil.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
writeBoolean | () | yöntem |
public function writeBoolean(value:Boolean):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete bir Boolean değeri yazar. Bu yöntem 1 (true
) veya 0 (false
) değeriyle tek bir bayt yazar.
Parametreler
value:Boolean — Sokete yazılacak değer: 1 (true ) veya 0 (false ).
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeByte | () | yöntem |
public function writeByte(value:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete bir bayt yazar.
Parametreler
value:int — Sokete yazılacak veri. Değerin düşük 8 biti kullanılır; yüksek 24 bit yok sayılır.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeBytes | () | yöntem |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Belirtilen bayt dizisinden bir bayt sırası yazar. Yazma işlemi offset
tarafından belirtilen konumda başlar.
length
parametresini atlarsanız, varsayılan 0 uzunluğu, offset
öğesinden başlayarak tüm arabelleğin yazılmasına neden olur.
offset
parametresini de atlarsanız, tüm arabellek yazılır.
Parametreler
bytes:ByteArray — Yazılacak verilerin kaynağı olan ByteArray nesnesi.
| |
offset:uint (default = 0 ) — Veri yazma işleminin başlaması gereken bytes ByteArray nesnesine giden sıfır tabanlı uzaklık.
| |
length:uint (default = 0 ) — Yazılacak bayt sayısı. Varsayılan 0 değeri, offset parametresi tarafından belirtilen değerden başlayarak tüm arabelleğin yazılmasına neden olur.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
| |
RangeError — offset değeri bytes öğesinde belirtilen ByteArray öğesinin uzunluğundan daha büyükse veya offset ve length tarafından yazılacağı belirtilen veri miktarı mevcut veriyi aşıyorsa.
|
İlgili API Öğeleri
writeDouble | () | yöntem |
public function writeDouble(value:Number):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete IEEE 754 çift kesinlikli kayar nokta sayısı yazar.
Parametreler
value:Number — Sokete yazılacak veri.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeFloat | () | yöntem |
public function writeFloat(value:Number):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete IEEE 754 tek keskinlikli kayar nokta sayısı yazar.
Parametreler
value:Number — Sokete yazılacak veri.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeInt | () | yöntem |
public function writeInt(value:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete 32 bit işaretli tam sayı yazar.
Parametreler
value:int — Sokete yazılacak veri.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeMultiByte | () | yöntem |
public function writeMultiByte(value:String, charSet:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Belirtilen karakter kümesini kullanarak bayt akışından çok baytlı bir dize yazar.
Parametreler
value:String — Yazılacak dize değeri.
| |
charSet:String — Baytları yorumlamak için kullanılacak karakter kümesini gösteren dize. Olası karakter kümesi dizeleri "shift_jis" , "CN-GB" ve "iso-8859-1" şeklindedir. Tam liste için, bkz. Desteklenen Karakter Kümeleri.
|
İlgili API Öğeleri
writeObject | () | yöntem |
public function writeObject(object:*):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete AMF serileştirilmiş biçimde bir nesne yazar.
Parametreler
object:* — Serileştirilecek nesne.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeShort | () | yöntem |
public function writeShort(value:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete 16 bit tam sayı yazar. Yazılan baytlar şu şekildedir:
(v >> 8) & 0xff v & 0xff
Parametrenin düşük 16 biti kullanılır; yüksek 16 bit yok sayılır.
Parametreler
value:int — Sokete yazılacak veri.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeUnsignedInt | () | yöntem |
public function writeUnsignedInt(value:uint):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete 32 bit bir imzasız tam sayı yazar.
Parametreler
value:uint — Sokete yazılacak veri.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeUTF | () | yöntem |
public function writeUTF(value:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Şu verileri sokete yazar: belirtilen UTF-8 dizesinin uzunluğunu bayt cinsinden belirten 16 bit imzasız tam sayı ve ardından dizenin kendisi.
Dizeyi yazmadan önce, dizenin tüm karakterlerini temsil etmek için gerekli bayt sayısı yöntem tarafından hesaplanır.
Parametreler
value:String — Sokete yazılacak dize.
|
Atar
RangeError — Uzunluk 65535'ten büyüktür.
| |
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
writeUTFBytes | () | yöntem |
public function writeUTFBytes(value:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sokete bir UTF-8 dizesi yazar.
Parametreler
value:String — Sokete yazılacak dize.
|
Atar
IOError — Soket üzerinde bir G/Ç hatası oluştu veya soket açık değil.
|
İlgili API Öğeleri
close | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.CLOSE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sunucu, soket bağlantısını kapattığında gönderilir.
close
olayı yalnızca sunucu bağlantıyı kapattığında gönderilir; Socket.close()
yöntemini çağırdığınızda gönderilmez.
Event.CLOSE
sabiti, close
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Bağlantısı kapatılan nesne. |
connect | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.CONNECT
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir ağ bağlantısı kurulduğunda gönderilir.
Event.CONNECT
sabiti, connect
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Ağ bağlantısı kuran Socket veya XMLSocket nesnesi. |
ioError | Olay |
flash.events.IOErrorEvent
özellik IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir gönderme veya yükleme işleminin başarısız olmasına neden olan bir girdi/çıktı hatası ortaya çıktığında gönderilir.
ioError
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
errorID | Belirli bir hata mesajıyla ilişkili başvuru numarası (yalnızca AIR). |
target | Girdi/çıktı hatası yaşayan network nesnesi. |
text | Hata mesajı olarak gösterilecek metin. |
outputProgress | Olay |
flash.events.OutputProgressEvent
Bir soket yazma arabelleğinden ağ aktarım katmanına veri taşıdığında gönderilir
securityError | Olay |
flash.events.SecurityErrorEvent
özellik SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Socket.connect()
öğesine yapılan bir çağrı, çağıranın güvenlik sanal alanı tarafından yasaklanan bir sunucuya veya 1024'ten düşük numaralı bir bağlantı noktasına bağlanmaya çalışırsa ve böyle bir bağlantıya izin verecek bir soket ilke dosyası yoksa gönderilir.
Not: AIR uygulamasında, uygulama güvenlik sanal alanında çalışan içeriğin bir soket ilke dosyası olmadan herhangi bir sunucuya veya bağlantı noktası numarasına bağlanmasına izin verilir.
SecurityErrorEvent.SECURITY_ERROR
sabiti, securityError
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Güvenlik hatasını bildiren network nesnesi. |
text | Hata mesajı olarak gösterilecek metin. |
İlgili API Öğeleri
socketData | Olay |
flash.events.ProgressEvent
özellik ProgressEvent.type =
flash.events.ProgressEvent.SOCKET_DATA
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir soket tarafından veri alındığında gönderilir.
Soket tarafından alınan veriler okunana kadar sokette kalır. Bu olayın işleyicisi sırasında mevcut tüm verileri okumanıza gerek yoktur.
socketData
türündeki olaylar ProgressEvent.bytesTotal
özelliğini kullanmaz.
socketData
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Event öğesini etkin olarak işleyen nesne. |
bytesLoaded | Dinleyici olayı işlerken yüklenen öğe veya bayt sayısı. |
bytesTotal | 0; bu özellik socketData olay nesneleri tarafından kullanılmaz. |
target | İlerlemeyi bildiren soket. |
- Yapıcı
socket
adlı birCustomSocket
örneği oluşturur velocalhost
ana bilgisayar adını ve bağlantı noktası 80'i argüman olarak iletir.CustomSocket
, Socket öğesini genişlettiğinden,super()
öğesine yapılan bir çağrı, Socket'in yapıcısını çağırır. - Daha sonra örnek, Socket olayları için dinleyiciler ekleyen
configureListeners()
yöntemini çağırır. - Son olarak,
localhost
ana bilgisayar adıyla ve 80 bağlantı noktası numarasıyla soketconnect()
yöntemi çağrılır.
Not: Örneği çalıştırmak için, SWF dosyasının bulunduğu etki alanıyla aynı etki alanında çalışan (örnekte, localhost
) ve 80 numaralı bağlantı noktasını dinleyen bir sunucuya ihtiyacınız vardır.
package { import flash.display.Sprite; public class SocketExample extends Sprite { private var socket:CustomSocket; public function SocketExample() { socket = new CustomSocket("localhost", 80); } } } import flash.errors.*; import flash.events.*; import flash.net.Socket; class CustomSocket extends Socket { private var response:String; public function CustomSocket(host:String = null, port:uint = 0) { super(); configureListeners(); if (host && port) { super.connect(host, port); } } private function configureListeners():void { addEventListener(Event.CLOSE, closeHandler); addEventListener(Event.CONNECT, connectHandler); addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); addEventListener(ProgressEvent.SOCKET_DATA, socketDataHandler); } private function writeln(str:String):void { str += "\n"; try { writeUTFBytes(str); } catch(e:IOError) { trace(e); } } private function sendRequest():void { trace("sendRequest"); response = ""; writeln("GET /"); flush(); } private function readResponse():void { var str:String = readUTFBytes(bytesAvailable); response += str; } private function closeHandler(event:Event):void { trace("closeHandler: " + event); trace(response.toString()); } private function connectHandler(event:Event):void { trace("connectHandler: " + event); sendRequest(); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function socketDataHandler(event:ProgressEvent):void { trace("socketDataHandler: " + event); readResponse(); } }
Tue Jun 12 2018, 01:09 PM Z