Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The URLUtil class is a static class with methods for working with
full and relative URLs within Flex.
public static function getFullURL(rootURL:String, url:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Converts a potentially relative URL to a fully-qualified URL.
If the URL is not relative, it is returned as is.
If the URL starts with a slash, the host and port
from the root URL are prepended.
Otherwise, the host, port, and path are prepended.
Parameters
| rootURL:String — URL used to resolve the URL specified by the url parameter, if url is relative.
|
|
| url:String — URL to convert.
|
Returns public static function getPort(url:String):uint
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the port number from the specified URL.
Parameters
| url:String — The URL to analyze.
|
Returns | uint — The port number of the specified URL.
|
public static function getProtocol(url:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the protocol section of the specified URL.
The following examples show what is returned based on different 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"
Parameters
| url:String — String containing the URL to parse.
|
Returns | String — The protocol or an empty String if no protocol is specified.
|
public static function getServerName(url:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the server name from the specified URL.
Parameters
| url:String — The URL to analyze.
|
Returns | String — The server name of the specified URL.
|
public static function getServerNameWithPort(url:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the domain and port information from the specified URL.
Parameters
| url:String — The URL to analyze.
|
Returns | String — The server name and port of the specified URL.
|
public static function hasUnresolvableTokens():Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
If the LoaderConfig.url
property is not available, the replaceTokens()
method will not
replace the server name and port properties properly.
Returns | Boolean — true if the LoaderConfig.url property is not available. Otherwise, false .
|
public static function isHttpsURL(url:String):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Determines if the URL uses the secure HTTPS protocol.
Parameters
| url:String — The URL to analyze.
|
Returns | Boolean — true if the URL starts with "https://".
|
public static function isHttpURL(url:String):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Determines if the URL uses the HTTP, HTTPS, or RTMP protocol.
Parameters
| url:String — The URL to analyze.
|
Returns | Boolean — true if the URL starts with "http://", "https://", or "rtmp://".
|
public static function objectToString(object:Object, separator:String = "", encodeURL:Boolean):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Enumerates an object's dynamic properties (by using a for..in
loop)
and returns a String. You typically use this method to convert an ActionScript object to a String that you then append to the end of a URL.
By default, invalid URL characters are URL-encoded (converted to the %XX
format).
For example:
var o:Object = { name: "Alex", age: 21 };
var s:String = URLUtil.objectToString(o,";",true);
trace(s);
Prints "name=Alex;age=21" to the trace log.
Parameters
| object:Object — The object to convert to a String.
|
|
| separator:String (default = " ") — The character that separates each of the object's property:value pair in the String.
|
|
| encodeURL:Boolean — Whether or not to URL-encode the String.
|
Returns | String — The object that was passed to the method.
|
public static function replacePort(uri:String, newPort:uint):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a new String with the port replaced with the specified port.
If there is no port in the specified URI, the port is inserted.
This method expects that a protocol has been specified within the URI.
Parameters
| uri:String — String containing the URI in which the port is replaced.
|
|
| newPort:uint — uint containing the new port to subsitute.
|
Returns | String — The URI with the new port.
|
public static function replaceProtocol(uri:String, newProtocol:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Replaces the protocol of the
specified URI with the given protocol.
Parameters
| uri:String — String containing the URI in which the protocol
needs to be replaced.
|
|
| newProtocol:String — String containing the new protocol to use.
|
Returns | String — The URI with the protocol replaced,
or an empty String if the URI does not contain a protocol.
|
public static function replaceTokens(url:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a new String with the port and server tokens replaced with
the port and server from the currently running application.
Parameters
| url:String — String containing the SERVER_NAME_TOKEN and/or SERVER_NAME_PORT
which should be replaced by the port and server from the application.
|
Returns | String — The URI with the port and server replaced.
|
public static function stringToObject(string:String, separator:String = "", decodeURL:Boolean):Object
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns an object from a String. The String contains name=value
pairs, which become dynamic properties
of the returned object. These property pairs are separated by the specified separator
.
This method converts Numbers and Booleans, Arrays (defined by "[]"),
and sub-objects (defined by "{}"). By default, URL patterns of the format %XX
are converted
to the appropriate String character.
For example:
var s:String = "name=Alex;age=21";
var o:Object = URLUtil.stringToObject(s, ";", true);
Returns the object:
{ name: "Alex", age: 21 }
.
Parameters
| string:String — The String to convert to an object.
|
|
| separator:String (default = " ") — The character that separates name=value pairs in the String.
|
|
| decodeURL:Boolean — Whether or not to decode URL-encoded characters in the String.
|
Returns | Object — The object containing properties and values extracted from the String passed to this method.
|
public static function urisEqual(uri1:String, uri2:String):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Tests whether two URI Strings are equivalent, ignoring case and
differences in trailing slashes.
Parameters
| uri1:String — The first URI to compare.
|
|
| uri2:String — The second URI to compare.
|
Returns | Boolean — true if the URIs are equal. Otherwise, false .
|
public static const SERVER_NAME_TOKEN:String = "{server.name}"
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The pattern in the String that is passed to the replaceTokens()
method that
is replaced by the application's server name.
public static const SERVER_PORT_TOKEN:String = "{server.port}"
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The pattern in the String that is passed to the replaceTokens()
method that
is replaced by the application's port.