LocalConnection  - AS3

Geeft het object aan waarop callback-methoden worden aangeroepen. Het standaardobject is this, de lokale verbinding die wordt gemaakt. U kunt de eigenschap client instellen op een ander object, waardoor callback-methoden voor dat object worden aangeroepen.

Een tekenreeks die het domein van de locatie van het huidige bestand vertegenwoordigt.

Als inhoud die in de application-beveiligingssandbox in Adobe AIR wordt uitgevoerd (inhoud die met de AIR-toepassing is geïnstalleerd), gebruikt de runtime de tekenreeks app#, gevolgd door de toepassings-id voor de AIR-toepassing (opgegeven in het descriptorbestand van de toepassing), in plaats van het superdomein. Een connectionName voor een toepassing met de toepassings-id com.example.air.MyApp connectionName wordt bijvoorbeeld omgezet naar "app#com.example.air.MyApp:connectionName".

In SWF-bestanden die voor Flash Player 9 of hoger worden gepubliceerd, is de geretourneerde tekenreeks het exacte domein van het bestand, subdomeinen inbegrepen. Wanneer het bestand zich bijvoorbeeld op www.adobe.com bevindt, retourneert deze opdracht "www.adobe.com".

Wanneer het huidige bestand een lokaal bestand is op de clientcomputer en in Flash Player wordt uitgevoerd, retourneert deze opdracht "localhost".

De manier waarop deze eigenschap doorgaans wordt gebruikt, is het opnemen van de domeinnaam van het verzendende object LocalConnection als een parameter voor de methode die u in het ontvangende object LocalConnection wilt aanroepen. U kunt de eigenschap ook gebruiken in combinatie met LocalConnection.allowDomain() om opdrachten uit een opgegeven domein te accepteren. Wanneer u alleen communicatie toestaat tussen objecten LocalConnection die zich in hetzelfde domein bevinden, hoeft u deze eigenschap waarschijnlijk niet te gebruiken.

Verwante API-elementen

Geeft aan of het LocalConnection-object binnen het bereik van de huidige gebruiker is geplaatst (True) of algemeen beschikbaar voor alle gebruikers op de computer (False). Deze eigenschap is alleen van invloed op inhoud die op de Mac OS X wordt uitgevoerd; deze parameter wordt genegeerd op andere platforms. Verbindingen bij Windows- en Linux-besturingssystemen zijn altijd per gebruiker.

Bij Flash Player 10.0.22 en lager en bij AIR 1.5.1 en lager hebben alle LocalConnection-objecten op de Mac OS X een globaal bereik. Deze eigenschap moet altijd zijn ingesteld op True, tenzij u de compatibiliteit met eerder versies wilt behouden. Bij toekomstige releases kan de standaardwaarde van deze eigenschap worden gewijzigd in True.

De standaardwaarde is false.

De eigenschap isSupported wordt ingesteld op true als de LocalConnection-klasse op het huidige platform wordt ondersteund. Als dit niet het geval is, wordt de eigenschap ingesteld op false.

Maakt een object LocalConnection. U kunt LocalConnection-objecten gebruiken om communicatie mogelijk te maken tussen verschillende bestanden die op dezelfde clientcomputer worden uitgevoerd.

Verwante API-elementen

Geeft een of meer domeinen op die aanroepen van LocalConnection naar deze instantie LocalConnection kunnen verzenden.

U kunt deze methode niet gebruiken om bestanden die worden aangeboden via een beveiligd protocol (HTTPS) toegang te laten bieden vanuit bestanden die via niet-beveiligde protocollen worden aangeboden. In plaats daarvan moet u de methode allowInsecureDomain() gebruiken.

Mogelijk wilt u deze methode gebruiken zodat een onderliggend bestand uit een ander domein LocalConnection-aanroepen kan uitvoeren naar het bovenliggende bestand, zonder het uiteindelijke domein te kennen waaruit het onderliggende bestand afkomstig is. Dit kan bijvoorbeeld het geval zijn wanneer u taakverdelende omleidingen of servers van derden gebruikt. U kunt dan de eigenschap url gebruiken van het object LoaderInfo dat voor het laden werd gebruikt, om het domein op te halen dat met de methode allowDomain() moet worden gebruikt. Wanneer u bijvoorbeeld een Loader-object gebruikt om een onderliggend bestand te laden, kunt u nadat het bestand is geladen de eigenschap contentLoaderInfo.url van het Loader-object controleren en het domein parseren uit de volledige URL. Wanneer u dit doet, moet u wachten totdat het bestand is geladen omdat de eigenschap contentLoaderInfo.url pas de uiteindelijke correcte waarde heeft nadat het bestand volledig is geladen.

De tegenovergestelde situatie kan zich ook voordoen: u zou een onderliggend bestand kunnen maken dat LocalConnection-aanroepen vanuit het bovenliggende bestand accepteert zonder het domein van het bovenliggende bestand te kennen. In dit geval implementeert u deze methode door te controleren of het argument van het domein overeenkomt met het domein van de eigenschap loaderInfo.url in het geladen bestand. Vervolgens parseert u het domein uit de volledige URL in loaderInfo.url. U hoeft dan niet te wachten totdat het bovenliggende bestand is geladen. Het bovenliggende bestand is immers al geladen tegen de tijd dat het onderliggende bestand wordt geladen.

Houd rekening met het beveiligingsmodel van Flash Player wanneer u deze methode gebruikt. Een object LocalConnection wordt standaard gekoppeld aan de sandbox van het SWF-bestand dat dit heeft gemaakt en interdomeinaanroepen naar objecten LocalConnection zijn niet toegestaan, tenzij u de methode LocalConnection.allowDomain() in het ontvangende bestand aanroept. In Adobe AIR is de inhoud in de application -beveiligingssandbox (inhoud die met de AIR-toepassing is geïnstalleerd), echter niet beperkt tot deze beveiligingsbeperkingen.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

Opmerking: de methode allowDomain() heeft een andere vorm dan in ActionScript 1.0 en 2.0. In die lagere versies was allowDomain een callback-methode die u moest implementeren. In ActionScript 3.0 is allowDomain() een ingebouwde methode van LocalConnection die u aanroept. Door deze wijziging werkt allowDomain() nagenoeg hetzelfde als flash.system.Security.allowDomain().

Parameters

Verwante API-elementen

Geeft een of meer domeinen op die aanroepen van LocalConnection naar dit object LocalConnection kunnen verzenden.

De methode allowInsecureDomain() werkt hetzelfde als de methode allowDomain(), met dit verschil dat met de methode allowInsecureDomain() SWF-bestanden van niet-HTTPS-oorsprong ook LocalConnection-aanroepen kunnen verzenden naar bestanden van HTTPS-oorsprong. Dit verschil is alleen van belang wanneer u de methode allowInsecureDomain() aanroept vanuit een bestand dat is geladen met behulp van HTTPS. U moet de methode allowInsecureDomain() zelfs aanroepen wanneer u een niet-HTTPS/HTTPS-grens binnen hetzelfde domein overschrijdt. Standaard zijn LocalConnection-aanroepen vanuit niet-HTTPS bestanden naar HTTPS bestanden niet toegestaan, ook niet binnen hetzelfde domein.

Het aanroepen van allowInsecureDomain() wordt niet aanbevolen, omdat het de door het HTTPS-protocol geboden beveiliging in gevaar kan brengen. Wanneer u een SWF-bestand via HTTPS laadt, kunt u er tamelijk zeker van zijn dat er met dit bestand niet is geknoeid tijdens verzending via het netwerk. Wanneer u vervolgens een niet-HTTPS bestand de mogelijkheid biedt LocalConnection-aanroepen uit te voeren naar het HTTPS bestand, accepteert u aanroepen vanuit een bestand waarmee tijdens verzending over het netwerk geknoeid kan zijn. Daardoor is extra voorzichtigheid geboden omdat u niet kunt vertrouwen op de authenticiteit van LocalConnection-aanroepen die binnenkomen in uw HTTPS bestand.

Bestanden die via het HTTPS-protocol worden aangeboden, zijn standaard alleen toegankelijk voor andere bestanden die via het HTTPS-protocol worden aangeboden. Deze implementatie handhaaft de integriteit die door het HTTPS-protocol wordt geboden.

Het wordt niet aangeraden deze methode te gebruiken om de standaardwerking te negeren, omdat dit de HTTPS-beveiliging in gevaar brengt. Dit kan echter noodzakelijk zijn wanneer u bijvoorbeeld toegang moet bieden tot HTTPS-SWF-bestanden die voor Flash Player 9 of hoger zijn gepubliceerd vanuit HTTP-SWF-bestanden die voor Flash Player 6 zijn gepubliceerd.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

Parameters

Verwante API-elementen

Sluit een object LocalConnection (verbreekt de verbinding). Geef deze opdracht door wanneer u niet wilt dat het object nog opdrachten accepteert, bijvoorbeeld wanneer u een opdracht connect() wilt laten uitvoeren met gebruik van dezelfde parameter connectionName in een ander SWF-bestand.

Verwante API-elementen

Bereidt een object LocalConnection voor om opdrachten te ontvangen van opdrachten die vanaf een send()-opdracht worden verstuurd (het verzendende LocalConnection-object). Het object dat met de connect()-methode wordt gebruikt, heet het ontvangende object LocalConnection. De ontvangende en verzendende objecten moeten op dezelfde clientcomputer worden uitgevoerd.

Om conflictsituaties te vermijden, definieert u de methoden die zijn gekoppeld aan het ontvangende object LocalConnection voordat u deze methode aanroept, zoals getoond in het voorbeeld van de klasse LocalConnection.

Standaard wordt connectionName omgezet in de waarde "superdomain:connectionName", waarbij superdomain het superdomein is van het bestand dat de opdracht connect() bevat. Als het bestand dat het ontvangende LocalConnection-object bevat zich bijvoorbeeld op www.someDomain.com bevindt, wordt connectionName omgezet in "someDomain.com:connectionName". (Als een bestand dat in Flash Player wordt uitgevoerd, zich op de clientcomputer bevindt, is "localhost" de waarde die aan superdomain wordt toegewezen.)

Als inhoud die in de application-beveiligingssandbox in Adobe AIR wordt uitgevoerd (inhoud die met de AIR-toepassing is geïnstalleerd), gebruikt de runtime de tekenreeks app#, gevolgd door de toepassings-id voor de AIR-toepassing (opgegeven in het descriptorbestand van de toepassing), in plaats van het superdomein. Een connectionName voor een toepassing met de toepassings-id com.example.air.MyApp connectionName wordt bijvoorbeeld omgezet naar "app#com.example.air.MyApp:connectionName".

Standaard laat Flash Player het ontvangende object LocalConnection alleen opdrachten ontvangen van het verzendende object LocalConnection waarvan de naam van de verbinding ook in de waarde "superdomain:connectionName" wordt omgezet. Op die manier vereenvoudigt Flash Player de onderlinge communicatie tussen bestanden die zich in hetzelfde domein bevinden.

Wanneer u alleen communicatie implementeert tussen bestanden in hetzelfde domein, geeft u een tekenreeks op voor connectionName die niet met een onderstreepteken (_) begint en die geen domeinnaam opgeeft (bijvoorbeeld "myDomain:connectionName"). Gebruik dezelfde tekenreeks in de methode connect(connectionName).

Wanneer u communicatie implementeert tussen bestanden in verschillende domeinen, zorgt het opgeven van een tekenreeks voor connectionName die begint met een onderstreepteken (_) ervoor dat het bestand met het ontvangende object LocalConnection gemakkelijker overdraagbaar is tussen domeinen. Hier volgen twee mogelijke scenario's:

• Wanneer de tekenreeks voor connectionName niet met een onderstreepsteken (_) begint, wordt aan het superdomein een voorvoegsel plus dubbele punt toegevoegd (bijvoorbeeld "myDomain:connectionName"). Hoewel dit ervoor zorgt dat geen conflicten optreden tussen de verbinding en andere verbindingen met dezelfde naam in een ander domein, moet elk verzendend object LocalConnection dit superdomein opgeven (bijvoorbeeld "myDomain:connectionName"). Wanneer het bestand met het ontvangende object LocalConnection naar een ander domein wordt verplaatst, wijzigt de speler het voorvoegsel zodat dit het nieuwe superdomein weerspiegelt (bijvoorbeeld "anotherDomain:connectionName"). Alle verzendende objecten LocalConnection moeten handmatig worden bewerkt om naar het nieuwe superdomein te wijzen.
• Als de tekenreeks voor connectionName met een onderstreepteken begint (bijvoorbeeld "_connectionName"), wordt geen voorvoegsel aan de tekenreeks toegevoegd. Dit houdt in dat de ontvangende en verzendende objecten LocalConnection identieke tekenreeksen gebruiken voor connectionName. Wanneer het ontvangende object gebruikmaakt van allowDomain() om op te geven dat verbindingen van elk domein worden geaccepteerd, kan het bestand met het ontvangende object LocalConnection naar een ander domein worden verplaatst zonder dat verzendende objecten LocalConnection hoeven te worden gewijzigd.

Zie de beschrijving in het klasse-overzicht en de beschrijving van connectionName in send() en de items allowDomain() en domain voor meer informatie.

Opmerking: dubbele punten worden gebruikt als speciale tekens om het superdomein van de tekenreeks connectionName te scheiden. Een tekenreeks voor connectionName die een dubbele punt bevat, is niet geldig.

Houd bij gebruik van deze methode rekening met het beveiligingsmodel van Flash Player. Een object LocalConnection wordt standaard gekoppeld aan de sandbox van het SWF-bestand dat dit heeft gemaakt en interdomeinaanroepen naar objecten LocalConnection zijn niet toegestaan, tenzij u de methode LocalConnection.allowDomain() in het ontvangende bestand aanroept. U kunt voorkomen dat een bestand deze methode gebruikt door de parameter allowNetworking in te stellen van de tags object en embed op de HTML-pagina die de SWF-inhoud bevat.In Adobe AIR is de inhoud in de application-beveiligingssandbox (inhoud die met de AIR-toepassing is geïnstalleerd), echter niet beperkt tot deze beveiligingsbeperkingen.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

Parameters

Verwante API-elementen

Roept de methode methodName aan via een verbinding die met de methode connect(connectionName) is geopend (in het ontvangende object LocalConnection). Het object dat met de send()-methode wordt gebruikt, heet het versturende object LocalConnection. De SWF-bestanden die de verzendende en ontvangende objecten bevatten, moeten op dezelfde clientcomputer worden uitgevoerd.

Er geldt een limiet van 40 kB op de hoeveelheid gegevens die als parameter aan deze opdracht kan worden doorgegeven. Wanneer send() een ArgumentError genereert, maar uw syntaxis correct is, probeer dan de send()-aanvragen op te delen in meerdere opdrachten, elk met een grootte van minder dan 40K aan gegevens.

Zoals is uitgelegd voor de vermelding connect(), wordt standaard het huidige superdomein aan connectionName toegevoegd. Wanneer u communicatie implementeert tussen verschillende domeinen, moet u wellicht connectionName in zowel de verzendende als ontvangende LocalConnection-objecten zodanig definiëren dat het huidige superdomein niet aan connectionName wordt toegevoegd. U kunt dit op twee manieren realiseren:

• Gebruik een onderstrepingsteken (_) aan het begin van connectionName in zowel het verzendende als het ontvangende object LocalConnection. In het bestand dat het ontvangende object bevat, gebruikt u LocalConnection.allowDomain() om aan te geven dat verbindingen van elk domein worden geaccepteerd. Met deze implementatie kunt u verzendende en ontvangende bestanden op elk willekeurig domein opslaan.
• Neem het superdomein in connectionName op in het verzendende object LocalConnection, bijvoorbeeld myDomain.com:myConnectionName. Gebruik LocalConnection.allowDomain() in het ontvangende object om op te geven dat verbindingen vanaf het opgegeven superdomein worden geaccepteerd (in dit geval myDomain.com) of dat verbindingen van elk willekeurig domein worden geaccepteerd.

Opmerking: u kunt geen superdomein opgeven in connectionName in het ontvangende object LocalConnection. Dat kan alleen in het verzendende object LocalConnection.

Houd bij gebruik van deze methode rekening met het beveiligingsmodel van Flash Player. Een object LocalConnection wordt standaard gekoppeld aan de sandbox van het SWF-bestand dat dit heeft gemaakt en interdomeinaanroepen naar objecten LocalConnection zijn niet toegestaan, tenzij u de methode LocalConnection.allowDomain() in het ontvangende bestand aanroept. Voor SWF-inhoud die in de browser wordt uitgevoerd, kunt u voorkomen dat een bestand deze methode gebruikt door de parameter allowNetworking van de tags object en embed in te stellen op de HTML-pagina die de SWF-inhoud bevat. In Adobe AIR is de inhoud in de application -beveiligingssandbox (inhoud die met de AIR-toepassing is geïnstalleerd), echter niet beperkt tot deze beveiligingsbeperkingen.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

Parameters

Verwante API-elementen

Wordt verzonden wanneer een uitzondering asynchroon wordt gegenereerd, dat wil zeggen, vanuit native asynchrone code.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een aanroep van LocalConnection.send() gegevens naar een andere beveiligingssandbox probeert te verzenden.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer een object LocalConnection de status meldt. Wanneer de aanroep met LocalConnection.send() lukt, is de waarde van de eigenschap level van het gebeurtenisobject status gelijk aan "status". Wanneer de aanroep mislukt, is de eigenschap level gelijk aan "error". Wanneer het ontvangende bestand de verbinding weigert, kan de aanroep mislukken zonder dat het verzendende bestand daarvan een melding ontvangt.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

In het SWF-bestand LocalConnectionSenderExample wordt een instantie LocalConnection gemaakt. Wanneer op de knop wordt geklikt, wordt de methode call() gebruikt voor het aanroepen van de methode lcHandler in het SWF-bestand met de verbindingsnaam "myConnection", waarbij de inhoud van TextField als een parameter wordt doorgegeven.

In het SWF-bestand LocalConnectionReceiverExample wordt een instantie LocalConnection gemaakt en wordt de methode connect() aangeroepen om dit SWF-bestand aan te duiden als ontvanger van berichten die zijn geadresseerd aan de verbinding "myConnection". Bovendien bevat deze klasse een methode public met de naam lcHandler(). Dit is de methode die wordt aangeroepen door het SWF-bestand LocalConnectionSenderExample. Bij het aanroepen wordt de tekst die als parameter wordt doorgegeven, toegevoegd aan het TextField in het werkgebied.

Opmerking: om het voorbeeld te kunnen testen, moeten beide SWF-bestanden gelijktijdig naar dezelfde computer worden geladen.

// 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);
        }
    }
}