Pakket | flash.media |
Klasse | public class AVURLStream |
Overerving | AVURLStream URLStream EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De leesbewerkingen in URLStream zijn niet-blokkerend. Dit betekent dat u de eigenschap bytesAvailable
moet gebruiken om vast te stellen of voldoende gegevens aanwezig zijn om te kunnen lezen. Er wordt een EOFError
-fout gegenereerd wanneer onvoldoende gegevens beschikbaar zijn.
Alle binaire gegevens worden standaard gecodeerd in de indeling bigEndian, met de meest significante byte eerst.
De beveiligingsregels die gelden voor URL-downloads met de klasse URLStream zijn hetzelfde als de regels die gelden voor objecten URLLoader. Zonodig moeten ook beleidsbestanden worden gedownload. Beveiligingsregels voor lokale bestanden zijn vereist en zonodig worden beveiligingswaarschuwingen weergegeven.
Verwante API-elementen
URLRequest
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
bytesAvailable : uint [alleen-lezen]
Hiermee wordt het aantal beschikbare gegevensbytes voor het lezen in de invoerbuffer geretourneerd. | URLStream | ||
connected : Boolean [alleen-lezen]
Hiermee wordt aangegeven of dit object URLStream momenteel is verbonden. | URLStream | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
cookieHeader : String [alleen-schrijven] | AVURLStream | ||
endian : String
Geeft de bytevolgorde voor de gegevens aan. | URLStream | ||
objectEncoding : uint
Hiermee wordt de AMF-versie (Action Message Format) beheerd die wordt gebruikt bij het schrijven of lezen van een object. | URLStream |
Methode | Gedefinieerd door | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Sluit de stream onmiddellijk en annuleert het downloaden. | URLStream | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
[overschrijven]
Begint met het downloaden van de URL die in de parameter request is opgegeven. | AVURLStream | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Leest een Booleaanse waarde uit de stream. | URLStream | ||
Leest een byte met teken uit de stream. | URLStream | ||
Leest length bytes gegevens uit de stream. | URLStream | ||
Leest een IEEE 754 drijvende-kommagetal met dubbele precisie uit de stream. | URLStream | ||
Leest een IEEE 754 drijvende-kommagetal met enkele precisie uit de stream. | URLStream | ||
Leest een 32-bits geheel getal met teken uit de stream. | URLStream | ||
Leest een multibyte-tekenreeks van de opgegeven lengte met de opgegeven tekenset uit de bytestream. | URLStream | ||
readObject():*
Hiermee wordt een object dat in AMF-indeling (Action Message Format) is gecodeerd, uit de socket gelezen. | URLStream | ||
Leest een 16-bits geheel getal met teken uit de stream. | URLStream | ||
Leest een byte zonder teken uit de stream. | URLStream | ||
Leest een 32-bits geheel getal zonder teken uit de stream. | URLStream | ||
Leest een 16-bits geheel getal zonder teken uit de stream. | URLStream | ||
Leest een UTF-8-tekenreeks uit de stream. | URLStream | ||
Leest een reeks UTF-8-lengtebytes uit de stream, waarna een tekenreeks wordt geretourneerd. | URLStream | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
cookieHeader | eigenschap |
load | () | methode |
override public function load(request:URLRequest):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Begint met het downloaden van de URL die in de parameter request
is opgegeven.
Opmerking: wanneer een bestand dat wordt geladen niet-ASCII-tekens bevat (zoals in vele niet-Engelse talen), wordt geadviseerd het bestand met UTF-8- of UTF-16-codering op te slaan in plaats van een niet-Unicode-indeling zoals ASCII.
Wanneer het laden onmiddellijk mislukt, wordt een IOError- of SecurityError-fout (inclusief de fout met betrekking tot lokale bestandsbeveiliging) gegenereerd met een beschrijving van de fout. Anders wordt een gebeurtenis open
verzonden bij het starten van de URL-download of wordt een gebeurtenis error verzonden wanneer alsnog een fout optreedt.
Standaard moeten het aanroepende SWF-bestand en de URL die u laadt zich in exact hetzelfde domein bevinden. Een SWF-bestand op www.adobe.com kan bijvoorbeeld alleen gegevens laden van bronnen die zelf ook aanwezig zijn op www.adobe.com. Wanneer u gegevens van een ander domein wilt laden, plaatst u een bestand met URL-beleid op de server die als host fungeert voor de gegevens.
In Flash Player kunt u geen verbinding maken met poorten die meestal zijn gereserveerd. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.
In Flash Player kunt u voorkomen dat een SWF-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.
Als u in Flash Player 10 en hoger en in AIR 1.5 en hoger een multipart-inhoudstype gebruikt (bijvoorbeeld 'multipart/form-data') dat een upload bevat (aangegeven met de parameter 'bestandsnaam' in een header 'content-disposition' binnen de POST-body), gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads:
- De POST-bewerking moet worden uitgevoerd in reactie op een door de gebruiker geïnitieerde actie, zoals het klikken met de muis of het indrukken van een toets.
- Als bij de POST-bewerking verschillende domeinen betrokken zijn (het doel van de POST-bewerking bevindt zich niet op dezelfde server als het SWF-bestand dat de POST-aanvraag verstuurt), moet de doelserver een URL-beleidsbestand leveren dat interdomeintoegang toestaat.
In het geval van een multipart-inhoudstype is het ook essentieel dat de syntaxis juist is (in overeenstemming met de norm RFC2046). Als de syntaxis ongeldig lijkt te zijn, gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads.
Deze regels gelden ook voor AIR-inhoud in niet-toepassingssandboxen. In Adobe AIR is de inhoud in de toepassingssandbox (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.
In AIR kan een object URLRequest worden geregistreerd voor de statusgebeurtenis httpResponse
. In tegenstelling tot de gebeurtenis httpStatus
, wordt de gebeurtenis httpResponseStatus
vóór eventuele responsgegevens bezorgd. Bovendien bevat de gebeurtenis httpResponseStatus
waarden voor de eigenschappen responseHeaders
en responseURL
(die ongedefinieerd zijn voor een httpStatus
-gebeurtenis). De gebeurtenis httpResponseStatus
(indien aanwezig) wordt verzonden vóór (en als aanvulling op) een gebeurtenis complete
of error
.
Als er een httpResponseStatus
gebeurtenislistener is, wordt de hoofdtekst van het antwoordbericht altijd verzonden en leidt de statuscode van HTTP-antwoorden altijd tot een gebeurteniscomplete
. Dit is altijd waar, of de statuscode van het HTTP-antwoord nu een geslaagde of een mislukte bewerking aangeeft.
Als er in AIR geen httpResponseStatus
-gebeurtenislistener is, is het gedrag afhankelijk van de SWF-versie:
- Bij SWF 9-inhoud wordt de hoofdtekst van het HTTP-antwoordbericht alleen verzonden als de statuscode van het HTTP-antwoord aangeeft dat de bewerking is geslaagd. Als de bewerking niet is geslaagd (er is een fout opgetreden), wordt de hoofdtekst niet verzonden en verzendt het object URLRequest de gebeurtenis IOError.
- Bij SWF 10-inhoud wordt de hoofdtekst van het HTTP-antwoordbericht altijd verzonden. Als er een fout is opgetreden, verzendt het object URLRequest een gebeurtenis IOError.
Parameters
request:URLRequest — Een object URLRequest dat de URL opgeeft die moet worden gedownload. Wanneer de waarde van deze parameter of de eigenschap URLRequest.url van het doorgegeven object URLRequest gelijk is aan null , genereert de toepassing een null pointer-fout.
|
Gebeurtenissen
complete: — Wordt verzonden nadat gegevens zijn geladen. Als er een gebeurtenislistener httpResponseStatus is, verzendt het URLRequest-object ook een complete -gebeurtenis, of de statuscode van het HTTP-antwoord nu een geslaagde of een mislukte bewerking aangeeft.
| |
httpStatus: — Wanneer toegang plaatsvindt via HTTP en de huidige omgeving het ophalen van statuscodes ondersteunt, kunt u deze gebeurtenissen ontvangen naast de gebeurtenissen complete of error .
| |
httpResponseStatus: — Wordt verzonden als een aanroep naar de methode load() via HTTP toegang tot gegevens probeert te krijgen en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren.
| |
ioError: — De laadbewerking kan niet worden voltooid.
| |
open: — Wordt verzonden wanneer een laadbewerking begint.
| |
securityError: — Een laadbewerking probeerde gegevens op te halen van een server buiten de beveiligingssandbox van de aanroeper. Dit kan worden omzeild door gebruik te maken van een beleidsbestand op de server.
|
Gegenereerde uitzondering
ArgumentError — Objecten URLRequest.requestHeader mogen bepaalde niet-toegestane HTTP-aanvraagheaders niet bevatten. Zie de beschrijving van de klasse URLRequestHeader voor meer informatie.
| |
MemoryError — Deze fout kan om de volgende redenen optreden:
| |
SecurityError — Lokale niet-vertrouwde SWF-bestanden mogen niet communiceren met internet. U kunt dit omzeilen door dit SWF-bestand opnieuw te classificeren als lokaal-met-netwerk of vertrouwd.
| |
SecurityError — U probeert verbinding te maken met een algemeen gereserveerde poort. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.
|
Wed Jun 13 2018, 11:42 AM Z