URLUtil - Adobe ActionScript® 3 (AS3 Flex) API 參考

套件	mx.utils
類別	public class URLUtil
繼承	URLUtil Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The URLUtil class is a static class with methods for working with full and relative URLs within Flex.

相關 API 元素

mx.managers.BrowserManager

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		getFullURL(rootURL:String, url:String):String [靜態] Converts a potentially relative URL to a fully-qualified URL.	URLUtil
		getPort(url:String):uint [靜態] Returns the port number from the specified URL.	URLUtil
		getProtocol(url:String):String [靜態] Returns the protocol section of the specified URL.	URLUtil
		getServerName(url:String):String [靜態] Returns the server name from the specified URL.	URLUtil
		getServerNameWithPort(url:String):String [靜態] Returns the domain and port information from the specified URL.	URLUtil
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		hasTokens(url:String):Boolean [靜態] Given a url, determines whether the url contains the server.name and server.port tokens.	URLUtil
		hasUnresolvableTokens():Boolean [靜態] If the LoaderConfig.url property is not available, the replaceTokens() method will not replace the server name and port properties properly.	URLUtil
		isHttpsURL(url:String):Boolean [靜態] Determines if the URL uses the secure HTTPS protocol.	URLUtil
		isHttpURL(url:String):Boolean [靜態] Determines if the URL uses the HTTP, HTTPS, or RTMP protocol.	URLUtil
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		objectToString(object:Object, separator:String = "", encodeURL:Boolean):String [靜態] Enumerates an object's dynamic properties (by using a for..in loop) and returns a String.	URLUtil
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		replacePort(uri:String, newPort:uint):String [靜態] Returns a new String with the port replaced with the specified port.	URLUtil
		replaceProtocol(uri:String, newProtocol:String):String [靜態] Replaces the protocol of the specified URI with the given protocol.	URLUtil
		replaceTokens(url:String):String [靜態] Returns a new String with the port and server tokens replaced with the port and server from the currently running application.	URLUtil
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		stringToObject(string:String, separator:String = "", decodeURL:Boolean):Object [靜態] Returns an object from a String.	URLUtil
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		urisEqual(uri1:String, uri2:String):Boolean [靜態] Tests whether two URI Strings are equivalent, ignoring case and differences in trailing slashes.	URLUtil
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

	常數		定義自
		SERVER_NAME_TOKEN : String = "{server.name}" [靜態] The pattern in the String that is passed to the replaceTokens() method that is replaced by the application's server name.	URLUtil
		SERVER_PORT_TOKEN : String = "{server.port}" [靜態] The pattern in the String that is passed to the replaceTokens() method that is replaced by the application's port.	URLUtil

方法詳細資訊

getFullURL

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

參數

	`rootURL:String` — URL used to resolve the URL specified by the `url` parameter, if `url` is relative.

	`url:String` — URL to convert.

傳回值

String — Fully-qualified URL.

getPort

()

方法

public static function getPort(url:String):uint

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the port number from the specified URL.

參數

url:String — The URL to analyze.

傳回值

uint — The port number of the specified URL.

getProtocol

()

方法

public static function getProtocol(url:String):String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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"

參數

url:String — String containing the URL to parse.

傳回值

String — The protocol or an empty String if no protocol is specified.

getServerName

()

方法

public static function getServerName(url:String):String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the server name from the specified URL.

參數

url:String — The URL to analyze.

傳回值

String — The server name of the specified URL.

getServerNameWithPort

()

方法

public static function getServerNameWithPort(url:String):String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the domain and port information from the specified URL.

參數

url:String — The URL to analyze.

傳回值

String — The server name and port of the specified URL.

hasTokens

()

方法

public static function hasTokens(url:String):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 10, AIR 1.5

Given a url, determines whether the url contains the server.name and server.port tokens.

參數

url:String — A url string.

傳回值

Boolean — true if the url contains server.name and server.port tokens.

hasUnresolvableTokens

()

方法

public static function hasUnresolvableTokens():Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

傳回值

Boolean — true if the LoaderConfig.url property is not available. Otherwise, false.

isHttpsURL

()

方法

public static function isHttpsURL(url:String):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines if the URL uses the secure HTTPS protocol.

參數

url:String — The URL to analyze.

傳回值

Boolean — true if the URL starts with "https://".

isHttpURL

()

方法

public static function isHttpURL(url:String):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines if the URL uses the HTTP, HTTPS, or RTMP protocol.

參數

url:String — The URL to analyze.

傳回值

Boolean — true if the URL starts with "http://", "https://", or "rtmp://".

objectToString

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

參數

	`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.

傳回值

String — The object that was passed to the method.

replacePort

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

參數

	`uri:String` — String containing the URI in which the port is replaced.

	`newPort:uint` — uint containing the new port to subsitute.

傳回值

String — The URI with the new port.

replaceProtocol

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Replaces the protocol of the specified URI with the given protocol.

參數

	`uri:String` — String containing the URI in which the protocol needs to be replaced.

	`newProtocol:String` — String containing the new protocol to use.

傳回值

String — The URI with the protocol replaced, or an empty String if the URI does not contain a protocol.

replaceTokens

()

方法

public static function replaceTokens(url:String):String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

參數

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.

傳回值

String — The URI with the port and server replaced.

stringToObject

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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 }.

參數

	`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.

傳回值

Object — The object containing properties and values extracted from the String passed to this method.

urisEqual

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Tests whether two URI Strings are equivalent, ignoring case and differences in trailing slashes.

參數

	`uri1:String` — The first URI to compare.

	`uri2:String` — The second URI to compare.

傳回值

Boolean — true if the URIs are equal. Otherwise, false.

常數詳細資訊

SERVER_NAME_TOKEN

常數

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

SERVER_PORT_TOKEN

常數

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

法律聲明 | 線上隱私權政策

URLUtil - AS3 Flex

套件x

語言元素

附錄

套件 mx.utils

getFullURL

getPort

getProtocol

getServerName

getServerNameWithPort

hasTokens

hasUnresolvableTokens

isHttpsURL

isHttpURL

objectToString

replacePort

replaceProtocol

replaceTokens

stringToObject

urisEqual

SERVER_NAME_TOKEN

SERVER_PORT_TOKEN