| 패키지 | flash.net |
| 클래스 | public class URLRequestDefaults |
| 상속 | URLRequestDefaults  Object |
| 런타임 버전: | AIR 1.0, Flash Lite 4 |
URLRequestDefaults.setLoginCredentialsForHost()도 포함되어 있습니다. URLRequest 클래스는 HTTP 요청에 사용하기 위한 정보를 정의합니다.
URLRequest 객체에 설정된 모든 속성은 URLRequestDefaults 클래스에 대해 설정된 이러한 정적 속성을 재정의합니다.
URLRequestDefault 설정은 호출자의 응용 프로그램 도메인에 있는 내용에만 적용되지만 URLRequestDefaults.setLoginCredentialsForHost()를 호출하여 수행된 설정은 예외적으로 현재 실행 중인 응용 프로그램의 모든 응용 프로그램 도메인에 적용됩니다.
응용 프로그램 보안 샌드박스에서 실행 중인 Adobe® AIR® 내용만 URLRequestDefaults 클래스를 사용할 수 있습니다. 다른 내용이 이 클래스의 멤버 또는 속성에 액세스하면 SecurityError가 발생합니다.
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| authenticate : Boolean [정적]
URLRequest 객체의 authenticate 속성에 대한 기본 설정입니다. | URLRequestDefaults | ||
| cacheResponse : Boolean [정적]
URLRequest 객체의 cacheResponse 속성에 대한 기본 설정입니다. | URLRequestDefaults | ||
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| followRedirects : Boolean [정적]
URLRequest 객체의 followRedirects 속성에 대한 기본 설정입니다. | URLRequestDefaults | ||
| idleTimeout : Number [정적]
URLRequest 객체 및 HTMLLoader 객체의 idleTimeout 속성에 대한 기본 설정입니다. | URLRequestDefaults | ||
| manageCookies : Boolean [정적]
URLRequest 객체의 manageCookies 속성에 대한 기본 설정입니다. | URLRequestDefaults | ||
| useCache : Boolean [정적]
URLRequest 객체의 useCache 속성에 대한 기본 설정입니다. | URLRequestDefaults | ||
| userAgent : String [정적]
URLRequest 객체의 userAgent 속성에 대한 기본 설정입니다. | URLRequestDefaults | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
[정적]
선택된 호스트에 대한 기본 사용자 및 암호 자격 증명을 설정합니다. | URLRequestDefaults | ||
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
authenticate | 속성 |
authenticate:Boolean| 런타임 버전: | AIR 1.0, Flash Lite 4 |
URLRequest 객체의 authenticate 속성에 대한 기본 설정입니다. URLRequest 객체의 authenticate 속성을 설정하면 이 기본 설정이 재정의됩니다.
참고: 이 설정은 파일 업로드 또는 RTMP 요청에 사용된 URLRequest 객체에 적용되지 않습니다.
기본값: true.
구현
public static function get authenticate():Boolean public static function set authenticate(value:Boolean):void오류
SecurityError — 호출자가 AIR 응용 프로그램 보안 샌드박스에 없습니다.
|
관련 API 요소
cacheResponse | 속성 |
cacheResponse:Boolean| 런타임 버전: | AIR 1.0, Flash Lite 4 |
URLRequest 객체의 cacheResponse 속성에 대한 기본 설정입니다. URLRequest 객체의 cacheResponse 속성을 설정하면 이 기본 설정이 재정의됩니다. true로 설정할 경우의 기본 AIR 응용 프로그램 비헤이비어는 운영 체제의 HTTP 캐시를 사용하는 것입니다. 이 설정은 파일 업로드 또는 RTMP 요청에 사용된 URLRequest 객체에 적용되지 않습니다.
기본값: true.
구현
public static function get cacheResponse():Boolean public static function set cacheResponse(value:Boolean):void오류
SecurityError — 호출자가 AIR 응용 프로그램 보안 샌드박스에 없습니다.
|
관련 API 요소
followRedirects | 속성 |
followRedirects:Boolean| 런타임 버전: | AIR 1.0, Flash Lite 4 |
URLRequest 객체의 followRedirects 속성에 대한 기본 설정입니다. URLRequest 객체의 followRedirects 속성을 설정하면 이 기본 설정이 재정의됩니다. 이 설정은 파일 업로드 또는 RTMP 요청에 사용된 URLRequest 객체에 적용되지 않습니다.
기본값: true.
구현
public static function get followRedirects():Boolean public static function set followRedirects(value:Boolean):void오류
SecurityError — 호출자가 AIR 응용 프로그램 보안 샌드박스에 없습니다.
|
관련 API 요소
idleTimeout | 속성 |
idleTimeout:Number| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 2 |
URLRequest 객체 및 HTMLLoader 객체의 idleTimeout 속성에 대한 기본 설정입니다.
유휴 제한 시간은 클라이언트가 연결이 설정된 후 요청을 포기할 때까지 서버 응답을 기다리는 시간 간격(밀리초)입니다.
이는 URLRequest 또는 HTMLLoader 객체에서 사용되는 기본 유휴 제한 시간을 정의합니다. URLRequest 객체 또는 HTMLLoader 객체의 idleTimeout 속성을 설정하면 이 기본 설정이 재정의됩니다.
이 속성을 0(기본값)으로 설정하는 경우 런타임은 운영 체제에서 정의한 기본 유효 제한 시간 값을 사용합니다. 기본 유효 제한 시간 값은 운영 체제(예: Mac OS, Linux 또는 Windows) 및 운영 체제 버전에 따라 다릅니다.
이 설정은 파일 업로드 또는 RTMP 요청에 사용된 URLRequest 객체에 적용되지 않습니다.
기본값: 0.
구현
public static function get idleTimeout():Number public static function set idleTimeout(value:Number):void오류
SecurityError — 호출자가 AIR 응용 프로그램 보안 샌드박스에 없습니다.
| |
RangeError — idleTimeout 값이 음수입니다.
|
관련 API 요소
manageCookies | 속성 |
manageCookies:Boolean| 런타임 버전: | AIR 1.0, Flash Lite 4 |
URLRequest 객체의 manageCookies 속성에 대한 기본 설정입니다. URLRequest 객체의 manageCookies 속성을 설정하면 이 기본 설정이 재정의됩니다.
참고: 이 설정은 파일 업로드 또는 RTMP 요청에 사용된 URLRequest 객체에 적용되지 않습니다.
기본값: true.
구현
public static function get manageCookies():Boolean public static function set manageCookies(value:Boolean):void오류
SecurityError — 호출자가 AIR 응용 프로그램 보안 샌드박스에 없습니다.
|
관련 API 요소
useCache | 속성 |
useCache:Boolean| 런타임 버전: | AIR 1.0, Flash Lite 4 |
URLRequest 객체의 useCache 속성에 대한 기본 설정입니다. URLRequest 객체의 useCache 속성을 설정하면 이 기본 설정이 재정의됩니다. 이 설정은 파일 업로드 또는 RTMP 요청에 사용된 URLRequest 객체에 적용되지 않습니다.
기본값: true.
구현
public static function get useCache():Boolean public static function set useCache(value:Boolean):void오류
SecurityError — 호출자가 AIR 응용 프로그램 보안 샌드박스에 없습니다.
|
관련 API 요소
userAgent | 속성 |
userAgent:String| 런타임 버전: | AIR 1.0, Flash Lite 4 |
URLRequest 객체의 userAgent 속성에 대한 기본 설정입니다. URLRequest 객체의 userAgent 속성을 설정하면 이 기본 설정이 재정의됩니다.
이는 HTMLLoader 객체의 load() 메서드를 호출할 때 사용되는 HTMLLoader 객체 모두에 대한 기본 사용자 에이전트 문자열이기도 합니다. HTMLLoader 객체의 userAgent 속성을 설정하면 URLRequestDefaults.userAgent 설정이 재정의됩니다.
이 기본값은 다음 두 예제와 같이 런타임 운영 체제(예: Mac OS, Linux 또는 Windows), 런타임 언어 및 런타임 버전에 따라 다릅니다.
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (Gecko와 같은 KHTML) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (Gecko와 같은 KHTML) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (Gecko와 같은 KHTML) AdobeAIR/1.5"
구현
public static function get userAgent():String public static function set userAgent(value:String):void오류
SecurityError — 호출자가 AIR 응용 프로그램 보안 샌드박스에 없습니다.
|
관련 API 요소
setLoginCredentialsForHost | () | 메서드 |
public static function setLoginCredentialsForHost(hostname:String, user:String, password:String):*| 런타임 버전: | AIR 1.0, Flash Lite 4 |
선택된 호스트에 대한 기본 사용자 및 암호 자격 증명을 설정합니다. 이러한 설정은 이 메서드를 호출하는 객체의 응용 프로그램 도메인에 있는 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 응용 프로그램 보안 샌드박스에 없습니다.
|
Tue Jun 12 2018, 03:17 PM Z