ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.utils 

URLUtil  - AS3 Flex

Paketmx.utils
Klassepublic class URLUtil
VererbungURLUtil Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die URLUtil-Klasse ist eine statische Klasse, die Methoden zur Arbeit mit vollständigen und relativen URLs in Flex umfasst.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
[statisch] Konvertiert eine möglicherweise relative URL in eine vollständig qualifizierte URL.
URLUtil
  
[statisch] Gibt die Portnummer der angegebenen URL zurück.
URLUtil
  
[statisch] Gibt den Protokollabschnitt der angegebenen URL zurück.
URLUtil
  
[statisch] Gibt den Servernamen der angegebenen URL zurück.
URLUtil
  
[statisch] Gibt die Domäne und die Portinformationen der angegebenen URL zurück.
URLUtil
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
[statisch] Anhand einer vorgegebenen URL wird bestimmt, ob die URL die Token „server.name“ und „server.port“ enthält.
URLUtil
  
[statisch] Wenn die LoaderConfig.url-Eigenschaft nicht verfügbar ist, ersetzt die replaceTokens()-Methode die Servernamen- und Porteigenschaften nicht richtig.
URLUtil
  
[statisch] Bestimmt, ob die URL das sichere HTTPS-Protokoll verwendet.
URLUtil
  
[statisch] Bestimmt, ob die URL das HTTP-, HTTPS- oder RTMP-Protokoll verwendet.
URLUtil
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
objectToString(object:Object, separator:String = "", encodeURL:Boolean):String
[statisch] Listet die dynamischen Eigenschaften eines Objekts auf (mit einer Schleife des Typs „for..in“) und gibt einen String zurück.
URLUtil
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
[statisch] Gibt einen neuen String zurück, in dem der Port durch den angegebenen Port ersetzt wurde.
URLUtil
  
[statisch] Ersetzt das Protokoll des angegebenen URI durch das neue Protokoll.
URLUtil
  
[statisch] Gibt einen neuen String zurück, in dem Port- und Servertoken durch den Port und Server der aktuell ausgeführten Anwendung ersetzt wurden.
URLUtil
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
stringToObject(string:String, separator:String = "", decodeURL:Boolean):Object
[statisch] Gibt ein Objekt aus einem String zurück.
URLUtil
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
  
[statisch] Überprüft, ob zwei URI-Strings gleich sind und ignoriert dabei Groß- und Kleinschreibung sowie Unterschiede bei nachgestellten Schrägstrichen.
URLUtil
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  SERVER_NAME_TOKEN : String = "{server.name}"
[statisch] Das an die replaceTokens()-Methode übergebene Muster im String, das durch den Servernamen der Anwendung ersetzt wird.
URLUtil
  SERVER_PORT_TOKEN : String = "{server.port}"
[statisch] Das an die replaceTokens()-Methode übergebene Muster im String, das durch den Port der Anwendung ersetzt wird.
URLUtil
Methodendetails

getFullURL

()Methode
public static function getFullURL(rootURL:String, url:String):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konvertiert eine möglicherweise relative URL in eine vollständig qualifizierte URL. Wenn die URL keine relative URL ist, wird sie unverändert zurückgegeben. Wenn die URL mit einem Schrägstrich beginnt, werden Host und Port der Stamm-URL vorangestellt. Andernfalls werden Host, Port und Pfad vorangestellt.

Parameter

rootURL:String — URL zur Auflösung der durch den url-Parameter angegebenen URL, wenn url relativ ist.
 
url:String — Zu konvertierende URL.

Rückgabewerte
String — Vollständig qualifizierte URL.

getPort

()Methode 
public static function getPort(url:String):uint

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt die Portnummer der angegebenen URL zurück.

Parameter

url:String — Die zu analysierende URL.

Rückgabewerte
uint — Die Portnummer der angegebenen URL.

getProtocol

()Methode 
public static function getProtocol(url:String):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt den Protokollabschnitt der angegebenen URL zurück. In den folgenden Beispielen sehen Sie die Rückgaben für verschiedene URLs:

          getProtocol("https://localhost:2700/") returns "https"
          getProtocol("rtmp://www.myCompany.com/myMainDirectory/groupChatApp/HelpDesk") returns "rtmp"
          getProtocol("rtmpt:/sharedWhiteboardApp/June2002") returns "rtmpt"
          getProtocol("rtmp::1234/chatApp/room_name") returns "rtmp"
          

Parameter

url:String — String, der die zu analysierende URL enthält.

Rückgabewerte
String — Das Protokoll oder ein leerer String, wenn kein Protokoll angegeben ist.

getServerName

()Methode 
public static function getServerName(url:String):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt den Servernamen der angegebenen URL zurück.

Parameter

url:String — Die zu analysierende URL.

Rückgabewerte
String — Der Servername der angegebenen URL.

getServerNameWithPort

()Methode 
public static function getServerNameWithPort(url:String):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt die Domäne und die Portinformationen der angegebenen URL zurück.

Parameter

url:String — Die zu analysierende URL.

Rückgabewerte
String — Der Servername und der Port der angegebenen URL.

hasTokens

()Methode 
public static function hasTokens(url:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Anhand einer vorgegebenen URL wird bestimmt, ob die URL die Token „server.name“ und „server.port“ enthält.

Parameter

url:String — Ein URL-String.

Rückgabewerte
Booleantrue, wenn die URL die Token „server.name“ und „server.port“ enthält.

hasUnresolvableTokens

()Methode 
public static function hasUnresolvableTokens():Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wenn die LoaderConfig.url-Eigenschaft nicht verfügbar ist, ersetzt die replaceTokens()-Methode die Servernamen- und Porteigenschaften nicht richtig.

Rückgabewerte
Booleantrue, wenn die LoaderConfig.url-Eigenschaft nicht verfügbar ist. Andernfalls wird false zurückgegeben.

isHttpsURL

()Methode 
public static function isHttpsURL(url:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Bestimmt, ob die URL das sichere HTTPS-Protokoll verwendet.

Parameter

url:String — Die zu analysierende URL.

Rückgabewerte
Booleantrue, wenn die URL mit „https://“ beginnt.

isHttpURL

()Methode 
public static function isHttpURL(url:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Bestimmt, ob die URL das HTTP-, HTTPS- oder RTMP-Protokoll verwendet.

Parameter

url:String — Die zu analysierende URL.

Rückgabewerte
Booleantrue, wenn die URL mit „http://“, „https://“ oder „rtmp://“ beginnt.

objectToString

()Methode 
public static function objectToString(object:Object, separator:String = "", encodeURL:Boolean):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Listet die dynamischen Eigenschaften eines Objekts auf (mit einer Schleife des Typs for..in) und gibt einen String zurück. Mit dieser Methode konvertieren Sie normalerweise ein ActionScript-Objekt in einen String, den Sie am Ende einer URL anfügen. Standardmäßig werden ungültige URL-Zeichen in URLs kodiert (in das Format %XX konvertiert).

Beispiel:

          var o:Object = { name: "Alex", age: 21 };
          var s:String = URLUtil.objectToString(o,";",true);
          trace(s);
          
Gibt „name=Alex;age=21“ im Trace-Protokoll aus.

Parameter

object:Object — Das in einen String zu konvertierende Objekt.
 
separator:String (default = "") — Das Zeichen zur Trennung der property:value-Paare des Objekts im String.
 
encodeURL:Boolean — Legt fest, ob der String als URL kodiert werden soll.

Rückgabewerte
String — Das Objekt, das an die Methode zurückgegeben wurde.

replacePort

()Methode 
public static function replacePort(uri:String, newPort:uint):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt einen neuen String zurück, in dem der Port durch den angegebenen Port ersetzt wurde. Wenn kein Port im angegebenen URI enthalten ist, wird der Port eingefügt. Diese Methode setzt voraus, dass ein Protokoll innerhalb des URI angegeben wurde.

Parameter

uri:String — String mit dem URI, in dem der Port ersetzt wurde.
 
newPort:uint — Vorzeichenlose Ganzzahl für den neuen Port.

Rückgabewerte
String — Der URI für den neuen Port.

replaceProtocol

()Methode 
public static function replaceProtocol(uri:String, newProtocol:String):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ersetzt das Protokoll des angegebenen URI durch das neue Protokoll.

Parameter

uri:String — String mit dem URI, in dem das Protokoll ersetzt werden muss.
 
newProtocol:String — String mit dem neuen Protokoll.

Rückgabewerte
String — Der URI mit dem ersetzten Protokoll oder ein leerer String, wenn der URI kein Protokoll enthält.

replaceTokens

()Methode 
public static function replaceTokens(url:String):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt einen neuen String zurück, in dem Port- und Servertoken durch den Port und Server der aktuell ausgeführten Anwendung ersetzt wurden.

Parameter

url:String — String mit dem SERVER_NAME_TOKEN und/oder SERVER_NAME_PORT, die durch den Port und Server der Anwendung ersetzt werden sollen.

Rückgabewerte
String — Der URI mit ersetztem Port und Server.

stringToObject

()Methode 
public static function stringToObject(string:String, separator:String = "", decodeURL:Boolean):Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt ein Objekt aus einem String zurück. Der String enthält name=value-Paare, die zu dynamischen Eigenschaften des zurückgegebenen Objekts werden. Diese Eigenschaftspaare werden durch den angegebenen separator getrennt. Diese Methode konvertiert Zahlen und boolesche Werte, Arrays (definiert durch „[]“) und untergeordnete Objekte (definiert durch „{}“). Standardmäßig werden URL-Muster im Format %XX in das entsprechende Stringzeichen konvertiert.

Beispiel:

          var s:String = "name=Alex;age=21";
          var o:Object = URLUtil.stringToObject(s, ";", true);
          
Gibt das Objekt { name: "Alex", age: 21 } zurück.

Parameter

string:String — Der in ein Objekt zu konvertierende String.
 
separator:String (default = "") — Das Zeichen zur Trennung von name=value-Paaren im String.
 
decodeURL:Boolean — Legt fest, ob die als URL kodierten Zeichen im String dekodiert werden sollen.

Rückgabewerte
Object — Das Objekt mit den Eigenschaften und Werten, die aus dem an diese Methode übergebenen String extrahiert wurden.

urisEqual

()Methode 
public static function urisEqual(uri1:String, uri2:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Überprüft, ob zwei URI-Strings gleich sind und ignoriert dabei Groß- und Kleinschreibung sowie Unterschiede bei nachgestellten Schrägstrichen.

Parameter

uri1:String — Der erste zu vergleichende URI.
 
uri2:String — Der zweite zu vergleichende URI.

Rückgabewerte
Boolean — Gibt true zurück, wenn die URIs gleich sind. Andernfalls wird false zurückgegeben.
Konstantendetails

SERVER_NAME_TOKEN

Konstante
public static const SERVER_NAME_TOKEN:String = "{server.name}"

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das an die replaceTokens()-Methode übergebene Muster im String, das durch den Servernamen der Anwendung ersetzt wird.

SERVER_PORT_TOKEN

Konstante 
public static const SERVER_PORT_TOKEN:String = "{server.port}"

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das an die replaceTokens()-Methode übergebene Muster im String, das durch den Port der Anwendung ersetzt wird.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.