LocalConnection  - AS3

Üzerinde geri çağırma yöntemlerinin çağrıldığı nesneyi gösterir. Varsayılan nesne this öğesidir, başka bir deyişle, oluşturulan yerel bağlantıdır. client özelliğini başka bir nesneye ayarlayabilirsiniz. Bu durumda geri çağırma yöntemleri o nesne üzerinde çağrılır.

Geçerli dosyasının konumunun etki alanını temsil eden bir dize.

Adobe AIR'de application güvenlik sanal alanında çalışan içerikte (AIR uygulamasıyla yüklenen içerik), çalışma zamanı, üst etki alanı yerine, ardından AIR uygulamasına ilişkin uygulama kimliği gelen app# dizesini kullanır (uygulama açıklayıcı dosyasında tanımlanan). Örneğin, com.example.air.MyApp connectionName uygulama kimliğine sahip bir uygulama için connectionName, "app#com.example.air.MyApp:connectionName" olarak çözülür.

Flash Player 9 veya sonrası için yayınlanmış SWF dosyalarında, döndürülen dize, alt etki alanları da dahil olmak üzere geçerli dosyanın tam etki alanıdır. Örneğin, www.adobe.com konumundaysa, bu komut "www.adobe.com" öğesini döndürür.

Geçerli dosya, Flash Player'da çalışan istemci bilgisayarda bulunan bir yerel dosyaysa, bu komut "localhost" öğesini döndürür.

Bu özelliği kullanmanın en yaygın yolları, gönderen LocalConnection nesnesinin etki alanı adını, alıcı LocalConnection nesnesinde çağırmak istediğiniz yönteme bir parametre olarak dahil etmek veya belirtilen etki alanından komutlar almak üzere LocalConnection.allowDomain() öğesiyle birlikte kullanmaktır. Yalnızca aynı etki alanında bulunan LocalConnection nesneleri arasında iletişim kuruyorsanız, büyük olasılıkla bu özelliği kullanmanız gerekmez.

İlgili API Öğeleri

LocalConnection nesnesinin kapsamının geçerli kullanıcıyla sınırlı mı olduğunu (true) yoksa bilgisayardaki tüm kullanıcılara global olarak erişilebilir mi olduğunu (false) belirtir. Bu özellik yalnızca Mac OS X'te çalışan içeriği etkiler; diğer platformlar bu parametreyi yoksayar. Windows ve Linux işletim sistemlerindeki bağlantılar her zaman kullanıcıya göredir.

Flash Player 10.0.22 ve önceki sürümlerinde ve AIR 1.5.1 ve önceki sürümlerinde, Mac OS'deki tüm LocalConnection nesnelerinin global kapsamı vardır. Önceki sürümlerle uyumluluğu korumanız gerekmiyorsa, bu özelliği her zaman true değerine ayarlayın. Gelecekteki sürümlerde, bu özelliğin varsayılan değeri true olarak değişebilir.

Varsayılan değer şudur false.

isSupported özelliği, LocalConnection sınıfı geçerli platformda destekleniyorsa true olarak, aksi halde false olarak ayarlanır.

LocalConnection nesnesi oluşturur. Aynı istemci bilgisayar üzerinde çalışan farklı dosyaları arasında iletişim sağlamak için LocalConnection nesnesini kullanabilirsiniz.

İlgili API Öğeleri

Bu LocalConnection örneğine LocalConnection çağrıları gönderebilen bir veya daha fazla etki alanını belirtir.

Barındırılan dosyalarının, güvenli bir protokol (HTTPS) kullanarak, güvenli olmayan protokollerde barındırılan dosyalarından erişime izin vermesi için bu yöntemi kullanamazsınız; bunun yerine allowInsecureDomain() yöntemini kullanabilirsiniz.

Alt dosyasının geleceği son etki alanını bilmeden, farklı bir etki alanından gelen bir alt dosyasının üst dosyasına LocalConnection çağrıları yapabilmesi için bu yöntemi kullanabilirsiniz. Örneğin yük dengeleyen yönlendirmeler veya üçüncü taraf sunucular kullandığınızda bu durum oluşabilir. Bu durumda, allowDomain() yöntemi ile birlikte kullanılacak etki alanını almak için load işlemi ile birlikte kullanılan LoaderInfo nesnesinin url özelliğini kullanabilirsiniz. Örneğin bir alt dosyası yüklemek için bir Loader nesnesi kullanıyorsanız, Loader nesnesinin contentLoaderInfo.url özelliğini kontrol edebilir ve etki alanını tam URL dizesinden ayrıştırabilirsiniz. Bu durumda, dosya yüklenene kadar contentLoaderInfo.url özelliği son ve doğru değere sahip olmayacağından, dosyası yüklenene kadar beklediğinizden emin olun.

Bu durumun tam aksi de meydana gelebilir: üst öğesinden gelen LocalConnection çağrılarını kabul etmek isteyen, ancak üst öğesinin etki alanını bilmeyen bir alt dosyası oluşturmak istediğinizde meydana gelebilir. Bu durumda, etki alanı argümanının yüklenmiş dosyasının loaderInfo.url özelliğinin etki alanıyla eşleşip eşleşmediğini kontrol ederek bu yöntemi uygulayın. Etki alanını loaderInfo.url öğesinden gelen tam URL'den yine ayrıştırmalısınız. Bu durumda üst dosyasının yüklenmesini beklemek zorunda değilsiniz; alt öğe yüklenene kadar üst SWF dosyası zaten yüklenmiş olur.

Bu yöntemi kullanırken Flash Player güvenlik modelini göz önünde bulundurun: Varsayılan olarak, bir LocalConnection nesnesi kendisini oluşturan dosyasının sanal alanıyla ilişkilidir ve LocalConnection nesnelerine yapılan etki alanları arası çağrılara, alıcı dosyasında LocalConnection.allowDomain() yöntemi çağrılmazsa izin verilmez. Ancak Adobe AIR'de, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Not: allowDomain() yönteminin biçimi, ActionScript 1.0 ve 2.0'da sahip olduğundan farklıdır. Önceki bu sürümlerde allowDomain, uygulamış olduğunuz bir geri çağrı yöntemiydi. ActionScript 3.0'da, allowDomain() çağırdığınız LocalConnection öğesinin yerleşik bir yöntemidir. Bu değişikliğin yapılmasıyla, allowDomain() öğesi, flash.system.Security.allowDomain() öğesine benzer şekilde çalışır.

Parametreler

İlgili API Öğeleri

Bu LocalConnection nesnesine LocalConnection çağrıları gönderebilen bir veya daha fazla etki alanını belirtir.

allowInsecureDomain() yöntemi, allowInsecureDomain() yönteminin ek olarak HTTPS olmayan kaynaklardan gelen dosyalarının, HTTPS kaynaklı SWF dosyalarına LocalConnection çağrıları göndermesi dışında allowDomain() yöntemine çok benzer. Yalnızca HTTPS kullanılarak yüklenmiş dosyasından allowInsecureDomain() yöntemini çağırmanız durumunda bu fark anlam kazanır. Aynı etki alanı içerisindeki HTTPS olmayan/HTTPS sınırını geçseniz de allowInsecureDomain() öğesini çağırmalısınız; varsayılan olarak, aynı etki alanında olsalar da LocalConnection çağrılarının asla HTTPS olmayan dosyalarından HTTPS dosyalarına gitmesine izin verilmez.

HTTPS tarafından sunulan güvenliği tehlikeye atabileceğinden, allowInsecureDomain() yönteminin çağrılması önerilmez. HTTPS üzerinden bir dosya yüklediğinizde, ağ üzerinden teslim işlemi sırasında dosyaya müdahale edilmeyeceğinden emin olmalısınız. Daha sonra, HTTPS dosyasına LocalConnection çağrıları yapmak için bir HTTPS olmayan dosyasına izin verirseniz, teslim işlemi sırasında müdahale edilmiş bir dosyasından çağrı alıyor olabilirsiniz. HTTPS dosyanıza gelen LocalConnection çağrılarının gerçekliğine güvenemeyeceğiniz için bu işlem genellikle fazladan dikkat gerektirir.

Varsayılan olarak, HTTPS protokolünü kullanarak barındırılan dosyalara, yalnızca HTTPS protokolü kullanılarak barındırılan diğer dosyalar tarafından erişilebilir. Bu uygulama, HTTPS protokolü tarafından sağlanan bütünlüğü korur.

HTTPS güvenliğini tehlikeye attığından, varsayılan davranışı geçersiz kılmak için bu yöntemin kullanılması önerilmez. Ancak, örneğin Flash Player 6 veya daha öncesi için yayınlanmış HTTP SWF dosyalarından Flash Player 9 veya sonrası tarafından yayınlanmış HTTPS SWF dosyalarına erişime izin vermeniz gerekiyorsa, bu işlemi yapmanıza gerek kalmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

İlgili API Öğeleri

Bir LocalConnection nesnesini kapatır (bağlantısını keser). Nesnenin artık komutları almasını istemiyorsanız, örneğin başka bir SWF dosyasında aynı connectionName parametresini kullanarak bir connect() komutu vermek istediğinizde bu komutu verin.

İlgili API Öğeleri

Bir send () komutu tarafından (gönderen LocalConnection nesnesi tarafından) gönderilen komutları almak için bir LocalConnection nesnesi hazırlar. connect() yöntemiyle kullanılan nesne receiving LocalConnection object olarak adlandırılır. Alıcı ve gönderen nesneler aynı istemci bilgisayarında çalışıyor olmalıdır.

Yarış koşulunu önlemek için, bu yöntemi çağırmadan önce LocalConnection nesnesine ekli yöntemleri, LocalConnection sınıfı örneğinde gösterildiği şekilde tanımlayın.

Varsayılan olarak, superdomain öğesi connect() komutunu içeren dosyanın üst etki alanı olduğunda, connectionName argümanı " superdomain :connectionName" olarak çözülür. Örneğin, alıcı LocalConnection nesneyi içeren dosyası www.someDomain.com konumundaysa, connectionName öğesi "someDomain.com:connectionName" olarak çözülür. (Flash Player'da çalışan bir dosya istemci bilgisayarındaysa, superdomain öğesine iletilen değer "localhost" olur.)

Adobe AIR'de application güvenlik sanal alanında çalışan içerikte (AIR uygulamasıyla yüklenen içerik), çalışma zamanı, üst etki alanı yerine, ardından AIR uygulamasına ilişkin uygulama kimliği gelen app# dizesini kullanır (uygulama açıklayıcı dosyasında tanımlanan). Örneğin, com.example.air.MyApp connectionName uygulama kimliğine sahip bir uygulama için connectionName, "app#com.example.air.MyApp:connectionName" olarak çözülür.

Ayrıca varsayılan olarak, Flash Player alıcı LocalConnection nesnesinin yalnızca bağlantı adı "superdomain:connectionName" değerine çözülen gönderen LocalConnection nesnelerinden komut almasına izin verir. Böylece Flash Player aynı etki alanında bulunan dosyaların birbirleriyle iletişim kurmasını kolaylaştırır.

Yalnızca aynı etki alanları arasındaki dosyaları arasında iletişim kuruyorsanız, connectionName öğesi için alt çizgiyle (_) başlamayan ve bir etki alanı adı belirtmeyen (örneğin "myDomain:connectionName") bir dize belirleyin. connect(connectionName) yöntemindekiyle aynı dizeyi kullanın.

Farklı etki alanlarındaki dosyaları arasında iletişim kuruyorsanız, connectionName için alt çizgiyle (_) başlayan bir dize adının belirtilmesi, alıcı LocalConnection nesnesine sahip dosyasının etki alanları arasındaki taşınabilirliğini artırır. İki olası neden şu şekildedir:

• connectionName öğesine yönelik dize alt çizgiyle (_) başlamıyorsa, üst etki alanı ve virgül bulunmayan bir önek eklenir (örneğin "myDomain:connectionName"). Bu işlem, bağlantınızın başka etki alanlarından gelen aynı ada sahip bağlantılarla çakışmamasını sağlasa da tüm gönderen LocalConnection nesneleri bu üst etki alanını belirtmelidir (örneğin, "myDomain:connectionName"). Alıcı LocalConnection nesnesine sahip dosyası başka bir etki alanına taşınırsa, player öneki yeni üst etki alanını gösterecek şekilde değiştirir (örneğin "anotherDomain:connectionName"). Tüm gönderen LocalConnection nesneleri yeni üst etki alanını gösterecek şekilde elle düzenlenebilir.
• connectionName öğesine ilişkin dize alt çizgiyle başlıyorsa (örneğin, "_connectionName"), dizeye önek eklenmez. Bu durum LocalConnection nesnelerinin connectionName için benzer dizeler kullandığını gösterir. Alıcı nesne herhangi bir etki alanından gelen bağlantıların kabul edileceğini belirtmek için allowDomain() öğesini kullanıyorsa, alıcı LocalConnection nesnesine sahip dosya, herhangi bir gönderen LocalConnection nesnesini değiştirmeden başka bir etki alanına taşınabilir.

Daha fazla bilgi için sınıfa genel bakıştaki açıklamalara ve send() öğesindeki connectionName hakkındaki açıklamalara ve ayrıca allowDomain() ve domain girişlerine bakın.

Not: Virgüller, üst etki alanını connectionName dizesinden ayırmak için özel karakterler olarak kullanılır. Virgül içeren connectionName öğesine yönelik bir dize geçerli değildir.

Bu yöntemi kullanırken Flash Player güvenlik modelini göz önünde bulundurun. Varsayılan olarak, bir LocalConnection nesnesi kendisini oluşturan dosyasının sanal alanıyla ilişkilidir ve LocalConnection nesnelerine yapılan etki alanları arası çağrılara, alıcı dosyasında LocalConnection.allowDomain() yöntemi çağrılmazsa izin verilmez. 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. Ancak Adobe AIR'de, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

İlgili API Öğeleri

connect(connectionName) yöntemiyle (alan LocalConnection nesnesinde) açılan bir bağlantıda methodName adlı yöntemi çağırır. send() yöntemiyle kullanılan nesne sending LocalConnection object olarak adlandırılır. Gönderen ve alıcı nesneleri içeren SWF dosyaları aynı istemci bilgisayar üzerinde çalışıyor olmalıdır.

Bu komuta parametre olarak iletebileceğiniz veri miktarı sınırı 40 kilobayttır. send() öğesi bir ArgumentError atarsa ancak sözdiziminiz doğruysa, send() isteklerini, her biri 40K'tan az veri içerecek şekilde bölmeyi deneyin.

connect() girişinde tartışıldığı gibi, geçerli üst etki alanı varsayılan olarak connectionName öğesine eklenir. Farklı etki alanları arasında iletişim kuruyorsanız, gönderen ve alıcı LocalConnection nesnelerinde, üst etki alanının connectionName öğesine eklenmeyeceği şekilde connectionName öğesini tanımlayın. Bu işlemi şu iki yöntemden birini kullanarak gerçekleştirebilirsiniz:

• Gönderen ve alıcı LocalConnection nesnelerinde connectionName öğesinin başlangıcında bir alt çizgi (_) kullanın. Alıcı nesneyi içeren dosyasında herhangi bir etki alanından gelen bağlantıların kabul edileceğini belirtmek için LocalConnection.allowDomain() öğesini kullanın. Bu uygulama gönderen ve alıcı dosyalarınızı herhangi bir etki alanında saklamanızı sağlar.
• Üst etki alanını gönderen LocalConnection nesnesindekiconnectionName öğesine ekleyin; örneğin, myDomain.com:myConnectionName. Alıcı nesnede, belirtilen üst etki alanından gelen bağlantıların kabul edileceğini (bu durumda, myDomain.com) veya herhangi bir etki alanından gelen bağlantıların kabul edileceğini belirlemek için LocalConnection.allowDomain() öğesini kullanın.

Not: Alıcı LocalConnection nesnesindeki connectionName öğesinde bir üst etki alanı belirtemezsiniz (bu işlemi yalnızca LocalConnection nesnesinde gerçekleştirebilirsiniz).

Bu yöntemi kullanırken Flash Player güvenlik modelini göz önünde bulundurun. Varsayılan olarak, bir LocalConnection nesnesi kendisini oluşturan dosyasının sanal alanıyla ilişkilidir ve LocalConnection nesnelerine yapılan etki alanları arası çağrılara, alıcı dosyasında LocalConnection.allowDomain() yöntemi çağrılmazsa izin verilmez. Tarayıcıda çalışan SWF içeriği için, SWF içeriğini içeren HTML sayfasındaki object ve embed etiketlerinin allowNetworking parametresini ayarlayarak, bir dosyanın bu yöntemi kullanmasını engelleyebilirsiniz. Ancak Adobe AIR'de, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

İlgili API Öğeleri

Eşzamansız olarak, yani yerel eşzamansız koddan bir istisna atıldığında gönderilir.

Bu olay şu özelliklere sahiptir:

LocalConnection.send() öğesine yapılan bir çağrı farklı bir güvenlik sanal alanına veri gönderme girişiminde bulunduğunda gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir LocalConnection nesnesi durumunu bildirdiğinde gönderilir. LocalConnection.send() başarılı olursa, status olay nesnesinin level özelliğinin değeri "status" olur; çağrı başarısız olursa level özelliği"error" olur. Alıcı dosyası bağlantıyı reddederse, çağrı, gönderen dosyasına bildirim yapılmadan başarısız olabilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

LocalConnectionSenderExample SWF dosyasında, bir LocalConnection örneği oluşturulur ve düğmeye basıldığında "myConnection" bağlantı adına sahip SWF dosyasında lcHandler adlı yöntemi çağırmak için call() yöntemi kullanılır ve TextField öğesinin içeriği bir parametre olarak iletilir.

LocalConnectionReceiverExample SWF dosyasında bir LocalConnection örneği oluşturulur ve bu SWF dosyasını, "myConnection" adlı bağlantıya yönlendirilen mesajların alıcısı olarak belirlemek için connect() yöntemi kullanılır. Ayrıca, bu sınıfa lcHandler() adlı genel bir yöntem dahildir; bu yöntem LocalConnectionSenderExample SWF dosyası tarafından çağrılan yöntemdir. Bu yöntem çağrıldığında, bir parametre olarak iletilen metin Sahne Alanı üzerinde TextField öğesine eklenir.

Not: Örneği test etmek için, her iki SWF dosyası da aynı anda aynı bilgisayara yüklenmelidir.

// Code in LocalConnectionSenderExample.as
package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.net.LocalConnection;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.events.StatusEvent;
    import flash.text.TextFieldAutoSize;

    public class LocalConnectionSenderExample extends Sprite {
        private var conn:LocalConnection;
        
        // UI elements
        private var messageLabel:TextField;
        private var message:TextField;
        private var sendBtn:Sprite;
        
        public function LocalConnectionSenderExample() {
            buildUI();
            sendBtn.addEventListener(MouseEvent.CLICK, sendMessage);
            conn = new LocalConnection();
            conn.addEventListener(StatusEvent.STATUS, onStatus);
        }
        
        private function sendMessage(event:MouseEvent):void {
            conn.send("myConnection", "lcHandler", message.text);
        }
        
        private function onStatus(event:StatusEvent):void {
            switch (event.level) {
                case "status":
                    trace("LocalConnection.send() succeeded");
                    break;
                case "error":
                    trace("LocalConnection.send() failed");
                    break;
            }
        }
        
        private function buildUI():void {
            const hPadding:uint = 5;
            // messageLabel
            messageLabel = new TextField();
            messageLabel.x = 10;
            messageLabel.y = 10;
            messageLabel.text = "Text to send:";
            messageLabel.autoSize = TextFieldAutoSize.LEFT;
            addChild(messageLabel);
            
            // message
            message = new TextField();
            message.x = messageLabel.x + messageLabel.width + hPadding;
            message.y = 10;
            message.width = 120;
            message.height = 20;
            message.background = true;
            message.border = true;
            message.type = TextFieldType.INPUT;
            addChild(message);
            
            // sendBtn
            sendBtn = new Sprite();
            sendBtn.x = message.x + message.width + hPadding;
            sendBtn.y = 10;
            var sendLbl:TextField = new TextField();
            sendLbl.x = 1 + hPadding;
            sendLbl.y = 1;
            sendLbl.selectable = false;
            sendLbl.autoSize = TextFieldAutoSize.LEFT;
            sendLbl.text = "Send";
            sendBtn.addChild(sendLbl);
            sendBtn.graphics.lineStyle(1);
            sendBtn.graphics.beginFill(0xcccccc);
            sendBtn.graphics.drawRoundRect(0, 0, (sendLbl.width + 2 + hPadding + hPadding), (sendLbl.height + 2), 5, 5);
            sendBtn.graphics.endFill();
            addChild(sendBtn);
        }
    }
}