(AIR만 해당)
패키지flash.net
클래스public class URLRequestDefaults
상속URLRequestDefaults Inheritance Object

런타임 버전: AIR 1.0

URLRequestDefaults 클래스에는 URLRequest 클래스의 속성 기본값을 정의하도록 설정할 수 있는 정적 속성이 포함되어 있습니다. 이 클래스에는 요청에 대한 기본 인증 자격 증명을 정의할 수 있는 정적 메서드인 URLRequestDefaults.setLoginCredentialsForHost()도 포함되어 있습니다. URLRequest 클래스는 HTTP 요청에 사용하기 위한 정보를 정의합니다.

URLRequest 객체에 설정된 모든 속성은 URLRequestDefaults 클래스에 대해 설정된 이러한 정적 속성을 재정의합니다.

URLRequestDefault 설정은 호출자의 응용 프로그램 도메인에 있는 내용에만 적용되지만 URLRequestDefaults.setLoginCredentialsForHost()를 호출하여 수행된 설정은 예외적으로 현재 실행 중인 응용 프로그램의 모든 응용 프로그램 도메인에 적용됩니다.

응용 프로그램 보안 샌드박스에서 실행 중인 Adobe® AIR™ 내용만 URLRequestDefaults 클래스를 사용할 수 있습니다. 다른 내용이 이 클래스의 멤버 또는 속성에 액세스하면 SecurityError가 발생합니다.

참고 사항

URLRequest

Public 속성
 속성다음에 의해 정의됨
  AIR-only authenticate : Boolean
[정적] URLRequest 객체의 authenticate 속성에 대한 기본 설정입니다.
URLRequestDefaults
  AIR-only cacheResponse : Boolean
[정적] URLRequest 객체의 cacheResponse 속성에 대한 기본 설정입니다.
URLRequestDefaults
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  AIR-only followRedirects : Boolean
[정적] URLRequest 객체의 followRedirects 속성에 대한 기본 설정입니다.
URLRequestDefaults
  AIR-only manageCookies : Boolean
[정적] URLRequest 객체의 manageCookies 속성에 대한 기본 설정입니다.
URLRequestDefaults
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  AIR-only useCache : Boolean
[정적] URLRequest 객체의 useCache 속성에 대한 기본 설정입니다.
URLRequestDefaults
  AIR-only userAgent : String
[정적] URLRequest 객체의 userAgent 속성에 대한 기본 설정입니다.
URLRequestDefaults
Public 메서드
 메서드다음에 의해 정의됨
 Inherited
hasOwnProperty(name:String):Boolean
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
  
AIR-only setLoginCredentialsForHost(hostname:String, user:String, password:String):*
[정적] 선택된 호스트에 대한 기본 사용자 및 암호 자격 증명을 설정합니다.
URLRequestDefaults
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
toString():String
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
valueOf():Object
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 정보
AIR-only 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 application 보안 샌드박스에 없습니다.

참고 사항

URLRequest.authenticate
AIR-only 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 application 보안 샌드박스에 없습니다.

참고 사항

URLRequest.cacheResponse
AIR-only 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 application 보안 샌드박스에 없습니다.

참고 사항

URLRequest.followRedirects
AIR-only 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 application 보안 샌드박스에 없습니다.

참고 사항

URLRequest.manageCookies
AIR-only 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 application 보안 샌드박스에 없습니다.

참고 사항

URLRequest.useCache
AIR-only userAgent속성 
userAgent:String  [읽기/쓰기]

런타임 버전: AIR 1.0

URLRequest 객체의 userAgent 속성에 대한 기본 설정입니다. URLRequest 객체의 userAgent 속성을 설정하면 이 기본 설정이 재정의됩니다.

이는 HTMLLoader 객체의 load() 메서드를 호출할 때 사용되는 HTMLLoader 객체 모두에 대한 기본 사용자 에이전트 문자열이기도 합니다. HTMLLoader 객체의 userAgent 속성을 설정하면 URLRequestDefaults.userAgent 설정이 재정의됩니다.

이 기본값은 다음 두 예제와 같이 런타임 운영 체제(예: Mac OS, Linux 또는 Windows), 런타임 언어 및 런타임 버전에 따라 다릅니다.



구현
    public static function get userAgent():String
    public function set userAgent(value:String):void

오류
SecurityError — 호출자가 AIR application 보안 샌드박스에 없습니다.

참고 사항

flash.net.URLRequest.userAgent
flash.html.HTMLLoader.userAgent
메서드 정보
AIR-only 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 application 보안 샌드박스에 없습니다.



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 02:16 AM -08:00