java.net
클래스 HttpURLConnection

java.lang.Object 
  java.net.URLConnection 
      java.net.HttpURLConnection

알려진 직계 서브 클래스:

HttpsURLConnection

public abstract class HttpURLConnection
extends URLConnection 

HTTP 특유의 기능을 지원하는 URLConnection 입니다. 자세한 내용은 「HTTP - Hypertext Transfer Protocol」를 참조하십시오.

각 HttpURLConnection 인스턴스를 사용해 단일의 요구를 작성합니다만, HTTP 서버에의 네트워크 접속은 다른 인스턴스와 투과적으로 공유되는 일이 있습니다. 요구 후, HttpURLConnection InputStream 또는 OutputStream 로 close() 메서드를 호출하면, 이 인스턴스에 관련한 네트워크 자원이 해방됩니다만, 공유 지속 접속에 영향은 없습니다. disconnect() 메서드를 호출하면, 지속 접속이 그 때자식 돌 상태이면 소켓이 닫는 일이 있습니다.

도입된 버전 :

JDK1. 1

관련 항목:

disconnect()

필드 개요

protected int	chunkLength 출력에 체크 된 인코딩의 스트리밍 모드를 사용하는 경우의 체크의 길이입니다.
protected int	fixedContentLength 고정장의 스트리밍 모드를 사용하는 경우의 고정 컨텐츠장입니다.
static int	HTTP_ACCEPTED HTTP 스테이터스 코드 202: 허가되었습니다.
static int	HTTP_BAD_GATEWAY HTTP 스테이터스 코드 502: 잘못한 게이트웨이입니다.
static int	HTTP_BAD_METHOD HTTP 스테이터스 코드 405: 메서드는 허가되지 않습니다.
static int	HTTP_BAD_REQUEST HTTP 스테이터스 코드 400: 부당한 요구입니다.
static int	HTTP_CLIENT_TIMEOUT HTTP 스테이터스 코드 408: 요구가 마감 시간입니다.
static int	HTTP_CONFLICT HTTP 스테이터스 코드 409: 중복 하고 있습니다.
static int	HTTP_CREATED HTTP 스테이터스 코드 201: 작성되었습니다.
static int	HTTP_ENTITY_TOO_LARGE HTTP 스테이터스 코드 413: 요구 엔티티가 너무 깁니다.
static int	HTTP_FORBIDDEN HTTP 스테이터스 코드 403: 금지되고 있습니다.
static int	HTTP_GATEWAY_TIMEOUT HTTP 스테이터스 코드 504: 게이트웨이가 마감 시간입니다.
static int	HTTP_GONE HTTP 스테이터스 코드 410: 존재하지 않습니다.
static int	HTTP_INTERNAL_ERROR HTTP 스테이터스 코드 500: 내부 서버 에러입니다.
static int	HTTP_LENGTH_REQUIRED HTTP 스테이터스 코드 411: 길이가 필요합니다.
static int	HTTP_MOVED_PERM HTTP 스테이터스 코드 301: 영속적으로 이동되었습니다.
static int	HTTP_MOVED_TEMP HTTP 스테이터스 코드 302: 일시적으로 바꿉니다.
static int	HTTP_MULT_CHOICE HTTP 스테이터스 코드 300: 복수 선택되고 있습니다.
static int	HTTP_NO_CONTENT HTTP 스테이터스 코드 204: 컨텐츠가 없습니다.
static int	HTTP_NOT_ACCEPTABLE HTTP 스테이터스 코드 406: 허용 되지 않습니다.
static int	HTTP_NOT_AUTHORITATIVE HTTP 스테이터스 코드 203: 부당한 정보입니다.
static int	HTTP_NOT_FOUND HTTP 스테이터스 코드 404: 발견되지 않았습니다.
static int	HTTP_NOT_IMPLEMENTED HTTP 스테이터스 코드 501: 구현되지 않습니다.
static int	HTTP_NOT_MODIFIED HTTP 스테이터스 코드 304: 수정되지 않았습니다.
static int	HTTP_OK HTTP 스테이터스 코드 200: OK 입니다.
static int	HTTP_PARTIAL HTTP 스테이터스 코드 206: 부분적인 컨텐츠입니다.
static int	HTTP_PAYMENT_REQUIRED HTTP 스테이터스 코드 402: 지불이 필요합니다.
static int	HTTP_PRECON_FAILED HTTP 스테이터스 코드 412: 전제 조건이 올바르지는 않습니다.
static int	HTTP_PROXY_AUTH HTTP 스테이터스 코드 407: 프록시의 인증이 필요합니다.
static int	HTTP_REQ_TOO_LONG HTTP 스테이터스 코드 414: 요구 URL가 너무 깁니다.
static int	HTTP_RESET HTTP 스테이터스 코드 205: 컨텐츠를 리셋 합니다.
static int	HTTP_SEE_OTHER HTTP 스테이터스 코드 303: 외를 참조하십시오.
static int	HTTP_SERVER_ERROR 추천하지 않습니다. 잘못한 필드이며, 존재해야 하는 것이어 선.
static int	HTTP_UNAUTHORIZED HTTP 스테이터스 코드 401: 인증되지 않았습니다.
static int	HTTP_UNAVAILABLE HTTP 스테이터스 코드 503: 서비스를 이용할 수 없습니다.
static int	HTTP_UNSUPPORTED_TYPE HTTP 스테이터스 코드 415: 지원 되지 않는 미디어형입니다.
static int	HTTP_USE_PROXY HTTP 스테이터스 코드 305: 프록시를 사용해 주세요.
static int	HTTP_VERSION HTTP 스테이터스 코드 505: HTTP 버전이 지원 되지 않습니다.
protected boolean	instanceFollowRedirects 프로토콜이 자동적으로 리다이렉트 하는 경우는 true, 자동적으로 리다이렉트 하지 않는 경우는 false 입니다.
protected String	method HTTP 메서드 (GET, POST, PUT 등)입니다.
protected int	responseCode 3 자리수의 HTTP 스테이터스 코드를 나타내는 int 입니다.
protected String	responseMessage HTTP 응답 메세지입니다.

클래스 java.net. URLConnection 로부터 상속된 필드

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

생성자 개요

protected

HttpURLConnection (URL u) HttpURLConnection 생성자 입니다.

메서드 개요

abstract void	disconnect () 서버에의 다른 요구가 향후 발생 할 것 같지 않은 것을 나타냅니다.
InputStream	getErrorStream () 접속에는 실패해도 서버가 유효한 데이터를 배웅하고 왔을 경우에 에러 스트림을 리턴합니다.
static boolean	getFollowRedirects () HTTP 리다이렉트 (3xx)에 자동적으로 따를지 어떨지를 나타내는 boolean을 리턴합니다.
String	getHeaderField (int n) n 번째의 헤더 필드의 값을 리턴합니다.
long	getHeaderFieldDate (String name, long Default) 지정된 필드를 날짜와 시간로서 구문 분석 한 값을 리턴합니다.
String	getHeaderFieldKey (int n) n 번째의 헤더 필드의 키를 리턴합니다.
boolean	getInstanceFollowRedirects () 이 HttpURLConnection instanceFollowRedirects 필드값을 리턴합니다.
Permission	getPermission () 이 객체가 나타내는 접속의 실행에 필요한 접근 권한을 나타내는 Permission 객체를 리턴합니다.
String	getRequestMethod () 요구 메서드를 취득합니다.
int	getResponseCode () HTTP 응답 메세지로부터 스테이터스 코드를 취득합니다.
String	getResponseMessage () 서버로부터의 응답 코드에 HTTP 응답 메세지가 포함되어 있는 경우, 이것을 리턴합니다.
void	setChunkedStreamingMode (int chunklen) 이 메서드는 컨텐츠장이 사전에모르는경우에 내부 버퍼 처리를 실시하지 않고 HTTP 요구 본체의 스트리밍을 유효하게 하기 위해서 사용합니다.
void	setFixedLengthStreamingMode (int contentLength) 이 메서드는 컨텐츠장이 사전 갑작스럽다고 있는 경우에 내부 버퍼 처리를 실시하지 않고 HTTP 요구 본체의 스트리밍을 유효하게 하기 위해서 사용합니다.
static void	setFollowRedirects (boolean set) 이 클래스가 HTTP 리다이렉트 (응답 코드 300 접수대의 요구)에 자동적으로 따를지 어떨지를 설정합니다.
void	setInstanceFollowRedirects (boolean followRedirects) HTTP 리다이렉트 (응답 코드 3xx 요구)를, 이 HttpURLConnection인스턴스로 자동에 따를지 어떨지를 설정합니다.
void	setRequestMethod (String method) URL 요구의 메서드를 다음의 어떤 것인가로 설정합니다.
abstract boolean	usingProxy () 접속으로 프록시를 사용할지 어떨지를 나타냅니다.

클래스 java.net. URLConnection 로부터 상속된 메서드

addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderFieldInt, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

필드의 상세

method

protected String  method

HTTP 메서드 (GET, POST, PUT 등)입니다.

chunkLength

protected int chunkLength

출력에 체크 된 인코딩의 스트리밍 모드를 사용하는 경우의 체크의 길이입니다. 값 -1 은 체크 된 인코딩이 출력에 대해서 무효가 되어 있는 것을 나타냅니다.

fixedContentLength

protected int fixedContentLength

고정장의 스트리밍 모드를 사용하는 경우의 고정 컨텐츠장입니다. 값 -1 은 고정장의 스트리밍 모드가 출력에 대해서 무효가 되어 있는 것을 나타냅니다.

responseCode

protected int responseCode

3 자리수의 HTTP 스테이터스 코드를 나타내는 int 입니다.

• 100 접수대: 정보
• 200 접수대: 성공
• 300 접수대: 변환
• 400 접수대: 클라이언트 에러
• 500 접수대: 서버 에러

responseMessage

protected String  responseMessage

HTTP 응답 메세지입니다.

instanceFollowRedirects

protected boolean instanceFollowRedirects

프로토콜이 자동적으로 리다이렉트 하는 경우는 true, 자동적으로 리다이렉트 하지 않는 경우는 false 입니다.

이 필드값을 설정하려면 setInstanceFollowRedirects 메서드를 사용합니다. 반환값을 취득하려면 getInstanceFollowRedirects 메서드를 사용합니다.

HttpURLConnection 구축때, 기본값는 static followRedirects 값에 근거합니다.

관련 항목:

setInstanceFollowRedirects(boolean), getInstanceFollowRedirects(), setFollowRedirects(boolean)

HTTP_OK

public static final int HTTP_OK

HTTP 스테이터스 코드 200: OK 입니다.

관련 항목:

정수 필드값

HTTP_CREATED

public static final int HTTP_CREATED

HTTP 스테이터스 코드 201: 작성되었습니다.

관련 항목:

정수 필드값

HTTP_ACCEPTED

public static final int HTTP_ACCEPTED

HTTP 스테이터스 코드 202: 허가되었습니다.

관련 항목:

정수 필드값

HTTP_NOT_AUTHORITATIVE

public static final int HTTP_NOT_AUTHORITATIVE

HTTP 스테이터스 코드 203: 부당한 정보입니다.

관련 항목:

정수 필드값

HTTP_NO_CONTENT

public static final int HTTP_NO_CONTENT

HTTP 스테이터스 코드 204: 컨텐츠가 없습니다.

관련 항목:

정수 필드값

HTTP_RESET

public static final int HTTP_RESET

HTTP 스테이터스 코드 205: 컨텐츠를 리셋 합니다.

관련 항목:

정수 필드값

HTTP_PARTIAL

public static final int HTTP_PARTIAL

HTTP 스테이터스 코드 206: 부분적인 컨텐츠입니다.

관련 항목:

정수 필드값

HTTP_MULT_CHOICE

public static final int HTTP_MULT_CHOICE

HTTP 스테이터스 코드 300: 복수 선택되고 있습니다.

관련 항목:

정수 필드값

HTTP_MOVED_PERM

public static final int HTTP_MOVED_PERM

HTTP 스테이터스 코드 301: 영속적으로 이동되었습니다.

관련 항목:

정수 필드값

HTTP_MOVED_TEMP

public static final int HTTP_MOVED_TEMP

HTTP 스테이터스 코드 302: 일시적으로 바꿉니다.

관련 항목:

정수 필드값

HTTP_SEE_OTHER

public static final int HTTP_SEE_OTHER

HTTP 스테이터스 코드 303: 외를 참조하십시오.

관련 항목:

정수 필드값

HTTP_NOT_MODIFIED

public static final int HTTP_NOT_MODIFIED

HTTP 스테이터스 코드 304: 수정되지 않았습니다.

관련 항목:

정수 필드값

HTTP_USE_PROXY

public static final int HTTP_USE_PROXY

HTTP 스테이터스 코드 305: 프록시를 사용해 주세요.

관련 항목:

정수 필드값

HTTP_BAD_REQUEST

public static final int HTTP_BAD_REQUEST

HTTP 스테이터스 코드 400: 부당한 요구입니다.

관련 항목:

정수 필드값

HTTP_UNAUTHORIZED

public static final int HTTP_UNAUTHORIZED

HTTP 스테이터스 코드 401: 인증되지 않았습니다.

관련 항목:

정수 필드값

HTTP_PAYMENT_REQUIRED

public static final int HTTP_PAYMENT_REQUIRED

HTTP 스테이터스 코드 402: 지불이 필요합니다.

관련 항목:

정수 필드값

HTTP_FORBIDDEN

public static final int HTTP_FORBIDDEN

HTTP 스테이터스 코드 403: 금지되고 있습니다.

관련 항목:

정수 필드값

HTTP_NOT_FOUND

public static final int HTTP_NOT_FOUND

HTTP 스테이터스 코드 404: 발견되지 않았습니다.

관련 항목:

정수 필드값

HTTP_BAD_METHOD

public static final int HTTP_BAD_METHOD

HTTP 스테이터스 코드 405: 메서드는 허가되지 않습니다.

관련 항목:

정수 필드값

HTTP_NOT_ACCEPTABLE

public static final int HTTP_NOT_ACCEPTABLE

HTTP 스테이터스 코드 406: 허용 되지 않습니다.

관련 항목:

정수 필드값

HTTP_PROXY_AUTH

public static final int HTTP_PROXY_AUTH

HTTP 스테이터스 코드 407: 프록시의 인증이 필요합니다.

관련 항목:

정수 필드값

HTTP_CLIENT_TIMEOUT

public static final int HTTP_CLIENT_TIMEOUT

HTTP 스테이터스 코드 408: 요구가 마감 시간입니다.

관련 항목:

정수 필드값

HTTP_CONFLICT

public static final int HTTP_CONFLICT

HTTP 스테이터스 코드 409: 중복 하고 있습니다.

관련 항목:

정수 필드값

HTTP_GONE

public static final int HTTP_GONE

HTTP 스테이터스 코드 410: 존재하지 않습니다.

관련 항목:

정수 필드값

HTTP_LENGTH_REQUIRED

public static final int HTTP_LENGTH_REQUIRED

HTTP 스테이터스 코드 411: 길이가 필요합니다.

관련 항목:

정수 필드값

HTTP_PRECON_FAILED

public static final int HTTP_PRECON_FAILED

HTTP 스테이터스 코드 412: 전제 조건이 올바르지는 않습니다.

관련 항목:

정수 필드값

HTTP_ENTITY_TOO_LARGE

public static final int HTTP_ENTITY_TOO_LARGE

HTTP 스테이터스 코드 413: 요구 엔티티가 너무 깁니다.

관련 항목:

정수 필드값

HTTP_REQ_TOO_LONG

public static final int HTTP_REQ_TOO_LONG

HTTP 스테이터스 코드 414: 요구 URL가 너무 깁니다.

관련 항목:

정수 필드값

HTTP_UNSUPPORTED_TYPE

public static final int HTTP_UNSUPPORTED_TYPE

HTTP 스테이터스 코드 415: 지원 되지 않는 미디어형입니다.

관련 항목:

정수 필드값

HTTP_SERVER_ERROR

@Deprecated 
public static final int HTTP_SERVER_ERROR

추천하지 않습니다. 잘못한 필드이며, 존재해야 하는 것이어 선.

HTTP 스테이터스 코드 500: 내부 서버 에러입니다.

관련 항목:

정수 필드값

HTTP_INTERNAL_ERROR

public static final int HTTP_INTERNAL_ERROR

HTTP 스테이터스 코드 500: 내부 서버 에러입니다.

관련 항목:

정수 필드값

HTTP_NOT_IMPLEMENTED

public static final int HTTP_NOT_IMPLEMENTED

HTTP 스테이터스 코드 501: 구현되지 않습니다.

관련 항목:

정수 필드값

HTTP_BAD_GATEWAY

public static final int HTTP_BAD_GATEWAY

HTTP 스테이터스 코드 502: 잘못한 게이트웨이입니다.

관련 항목:

정수 필드값

HTTP_UNAVAILABLE

public static final int HTTP_UNAVAILABLE

HTTP 스테이터스 코드 503: 서비스를 이용할 수 없습니다.

관련 항목:

정수 필드값

HTTP_GATEWAY_TIMEOUT

public static final int HTTP_GATEWAY_TIMEOUT

HTTP 스테이터스 코드 504: 게이트웨이가 마감 시간입니다.

관련 항목:

정수 필드값

HTTP_VERSION

public static final int HTTP_VERSION

HTTP 스테이터스 코드 505: HTTP 버전이 지원 되지 않습니다.

관련 항목:

정수 필드값

생성자 상세

HttpURLConnection

protected HttpURLConnection(URL  u)

HttpURLConnection 생성자 입니다.

파라미터:

u - URL

메서드의 상세

getHeaderFieldKey

public String  getHeaderFieldKey(int n)

n 번째의 헤더 필드의 키를 리턴합니다. 구현에 따라서는 0 번째의 헤더 필드가 특별한 것 (HTTP 서버에 의해 리턴된 스테이터스행)으로서 다루어집니다. 이 경우 getHeaderField(0) 가 스테이터스행을 리턴합니다만, getHeaderFieldKey(0)는 null을 리턴합니다.

오버라이드(override):

클래스 URLConnection 내의 getHeaderFieldKey

파라미터:

n - 인덱스 (n >=0)

반환값:

n 번째의 헤더 필드의 키. 키가 존재하지 않는 경우는 null

setFixedLengthStreamingMode

public void setFixedLengthStreamingMode(int contentLength)

이 메서드는 컨텐츠장이 사전 갑작스럽다고 있는 경우에 내부 버퍼 처리를 실시하지 않고 HTTP 요구 본체의 스트리밍을 유효하게 하기 위해서 사용합니다.

어플리케이션이 지정된 컨텐츠 길이를 넘는 데이터를 출력하려고 하거나 어플리케이션이 지정된 양을 출력하기 전에 OutputStream를 닫거나 했을 경우에 예외가 발생 됩니다.

출력 스트리밍이 유효한 경우, 인증과 리다이렉트를 자동적으로 실시할 수 없습니다. 인증이나 리다이렉트가 필요한 경우, 응답을 읽어내고 있을 때 HttpRetryException가 발생 됩니다. 이 예외에 대해 문의하는 것으로 에러의 상세를 취득할 수 있습니다.

이 메서드는 URLConnection 접속전에 호출할 필요가 있습니다.

파라미터:

contentLength - OutputStream에 출력해지는 바이트수

예외:

IllegalStateException - URLConnection가 이미 접속되고 있다, 또는 다른 스트리밍 모드가 이미 유효하게 되어 있는 경우

IllegalArgumentException - 0 미만의 컨텐츠장이 가리키는 경우

관련 항목:

setChunkedStreamingMode(int)

setChunkedStreamingMode

public void setChunkedStreamingMode(int chunklen)

이 메서드는 컨텐츠장이 사전에모르는경우에 내부 버퍼 처리를 실시하지 않고 HTTP 요구 본체의 스트리밍을 유효하게 하기 위해서 사용합니다. 이 모드에서는 체크 된 전송 인코딩을 사용해 요구 본체가 송신됩니다. 모든 HTTP 서버로 이 모드가 지원 되고 있는 것은 아닌 것에 유의해 주세요.

출력 스트리밍이 유효한 경우, 인증과 리다이렉트를 자동적으로 실시할 수 없습니다. 인증이나 리다이렉트가 필요한 경우, 응답을 읽어내고 있을 때 HttpRetryException가 발생 됩니다. 이 예외에 대해 문의하는 것으로 에러의 상세를 취득할 수 있습니다.

이 메서드는 URLConnection 접속전에 호출할 필요가 있습니다.

파라미터:

chunklen - 각 체크에 출력해지는 바이트수. chunklen가 0 아래의 경우, 기본값이 사용된다

예외:

IllegalStateException - URLConnection가 이미 접속되고 있다, 또는 다른 스트리밍 모드가 이미 유효하게 되어 있는 경우

관련 항목:

setFixedLengthStreamingMode(int)

getHeaderField

public String  getHeaderField(int n)

n 번째의 헤더 필드의 값을 리턴합니다. 구현에 따라서는 0 번째의 헤더 필드는 특별한 것 (HTTP 서버에 의해 리턴된 스테이터스행)으로서 다루어집니다.

이 메서드와 getHeaderFieldKey 메서드를 조합해 사용하면, 메세지내의 모든 헤더를 반복 처리 할 수 있습니다 .

오버라이드(override):

클래스 URLConnection 내의 getHeaderField

파라미터:

n - 인덱스 (n>=0)

반환값:

n 번째의 헤더 필드의 값. 값이 존재하지 않는 경우는 null

관련 항목:

getHeaderFieldKey(int)

setFollowRedirects

public static void setFollowRedirects(boolean set)

이 클래스가 HTTP 리다이렉트 (응답 코드 300 접수대의 요구)에 자동적으로 따를지 어떨지를 설정합니다. 디폴트에서는 true 입니다. 애플릿은 이 변수를 변경할 수 없습니다.

시큐러티 매니저가 존재하는 경우, 이 메서드는 최초로 시큐러티 매니저의 checkSetFactory 메서드를 호출하는 것으로 이 조작이 허가되고 있는 것을 확인합니다. 이 결과, SecurityException가 되는 일이 있습니다.

파라미터:

set - HTTP 리다이렉트를 실시할지 어떨지를 나타내는 boolean

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkSetFactory 메서드가 이 조작을 허가하지 않는 경우

관련 항목:

SecurityManager.checkSetFactory(), getFollowRedirects()

getFollowRedirects

public static boolean getFollowRedirects()

HTTP 리다이렉트 (3xx)에 자동적으로 따를지 어떨지를 나타내는 boolean을 리턴합니다.

반환값:

HTTP 리다이렉트에 자동적으로 따르는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

setFollowRedirects(boolean)

setInstanceFollowRedirects

public void setInstanceFollowRedirects(boolean followRedirects)

HTTP 리다이렉트 (응답 코드 3xx 요구)를, 이 HttpURLConnection인스턴스로 자동에 따를지 어떨지를 설정합니다.

디폴트가 true 인, followRedirects 로부터의 기본값

파라미터:

followRedirects - HTTP 리다이렉트를 실시할지 어떨지를 나타내는 boolean

관련 항목:

instanceFollowRedirects, getInstanceFollowRedirects()

getInstanceFollowRedirects

public boolean getInstanceFollowRedirects()

이 HttpURLConnection instanceFollowRedirects 필드값을 리턴합니다.

반환값:

이 HttpURLConnection instanceFollowRedirects 필드값

관련 항목:

instanceFollowRedirects, setInstanceFollowRedirects(boolean)

setRequestMethod

public void setRequestMethod(String  method)
                      throws ProtocolException 

URL 요구의 메서드를 다음의 어떤 것인가로 설정합니다.

• GET
• POST
• HEAD
• OPTIONS
• PUT
• DELETE
• TRACE

이러한 메서드 가운데, 어떤 것이 유효한가는 프로토콜의 제한에 의해 정해집니다. 디폴트의 메서드는 GET 입니다.

파라미터:

method - HTTP 메서드

예외:

ProtocolException - 메서드를 리셋 할 수 없는 경우, 또는 요구한 메서드가 HTTP 로 무효인 경우

관련 항목:

getRequestMethod()

getRequestMethod

public String  getRequestMethod()

요구 메서드를 취득합니다.

반환값:

HTTP 요구 메서드

관련 항목:

setRequestMethod(java.lang.String)

getResponseCode

public int getResponseCode()
                    throws IOException 

HTTP 응답 메세지로부터 스테이터스 코드를 취득합니다. 예를 들어,

 HTTP/1. 0 200 OK HTTP/1. 0 401 Unauthorized 

라고 하는 스테이터스행에서는 200 으로 401을 각각 리턴합니다. 응답으로부터 코드를 식별할 수 없는 (응답이 유효한 HTTP가 아니다) 경우는 -1을 리턴합니다.

반환값:

HTTP 스테이터스 코드, 또는 -1

예외:

IOException - 서버에의 접속으로 에러가 발생했을 경우

getResponseMessage

public String  getResponseMessage()
                          throws IOException 

서버로부터의 응답 코드에 HTTP 응답 메세지가 포함되어 있는 경우, 이것을 리턴합니다. 응답 코드의 예를 다음에 나타냅니다.

 HTTP/1. 0 200 OK HTTP/1. 0 404 Not Found

「OK」와「Not Found」의 캐릭터 라인의 부분을 각각 꺼냅니다. 응답 코드를 식별할 수 없는 (유효한 HTTP가 아니다) 경우는 null을 리턴합니다.

반환값:

HTTP 응답 메세지 또는 null

예외:

IOException - 서버에의 접속으로 에러가 발생했을 경우

getHeaderFieldDate

public long getHeaderFieldDate(String  name,
                               long Default)

클래스 URLConnection 기술:

지정된 필드를 날짜와 시간로서 구문 분석 한 값을 리턴합니다. 지정된 필드가 나타내는 그리니지 표준시 1970 년 1 월 1 일부터 기산한 밀리 세컨드수가 리턴됩니다 .

이 형식의 getHeaderField가 존재하고 있는 이유는 일부의 종류의 접속 (http-ng 등)이 사전에 구문 분석 되어 있는 헤더를 가지기 때문에입니다. 그러한 종류의 접속 클래스에서는 이 메서드를 오버라이드(override)의해 구문 분석을 회피할 수 있습니다 .

오버라이드(override):

클래스 URLConnection 내의 getHeaderFieldDate

파라미터:

name - 헤더 필드의 이름

Default - 기본값

반환값:

일자로서 구문 분석 한 필드값. 필드가 없는지, 또는 필드의 형식이 부정한 경우는 Default인수

disconnect

public abstract void disconnect()

서버에의 다른 요구가 향후 발생 할 것 같지 않은 것을 나타냅니다. disconnect()의 호출에의해 이 HttpURLConnection 인스턴스를 다른 요구로 재이용하는 것은 가리키지 않습니다.

usingProxy

public abstract boolean usingProxy()

접속으로 프록시를 사용할지 어떨지를 나타냅니다.

반환값:

접속으로 프록시를 사용할지 어떨지를 나타내는 boolean 형

getPermission

public Permission  getPermission()
                         throws IOException 

클래스 URLConnection 기술:

이 객체가 나타내는 접속의 실행에 필요한 접근 권한을 나타내는 Permission 객체를 리턴합니다. 접속의 실행에 접근 권한이 불필요한 경우, 이 메서드는 null을 리턴합니다. 디폴트에서는 이 메서드는 java.security.AllPermission을 리턴합니다. 서브 클래스에서는 URL에 접속하기 위해서 필요한 접근 권한을 가장 적절히 나타내는 접근 권한을 돌려주도록, 이 메서드를 오버라이드(override) 합니다. 예를 들어, file: URL를 나타내는 URLConnection에 서는 java.io.FilePermission 객체가 리턴됩니다 .

리턴된 접근 권한은 접속의 상황에 의존합니다. 예를 들어 접속전의 접근 권한은 접속한 뒤의 접근 권한과는 다른 경우가 있습니다. 예를 들어 foo.com 라고 하는 HTTP 서버로 접속을 다른 호스트 bar.com에 리다이렉트 하고 있다고 합니다. 접속하기 전에 connection에 의해 리턴된 접근 권한은 foo.com 에의 접속에 필요한 접근 권한입니다. 한편, 접속의 나중에 리턴된 접근 권한은 bar.com 에의 접근 권한이 됩니다.

접근 권한은 보통 2개의 목적으로 사용합니다. URLConnections에 의해 취득한 객체의 캐쉬의 보호 및 접수측이 특정의 URL를 알 권리의 확인입니다. 전자의 경우, 접근 권한은 객체를 취득한 「나머지」로 취득됩니다. 예를 들어 HTTP 접속에서는 데이터의 최종적인 입수처가 되는 호스트에게 접속하기 위한 접근 권한을 나타냅니다. 후자의 경우, 접근 권한은 접속의 「전」에 취득 및 테스트됩니다.

오버라이드(override):

클래스 URLConnection 내의 getPermission

반환값:

이 URLConnection가 나타내는 접속을 위해서 필요한 접근 권한을 나타내는 Permission 객체

예외:

IOException - 접근 권한의 처리에 네트워크 또는 파일 입출력이 필요한 때에 처리중에 예외가 발생했을 경우

getErrorStream

public InputStream  getErrorStream()

접속에는 실패해도 서버가 유효한 데이터를 배웅하고 왔을 경우에 에러 스트림을 리턴합니다. 자주 있는 예는 HTTP 서버가 코드 404 로 응답했을 때에 접속에 대해서는 FileNotFoundException 이 발생 됩니다만, 서버로부터 대처책을 지시하는 HTML 헬프 페이지가 송신되는 경우입니다.

이 메서드는 접속을 개시하지 않습니다. 접속이 확립되어 있지 않은 경우, 접속중에 서버로 에러가 발생하지 않았던 경우, 혹은 서버로 에러가 발생해도 에러의 데이터가 보내지지 않았던 경우에는 이 메서드는 null을 리턴합니다. 이것이 디폴트의 동작입니다.

반환값:

에러 스트림. 에러가 없었던 경우, 접속이 확립되어 있지 않은 경우, 혹은 서버로부터 유효한 데이터가 보내지지 않았던 경우는 null