包 | flash.net |
类 | public class URLRequestDefaults |
继承 | URLRequestDefaults Object |
运行时版本: | AIR 1.0 |
URLRequestDefaults.setLoginCredentialsForHost()
,使用该方法可以定义请求的默认身份验证凭据。URLRequest 类定义要在 HTTP 请求中使用的信息。
URLRequest 对象中设置的任何属性都会覆盖为 URLRequestDefaults 类设置的那些静态属性。
URLRequestDefault 设置仅适用于调用方应用程序域中的内容,但有一个例外:通过调用 URLRequestDefaults.setLoginCredentialsForHost()
进行的设置适用于当前正在运行的应用程序中的所有应用程序域。
只有运行在应用程序安全沙箱中的 Adobe® AIR™ 内容才能使用 URLRequestDefaults 类。访问此类的成员或属性时,其他内容会导致引发 SecurityError。
另请参见
属性 | 定义方 | ||
---|---|---|---|
authenticate : Boolean [静态] URLRequest 对象的 authenticate 属性的默认设置。 | URLRequestDefaults | ||
cacheResponse : Boolean [静态] URLRequest 对象的 cacheResponse 属性的默认设置。 | URLRequestDefaults | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
followRedirects : Boolean [静态] URLRequest 对象的 followRedirects 属性的默认设置。 | URLRequestDefaults | ||
manageCookies : Boolean [静态] URLRequest 对象的 manageCookies 属性的默认设置。 | URLRequestDefaults | ||
prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | ||
useCache : Boolean [静态] URLRequest 对象的 useCache 属性的默认设置。 | URLRequestDefaults | ||
userAgent : String [静态] URLRequest 对象的 userAgent 属性的默认设置。 | URLRequestDefaults |
方法 | 定义方 | ||
---|---|---|---|
指示对象是否已经定义了指定的属性。 | Object | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
[静态] 为选定的主机设置默认用户和密码凭据。 | URLRequestDefaults | ||
设置循环操作动态属性的可用性。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object |
authenticate | 属性 |
authenticate:Boolean
[读写] 运行时版本: | AIR 1.0 |
URLRequest 对象的 authenticate
属性的默认设置。在 URLRequest 对象中设置 authenticate
属性将覆盖此默认设置。
注意:此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true.
public static function get authenticate():Boolean
public function set authenticate(value:Boolean):void
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。 |
另请参见
cacheResponse | 属性 |
cacheResponse:Boolean
[读写] 运行时版本: | AIR 1.0 |
URLRequest 对象的 cacheResponse
属性的默认设置。在 URLRequest 对象中设置 cacheResponse
属性将覆盖此默认设置。设置为 true
时,AIR 应用程序的默认行为是使用操作系统的 HTTP 缓存。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true.
public static function get cacheResponse():Boolean
public function set cacheResponse(value:Boolean):void
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。 |
另请参见
followRedirects | 属性 |
followRedirects:Boolean
[读写] 运行时版本: | AIR 1.0 |
URLRequest 对象的 followRedirects
属性的默认设置。在 URLRequest 对象中设置 followRedirects
属性将覆盖此默认设置。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true.
public static function get followRedirects():Boolean
public function set followRedirects(value:Boolean):void
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。 |
另请参见
manageCookies | 属性 |
manageCookies:Boolean
[读写] 运行时版本: | AIR 1.0 |
URLRequest 对象的 manageCookies
属性的默认设置。在 URLRequest 对象中设置 manageCookies
属性将覆盖此默认设置。
注意:此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true.
public static function get manageCookies():Boolean
public function set manageCookies(value:Boolean):void
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。 |
另请参见
useCache | 属性 |
useCache:Boolean
[读写] 运行时版本: | AIR 1.0 |
URLRequest 对象的 useCache
属性的默认设置。在 URLRequest 对象中设置 useCache
属性将覆盖此默认设置。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true.
public static function get useCache():Boolean
public function set useCache(value:Boolean):void
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。 |
另请参见
userAgent | 属性 |
userAgent:String
[读写] 运行时版本: | AIR 1.0 |
URLRequest 对象的 userAgent
属性的默认设置。在 URLRequest 对象中设置 userAgent
属性将覆盖此默认设置。
这也是用于所有 HTMLLoader 对象(调用 HTMLLoader 对象的 load()
方法时使用)的默认用户代理字符串。设置 HTMLLoader 对象的 userAgent
属性将覆盖 URLRequestDefaults.userAgent
设置。
此默认值随着运行时操作系统(如 Mac OS、Linux 或 Windows)、运行时语言和运行时版本而变化,如下面的示例所示:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
"Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
"Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
public static function get userAgent():String
public function set userAgent(value:String):void
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。 |
另请参见
setLoginCredentialsForHost | () | 方法 |
public static function setLoginCredentialsForHost(hostname:String, user:String, password:String):*
运行时版本: | AIR 1.0 |
为选定的主机设置默认用户和密码凭据。这些设置适用于应用程序的所有应用程序域中的 URLRequest 对象,而不仅仅适用于调用此方法的对象的应用程序域中的 URLRequest 对象(但 URLRequest 类的静态属性只适用于调用方的应用程序域)。当应用程序的另一部分登录时,这可以让整个应用程序的内容登录(不管该内容位于哪个应用程序域)。
注意在 Mac OS 中运行的应用程序:在 Mac OS 中调用此方法时,应用程序将对指定主机使用这些凭据,直到应用程序关闭为止,即使随后对同一主机调用 URLRequestDefaults.setLoginCredentialsForHost()
也是如此。但如果服务器拒绝此方法指定的凭据,则将识别随后对 URLRequestDefaults.setLoginCredentialsForHost()
方法(对于同一主机)的调用。
注意:此方法不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
参数
hostname:String —
应用用户名和密码的主机名称。此名称可以是域,如“www.example.com” ;也可以是域和端口号,如“www.example.com:80” 。请注意,“example.com” 、“www.example.com” 和“sales.example.com” 均视为唯一的主机。
| |
user:String — 要在针对指定主机进行的请求身份验证中使用的默认用户名。 | |
password:String — 要在针对指定主机进行的请求身份验证中使用的默认密码。 |
* |
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。 |