java.net
클래스 URLConnection

java.lang.Object 
  java.net.URLConnection

알려진 직계 서브 클래스:

HttpURLConnection, JarURLConnection

public abstract class URLConnection
extends Object 

추상 클래스 URLConnection는 어플리케이션과 URL와 의 사이의 통신 링크를 나타내는 모든 클래스의 슈퍼 클래스입니다. 이 클래스의 인스턴스를 사용해, URL 로 참조하는 자원의 독해와 출력의 양쪽 모두를 실시할 수 있습니다 . 일반적으로 URL 에의 접속을 작성하려면 복수의 순서가 필요합니다.

openConnection()	connect()
리모트 자원에의 접속에 영향을 주는 파라미터를 조작하는	자원과의 사이로 쿼리헤더 필드 및 컨텐츠를 교환한다

---------------------------->
시간

1. URL에 대해서 openConnection 메서드를 호출하는 것에의해 접속 객체를 작성한다
2. 셋업 파라미터와 일반 요구 프로퍼티를 조작한다
3. connect 메서드를 사용해, 리모트 객체에의 실제의 접속을 확립한다
4. 리모트 객체가 사용 가능하게 된다. 리모트 객체의 헤더 필드와 내용에 액세스 할 수 있게 된다

셋업 파라미터를 수정하려면 다음의 메서드를 사용합니다.

• setAllowUserInteraction
• setDoInput
• setDoOutput
• setIfModifiedSince
• setUseCaches

일반 요구 프로퍼티를 수정하려면 다음의 메서드를 사용합니다.

• setRequestProperty

AllowUserInteraction 파라미터와 UseCaches 파라미터의 기본값을 설정하려면, setDefaultAllowUserInteraction 메서드와 setDefaultUseCaches 메서드를 사용합니다.

상기의 양쪽 모두의 set 메서드에는 대응하는 get 메서드가 있어, 파라미터나 일반 요구 프로퍼티의 값을 취득할 수 있습니다 . 사용할 수 있는 파라미터와 일반 요구 프로퍼티는 프로토콜에 따라서 다릅니다.

리모트 객체에의 접속을 확립한뒤 헤더 필드와 내용에 액세스 하려면 다음의 메서드를 사용합니다.

• getContent
• getHeaderField
• getInputStream
• getOutputStream

일부의 헤더 필드는 빈번하게 액세스 됩니다. 다음의 메서드는 이러한 필드에 액세스 할 때에 편리합니다.

• getContentEncoding
• getContentLength
• getContentType
• getDate
• getExpiration
• getLastModifed

getContentType 메서드는 리모트 객체의 형태를 판별할 경우에 getContent 메서드에 의해 사용됩니다. 서브 클래스에서는 getContentType 메서드를 오버라이드(override) 하면 편리한 일이 있습니다.

일반적으로 접속전의 파라미터와 일반 요구 프로퍼티는 무시해도 괜찮습니다. 접속전의 파라미터와 일반 요구 프로퍼티의 기본값는 적절이라고 생각되는 값으로 설정됩니다. 이 인터페이스의 대부분의 클라이언트로 자주 사용되는 메서드는 getInputStream 메서드와 getContent 메서드의 2개 뿐입니다. 이것들은 URL 클래스의 편리한 메서드에 의해 밀러화 됩니다.

http 접속의 요구 프로퍼티와 헤더 필드의자세한 내용은 다음의 사이트를 참조하십시오.

 http://www.ietf.org/rfc/rfc2068.txt  

fileNameMap에 관한 주의: JDK 1.1. 6 보다 전의 버전에 서는 URLConnection fileNameMap 필드는 public 였습니다. JDK 1.1. 6 이후에서는 fileNameMap는 private 입니다. 이것에의 액세스에 액세스용 메서드로서 getFileNameMap, 변경용 메서드로서 setFileNameMap 가 추가되었습니다. 이 변경에 대해서는 호환성에 관한 페이지에도 설명이 있습니다. 요구 후에 URLConnection InputStream 또는 OutputStream에 대해서 close() 메서드를 호출하면, 이 인스턴스에 관련된 네트워크 자원이 해방되는 일이 있습니다. 다만, 특별한 프로토콜 사양에 의해 다른 동작이 가리키는 경우는 예외입니다.

도입된 버전 :

JDK1. 0

관련 항목:

URL.openConnection(), connect(), getContent(), getContentEncoding(), getContentLength(), getContentType(), getDate(), getExpiration(), getHeaderField(int), getHeaderField(java.lang.String), getInputStream(), getLastModified(), getOutputStream(), setAllowUserInteraction(boolean), setDefaultUseCaches(boolean), setDoInput(boolean), setDoOutput(boolean), setIfModifiedSince(long), setRequestProperty(java.lang.String, java.lang.String), setUseCaches(boolean)

필드 개요

protected boolean	allowUserInteraction true인 경우, 이 URL는 사용자와의 대화 처리 (인증 다이얼로그의 pop-up등)의 실행이 가능한 컨텍스트 으로 검사되고 있습니다.
protected boolean	connected false인 경우, 이 접속 객체는 지정된 URL 에의 통신 링크를 작성합니다.
protected boolean	doInput 이 변수를 설정하려면 setDoInput 메서드를 사용합니다.
protected boolean	doOutput 이 변수를 설정하려면 setDoOutput 메서드를 사용합니다.
protected long	ifModifiedSince 일부의 프로토콜에서는 특정의 시각보다 나중에 객체가 갱신되어 있지 않은 경우에 객체의 페치를 생략 할 수 있습니다 .
protected URL	url URL는 World Wide Web 상에 있는 리모트 객체를 나타냅니다.
protected boolean	useCaches true인 경우, 프로토콜은 가능한 때에 캐쉬내의 데이터를 사용할 수 있습니다 .

생성자 개요

protected

URLConnection (URL url) 지정된 URL 에의 URL 접속을 구축합니다.

메서드 개요

void	addRequestProperty (String key, String value) 키와 값의 페어에 의해 지정된 일반 요구 프로퍼티를 추가합니다.
abstract void	connect () 이 URL가 참조하는 자원에의 통신 링크를 확립합니다 (통신 링크가 확립되어 있지 않은 경우).
boolean	getAllowUserInteraction () 이 객체의 allowUserInteraction 필드값을 리턴합니다.
int	getConnectTimeout () 접속 타임 아웃의 설정을 리턴합니다.
Object	getContent () 이 URL 접속의 컨텐츠를 취득합니다.
Object	getContent (Class [] classes) 이 URL 접속의 컨텐츠를 취득합니다.
String	getContentEncoding () content-encoding 헤더 필드의 값을 리턴합니다.
int	getContentLength () content-length 헤더 필드의 값을 리턴합니다.
String	getContentType () content-type 헤더 필드의 값을 리턴합니다.
long	getDate () date 헤더 필드의 값을 리턴합니다.
static boolean	getDefaultAllowUserInteraction () allowUserInteraction 필드의 기본값을 리턴합니다.
static String	getDefaultRequestProperty (String key) 추천하지 않습니다. URLConnection 해당 인스턴스를 취득한 뒤는 인스턴스 고유의 getRequestProperty를 사용합니다.
boolean	getDefaultUseCaches () URLConnection useCaches 플래그의 기본값을 리턴합니다.
boolean	getDoInput () 이 URLConnection doInput 플래그의 값을 리턴합니다.
boolean	getDoOutput () 이 URLConnection doOutput 플래그의 값을 리턴합니다.
long	getExpiration () expires 헤더 필드의 값을 리턴합니다.
static FileNameMap	getFileNameMap () 데이터 파일로부터 파일명 맵 (mimetable)을 로드합니다.
String	getHeaderField (int n) n 번째의 헤더 필드의 값을 리턴합니다.
String	getHeaderField (String name) 지정된 헤더 필드의 값을 리턴합니다.
long	getHeaderFieldDate (String name, long Default) 지정된 필드를 날짜와 시간로서 구문 분석 한 값을 리턴합니다.
int	getHeaderFieldInt (String name, int Default) 지정된 필드를 수값으로 구문 분석 한 값을 리턴합니다.
String	getHeaderFieldKey (int n) n 번째의 헤더 필드의 키를 리턴합니다.
Map <String, List <String >>	getHeaderFields () 헤더 필드의 변경 불가능한 맵을 리턴합니다.
long	getIfModifiedSince () 이 객체의 ifModifiedSince 필드값을 리턴합니다.
InputStream	getInputStream () 이 접속으로부터의 입력을 받는 입력 스트림을 리턴합니다.
long	getLastModified () last-modified 헤더 필드의 값을 리턴합니다.
OutputStream	getOutputStream () 이 접속에 write를 실시하는 출력 스트림을 리턴합니다.
Permission	getPermission () 이 객체가 나타내는 접속의 실행에 필요한 접근 권한을 나타내는 Permission 객체를 리턴합니다.
int	getReadTimeout () 독해 타임 아웃의 설정을 리턴합니다.
Map <String, List <String >>	getRequestProperties () 이 접속의 일반 요구 프로퍼티의 변경 불가능한 맵을 리턴합니다.
String	getRequestProperty (String key) 이 접속의 지정된 일반 요구 프로퍼티의 값을 리턴합니다.
URL	getURL () 이 URLConnection URL 필드값을 리턴합니다.
boolean	getUseCaches () 이 URLConnection useCaches 필드값을 리턴합니다.
static String	guessContentTypeFromName (String fname) URL 지정된 「파일」컴퍼넌트를 기본으로 객체의 컨텐츠형을 추측합니다.
static String	guessContentTypeFromStream (InputStream is) 입력 스트림의 선두의 문자를 기본으로 입력 스트림의 종류의 결정을 시도합니다.
void	setAllowUserInteraction (boolean allowuserinteraction) 이 URLConnection allowUserInteraction 필드값을 설정합니다.
void	setConnectTimeout (int timeout) 이 URLConnection 로 참조되는 자원에의 통신 링크를 열 때 사용하는 지정된 타임 아웃치를, 밀리 세컨드 단위로 설정합니다.
static void	setContentHandlerFactory (ContentHandlerFactory fac) 어플리케이션의 ContentHandlerFactory를 설정합니다.
static void	setDefaultAllowUserInteraction (boolean defaultallowuserinteraction) 장래에 작성되는 모든 URLConnection 객체의 allowUserInteraction 필드에 도착해, 기본값이 지정된 값으로 설정합니다.
static void	setDefaultRequestProperty (String key, String value) 추천하지 않습니다. URLConnection 해당 인스턴스를 취득한 뒤는 인스턴스 고유의 setRequestProperty를 사용합니다. 이 메서드를 호출해도, 아무것도 행해지지 않습니다.
void	setDefaultUseCaches (boolean defaultusecaches) useCaches 필드의 기본값을, 지정된 값으로 설정합니다.
void	setDoInput (boolean doinput) 이 URLConnection doInput 필드값을 지정한 값으로 설정합니다.
void	setDoOutput (boolean dooutput) 이 URLConnection doOutput 필드의 값을 지정된 값으로 설정합니다.
static void	setFileNameMap (FileNameMap map) FileNameMap를 설정합니다.
void	setIfModifiedSince (long ifmodifiedsince) 이 URLConnection ifModifiedSince 필드값을, 지정된 값으로 설정합니다.
void	setReadTimeout (int timeout) 지정된 타임 아웃까지의 독해 타임 아웃을 밀리 세컨드 단위로 설정합니다.
void	setRequestProperty (String key, String value) 일반 요구 프로퍼티를 설정합니다.
void	setUseCaches (boolean usecaches) 이 URLConnection useCaches 필드를, 지정된 값으로 설정합니다.
String	toString () 이 URL 접속의 String 표현을 리턴합니다.

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

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

필드의 상세

url

protected URL  url

URL는 World Wide Web 상에 있는 리모트 객체를 나타냅니다. 이 리모트 객체에 대해서 접속을 엽니다.

이 필드의 값에 액세스 하려면, getURL 메서드를 사용합니다.

이 변수의 기본값는 URLConnection 생성자 URL 인수의 값입니다.

관련 항목:

getURL(), url

doInput

protected boolean doInput

이 변수를 설정하려면 setDoInput 메서드를 사용합니다. 이 변수의 값을 취득하려면 getDoInput 메서드를 사용합니다.

URL 접속을 사용해, 입력과 출력을 실시할 수 있습니다 . 어플리케이션으로 URL 접속으로부터 데이터의 독해를 실시하려면, doInput 플래그를 true로 설정합니다.

이 필드의 기본값는 true 입니다.

관련 항목:

getDoInput(), setDoInput(boolean)

doOutput

protected boolean doOutput

이 변수를 설정하려면 setDoOutput 메서드를 사용합니다. 이 변수치를 취득하려면 getDoOutput 메서드를 사용합니다.

URL 접속을 사용해, 입력이나 출력을 실시할 수 있습니다 . 어플리케이션으로 URL 접속에 write를 실시하는 경우는 doOutput 플래그를 true로 설정합니다.

이 필드의 기본값는 false 입니다.

관련 항목:

getDoOutput(), setDoOutput(boolean)

allowUserInteraction

protected boolean allowUserInteraction

true인 경우, 이 URL는 사용자와의 대화 처리 (인증 다이얼로그의 pop-up등)의 실행이 가능한 컨텍스트 으로 검사되고 있습니다. false인 경우, 사용자와의 대화 처리는 허가되지 않습니다.

이 필드의 값을 설정하려면 setAllowUserInteraction 메서드를 사용합니다. 이 필드의 값을 취득하려면 getAllowUserInteraction 메서드를 사용합니다. 이 필드의 기본값는 setDefaultAllowUserInteraction 메서드를 마지막으로 호출했을 때에 인수로 지정한 값입니다.

관련 항목:

getAllowUserInteraction(), setAllowUserInteraction(boolean), setDefaultAllowUserInteraction(boolean)

useCaches

protected boolean useCaches

true인 경우, 프로토콜은 가능한 때에 캐쉬내의 데이터를 사용할 수 있습니다 . false인 경우, 프로토콜은 항상 객체의 새로운 복사본을 취득할 필요가 있습니다.

이 필드값을 설정하려면 setUseCaches 메서드를 사용합니다. 이 필드값을 취득하려면 getUseCaches 메서드를 사용합니다.

이 필드의 기본값는 setDefaultUseCaches 메서드를 마지막으로 호출했을 때에 지정한 값입니다.

관련 항목:

setUseCaches(boolean), getUseCaches(), setDefaultUseCaches(boolean)

ifModifiedSince

protected long ifModifiedSince

일부의 프로토콜에서는 특정의 시각보다 나중에 객체가 갱신되어 있지 않은 경우에 객체의 페치를 생략 할 수 있습니다 .

0 이외의 값은 1970 년 1 월 1 일 GMT 로부터 기산한 밀리 세컨드수를 나타냅니다. 이 값보다 나중에 객체가 변경되고 있는 경우에만, 객체가 페치 됩니다.

이 변수를 설정하려면 setIfModifiedSince 메서드를 사용합니다. 이 변수치를 취득하려면 getIfModifiedSince 메서드를 사용합니다.

이 필드의 기본값는 0 (항상 객체를 페치 한다)입니다.

관련 항목:

getIfModifiedSince(), setIfModifiedSince(long)

connected

protected boolean connected

false인 경우, 이 접속 객체는 지정된 URL 에의 통신 링크를 작성합니다. true인 경우는 통신 링크가 확립되어 있습니다.

생성자 상세

URLConnection

protected URLConnection(URL  url)

지정된 URL 에의 URL 접속을 구축합니다. URL가 참조하는 객체에의 접속은 작성하지 않습니다.

파라미터:

url - 지정된 URL

메서드의 상세

getFileNameMap

public static FileNameMap  getFileNameMap()

데이터 파일로부터 파일명 맵 (mimetable)을 로드합니다. 최초로 "content.types.user.table" 프로퍼티로 정의된 사용자 지정 테이블을 로드하려고 합니다. 로드할 수 없었던 경우, lib/content-types.properties java 홈의 디폴트의 빌트인 테이블을 로드하려고 합니다.

반환값:

FileNameMap

도입된 버전 :

1.2

관련 항목:

setFileNameMap(java.net.FileNameMap)

setFileNameMap

public static void setFileNameMap(FileNameMap  map)

FileNameMap를 설정합니다.

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

파라미터:

map - 설정하는 FileNameMap

예외:

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

도입된 버전 :

1.2

관련 항목:

SecurityManager.checkSetFactory(), getFileNameMap()

connect

public abstract void connect()
                      throws IOException 

이 URL가 참조하는 자원에의 통신 링크를 확립합니다 (통신 링크가 확립되어 있지 않은 경우).

connect 메서드를 호출했을 때에 접속이 이미 확립되어 있으면 (connected 필드의 값이 true 이면), 메서드 호출은 무시됩니다.

URLConnection 객체는 2개의 단계를 밟습니다. 최초로 객체가 작성되어 그 후 접속이 확립됩니다. 작성 후, 접속을 확립하기 전에 다양한 옵션 (doInput 나 UseCaches 등)을 지정할 수 있습니다 . 접속 후에 이러한 옵션을 설정하려고 하면 에러가 됩니다. 접속에 의존된 조작 (getContentLength 등)을 실시하면, 필요에 따라서 접속이 암묵적으로 확립됩니다.

예외:

SocketTimeoutException - 접속을 확립하기 전에 타임 아웃이 되었을 경우

IOException - 접속의 확립중에 입출력 에러가 발생했을 경우

관련 항목:

connected, getConnectTimeout(), setConnectTimeout(int)

setConnectTimeout

public void setConnectTimeout(int timeout)

이 URLConnection 로 참조되는 자원에의 통신 링크를 열 때 사용하는 지정된 타임 아웃치를, 밀리 세컨드 단위로 설정합니다. 접속을 확립하기 전에 타임 아웃이 되는 경우, java.net.SocketTimeoutException가 발생 됩니다. 타임 아웃에 0을 지정하면, 타임 아웃은 무한이라고 해석됩니다.

이 메서드의 몇개의 비표준 구현에서는 지정된 타임 아웃이 무시되는 일이 있습니다. 접속 타임 아웃의 설정을 확인하려면, getConnectTimeout()를 호출해 주세요.

파라미터:

timeout - 접속 타임 아웃치를 밀리 세컨드 단위로 지정하는 int

예외:

IllegalArgumentException - 타임 아웃 파라미터가 부의 경우

도입된 버전 :

1.5

관련 항목:

getConnectTimeout(), connect()

getConnectTimeout

public int getConnectTimeout()

접속 타임 아웃의 설정을 리턴합니다.

이 옵션이 무효 (타임 아웃이 무한)의 경우는 0을 리턴합니다.

반환값:

접속 타임 아웃치를 밀리 세컨드 단위로 가리키는 int

도입된 버전 :

1.5

관련 항목:

setConnectTimeout(int), connect()

setReadTimeout

public void setReadTimeout(int timeout)

지정된 타임 아웃까지의 독해 타임 아웃을 밀리 세컨드 단위로 설정합니다. 0 이외의 값은 자원에의 접속이 확립되었을 때에 입력 스트림로부터 읽어낼 때의 타임 아웃을 지정합니다. 데이터를 읽어낼 준비를 할 수 있기 전에 타임 아웃이 되는 경우, java.net.SocketTimeoutException가 발생 됩니다. 타임 아웃에 0을 지정하면, 타임 아웃은 무한이라고 해석됩니다.

이 메서드의 몇개의 비표준 구현에서는 지정된 타임 아웃이 무시되는 일이 있습니다. 독해 타임 아웃의 설정을 확인하려면, getReadTimeout()을 호출해 주세요.

파라미터:

timeout - 사용하는 타임 아웃치를 밀리 세컨드 단위로 지정하는 int

예외:

IllegalArgumentException - 타임 아웃 파라미터가 부의 경우

도입된 버전 :

1.5

관련 항목:

getReadTimeout(), InputStream.read()

getReadTimeout

public int getReadTimeout()

독해 타임 아웃의 설정을 리턴합니다. 이 옵션이 무효 (타임 아웃이 무한)의 경우는 0을 리턴합니다.

반환값:

독해 타임 아웃치를 밀리 세컨드 단위로 가리키는 int

도입된 버전 :

1.5

관련 항목:

setReadTimeout(int), InputStream.read()

getURL

public URL  getURL()

이 URLConnection URL 필드값을 리턴합니다.

반환값:

이 URLConnection URL 필드값

관련 항목:

url

getContentLength

public int getContentLength()

content-length 헤더 필드의 값을 리턴합니다.

반환값:

이 접속의 URL가 참조하는 자원의 컨텐츠 사이즈. 사이즈가 불명의 경우는 -1

getContentType

public String  getContentType()

content-type 헤더 필드의 값을 리턴합니다.

반환값:

URL가 참조하는 자원의 컨텐츠 형식. 불명의 경우는 null

관련 항목:

getHeaderField(java.lang.String)

getContentEncoding

public String  getContentEncoding()

content-encoding 헤더 필드의 값을 리턴합니다.

반환값:

URL가 참조하는 자원의 컨텐츠의 encode. 불명의 경우는 null

관련 항목:

getHeaderField(java.lang.String)

getExpiration

public long getExpiration()

expires 헤더 필드의 값을 리턴합니다.

반환값:

이 URL가 참조하는 자원의 유효기간. 불명의 경우는 0. 값은 그리니지 표준시 1970 년 1 월 1 일부터 기산한 밀리 세컨드수

관련 항목:

getHeaderField(java.lang.String)

getDate

public long getDate()

date 헤더 필드의 값을 리턴합니다.

반환값:

URL가 참조하는 자원의 송신일. 불명의 경우는 0. 반환값은 그리니지 표준시 1970 년 1 월 1 일부터 기산한 밀리 세컨드수

관련 항목:

getHeaderField(java.lang.String)

getLastModified

public long getLastModified()

last-modified 헤더 필드의 값을 리턴합니다. 값은 그리니지 표준시 1970 년 1 월 1 일부터 기산한 밀리 세컨드 수라고의해 리턴됩니다 .

반환값:

이 URLConnection가 참조하는 자원이 변경된 날짜와 시간. 불명의 경우는 0

관련 항목:

getHeaderField(java.lang.String)

getHeaderField

public String  getHeaderField(String  name)

지정된 헤더 필드의 값을 리턴합니다.

같은 헤더를 다른 값으로 여러 차례 설정할 가능성이 있는 접속으로 호출되는 경우는 마지막 값만이 리턴됩니다 .

파라미터:

name - 헤더 필드의 이름

반환값:

지정된 헤더 필드의 이름. 지정된 이름을 가지는 필드가 헤더내에 없는 경우는 null

getHeaderFields

public Map <String,
List <String >> getHeaderFields()

헤더 필드의 변경 불가능한 맵을 리턴합니다. 맵 키는 응답 헤더의 필드명을 나타내는 Strings 입니다. 각 맵치는 대응하는 필드값을 나타내는 변경 불가능한 Strings 리스트입니다.

반환값:

헤더 필드의 맵

도입된 버전 :

1.4

getHeaderFieldInt

public int getHeaderFieldInt(String  name,
                             int Default)

지정된 필드를 수값으로 구문 분석 한 값을 리턴합니다.

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

파라미터:

name - 헤더 필드의 이름

Default - 기본값

반환값:

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

getHeaderFieldDate

public long getHeaderFieldDate(String  name,
                               long Default)

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

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

파라미터:

name - 헤더 필드의 이름

Default - 기본값

반환값:

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

getHeaderFieldKey

public String  getHeaderFieldKey(int n)

n 번째의 헤더 필드의 키를 리턴합니다. 필드의 수가 n+1 개보다 적은 경우는 null을 리턴합니다.

파라미터:

n - 인덱스 (n>=0)

반환값:

n 번째의 헤더 필드의 키. 필드의 수가 n+1 개보다 적은 경우는 null

getHeaderField

public String  getHeaderField(int n)

n 번째의 헤더 필드의 값을 리턴합니다. 필드의 수가 n+1 개보다 적은 경우는 null을 리턴합니다.

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

파라미터:

n - 인덱스 (n>=0)

반환값:

n 번째의 헤더 필드의 값. 필드의 수가 n+1 개보다 적은 경우는 null

관련 항목:

getHeaderFieldKey(int)

getContent

public Object  getContent()
                  throws IOException 

이 URL 접속의 컨텐츠를 취득합니다.

이 메서드에서는 최초로 getContentType 메서드를 호출해, 객체의 정보의 종류를 판별합니다. 어플리케이션으로 그 종류의 내용을 보는 것이 처음의 경우는 그 종류의 정보 헤더가 작성됩니다.

1. 어플리케이션으로 setContentHandlerFactory 메서드를 사용해 ContentHandler 팩토리의 인스턴스가 셋업 되고 있는 경우는 그 인스턴스의 createContentHandler 메서드를 호출해, 내용의 종류를 인수로서 건네준다. 그 결과, 그 내용의 종류의 ContentHandler가 리턴된다
2. ContentHandler 팩토리가 셋업되어 있지 않은 경우, 또는 팩토리의 createContentHandler 메서드가 null을 돌려주는 경우, 어플리케이션은 다음의 이름의 클래스를 로드한다

    sun.net.www.content. <contentType>

   <contentType> 는 내용의 종류를 나타내는 캐릭터 라인의 slash 문자를 모두 피리어드 ( 「.」)에 치환해, 알파벳 이외의 모든 문자를 밑줄 문자 「_」에 치환하는 것에 의해 생성된다. 알파벳 문자란 26개의 대문자의 ASCII 문자 ( 「A」로부터 「Z」까지), 26개의 소문자의 ASCII 문자 ( 「a」로부터 「z」까지 및 10개의 ASCII 숫자 ( 「0」으로부터 「9」까지)를 나타낸다. 지정한 클래스가 존재하지 않는 경우, 또는 ContentHandler 서브 클래스가 아닌 경우는 UnknownServiceException가 Throw 된다

반환값:

페치 한 객체. 리턴된 객체의 종류를 조사하려면, instanceof 연산자를 사용한다

예외:

IOException - 컨텐츠의 취득중에 입출력 에러가 발생했을 경우

UnknownServiceException - 프로토콜이 그 컨텐츠 형식을 지원 하고 있지 않는 경우

관련 항목:

ContentHandlerFactory.createContentHandler(java.lang.String), getContentType(), setContentHandlerFactory(java.net.ContentHandlerFactory)

getContent

public Object  getContent(Class [] classes)
                  throws IOException 

이 URL 접속의 컨텐츠를 취득합니다.

파라미터:

classes - 요구된 형태를 나타내는 Class 배열

반환값:

클래스의 배열로 지정된 형태가 최초로 일치한, 페치 한 객체. 요구된 형태가 지원 되어 있지 않은 경우는 null. 리턴된 객체의 종류를 조사하려면, instanceof 연산자를 사용한다

예외:

IOException - 컨텐츠의 취득중에 입출력 에러가 발생했을 경우

UnknownServiceException - 프로토콜이 그 컨텐츠 형식을 지원 하고 있지 않는 경우

관련 항목:

getContent(), ContentHandlerFactory.createContentHandler(java.lang.String), getContent(java.lang.Class[]), setContentHandlerFactory(java.net.ContentHandlerFactory)

getPermission

public Permission  getPermission()
                         throws IOException 

이 객체가 나타내는 접속의 실행에 필요한 접근 권한을 나타내는 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 접속에서는 데이터의 최종적인 입수처가 되는 호스트에게 접속하기 위한 접근 권한을 나타냅니다. 후자의 경우, 접근 권한은 접속의 「전」에 취득 및 테스트됩니다.

반환값:

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

예외:

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

getInputStream

public InputStream  getInputStream()
                           throws IOException 

이 접속으로부터의 입력을 받는 입력 스트림을 리턴합니다. 리턴된 입력 스트림로부터의 독해때, 데이터의 독해 준비를 할 수 있기 전에 읽어내 타임 아웃이 경과하면, SocketTimeoutException가 발생되는 일이 있습니다.

반환값:

이 접속으로부터의 입력을 받는 입력 스트림

예외:

IOException - 입력 스트림의 작성중에 입출력 에러가 발생했을 경우

UnknownServiceException - 프로토콜이 입력을 지원 하고 있지 않는 경우

관련 항목:

setReadTimeout(int), getReadTimeout()

getOutputStream

public OutputStream  getOutputStream()
                             throws IOException 

이 접속에 write를 실시하는 출력 스트림을 리턴합니다.

반환값:

이 접속에 write를 실시하는 출력 스트림

예외:

IOException - 출력 스트림의 작성중에 입출력 에러가 발생했을 경우

UnknownServiceException - 프로토콜이 출력을 지원 하고 있지 않는 경우

toString

public String  toString()

이 URL 접속의 String 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 URLConnection 캐릭터 라인 표현

setDoInput

public void setDoInput(boolean doinput)

이 URLConnection doInput 필드값을 지정한 값으로 설정합니다.

URL 접속을 입출력에 사용할 수 있습니다. URL 접속을 사용해 입력을 실시하는 경우에는 DoInput 플래그를 true 로 설정합니다. 출력을 실시하는 경우에는 false 로 설정합니다. 기본값는 true 입니다.

파라미터:

doinput - 새로운 값

예외:

IllegalStateException - 이미 접속되고 있는 경우

관련 항목:

doInput, getDoInput()

getDoInput

public boolean getDoInput()

이 URLConnection doInput 플래그의 값을 리턴합니다.

반환값:

이 URLConnection doInput 플래그의 값

관련 항목:

setDoInput(boolean)

setDoOutput

public void setDoOutput(boolean dooutput)

이 URLConnection doOutput 필드의 값을 지정된 값으로 설정합니다.

URL 접속을 입출력에 사용할 수 있습니다. URL 접속을 사용해 출력을 실시하는 경우에는 DoOutput 플래그를 true 로 설정합니다. 입력을 실시하는 경우에는 false 로 설정합니다. 기본값는 false 입니다.

파라미터:

dooutput - 새로운 값

예외:

IllegalStateException - 이미 접속되고 있는 경우

관련 항목:

getDoOutput()

getDoOutput

public boolean getDoOutput()

이 URLConnection doOutput 플래그의 값을 리턴합니다.

반환값:

이 URLConnection doOutput 플래그의 값

관련 항목:

setDoOutput(boolean)

setAllowUserInteraction

public void setAllowUserInteraction(boolean allowuserinteraction)

이 URLConnection allowUserInteraction 필드값을 설정합니다.

파라미터:

allowuserinteraction - 새로운 값

예외:

IllegalStateException - 이미 접속되고 있는 경우

관련 항목:

getAllowUserInteraction()

getAllowUserInteraction

public boolean getAllowUserInteraction()

이 객체의 allowUserInteraction 필드값을 리턴합니다.

반환값:

이 객체의 allowUserInteraction 필드값

관련 항목:

setAllowUserInteraction(boolean)

setDefaultAllowUserInteraction

public static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)

장래에 작성되는 모든 URLConnection 객체의 allowUserInteraction 필드에 도착해, 기본값이 지정된 값으로 설정합니다.

파라미터:

defaultallowuserinteraction - 새로운 값

관련 항목:

getDefaultAllowUserInteraction()

getDefaultAllowUserInteraction

public static boolean getDefaultAllowUserInteraction()

allowUserInteraction 필드의 기본값을 리턴합니다.

기본값는 「sticky」(모든 URLConnection 정적인 상태의 일부)입니다. 이 플래그는 이후에 작성되는 모든 URLConnection 객체에 적용됩니다.

반환값:

allowUserInteraction 필드의 기본값

관련 항목:

setDefaultAllowUserInteraction(boolean)

setUseCaches

public void setUseCaches(boolean usecaches)

이 URLConnection useCaches 필드를, 지정된 값으로 설정합니다.

일부의 프로토콜은 문서를 캐쉬합니다. 그러나, 경우에 따라서는 캐쉬를 무시해 정보를 전송 하는 (브라우저의 「다시 읽기」버튼) 일이 중요한 일도 있습니다. 접속의 UseCaches 플래그가 true인 경우, 그 접속에서는 캐쉬를 사용할 수 있습니다 . 이 플래그가 false인 경우, 캐쉬는 무시됩니다. 기본값는 DefaultUseCaches 값에 의해 정해집니다만, DefaultUseCaches 기본값는 true 입니다.

파라미터:

usecaches - 캐쉬에의 출력이 가능한가 어떤가를 나타내는 boolean 치

예외:

IllegalStateException - 이미 접속되고 있는 경우

관련 항목:

getUseCaches()

getUseCaches

public boolean getUseCaches()

이 URLConnection useCaches 필드값을 리턴합니다.

반환값:

이 URLConnection useCaches 필드값

관련 항목:

setUseCaches(boolean)

setIfModifiedSince

public void setIfModifiedSince(long ifmodifiedsince)

이 URLConnection ifModifiedSince 필드값을, 지정된 값으로 설정합니다.

파라미터:

ifmodifiedsince - 새로운 값

예외:

IllegalStateException - 이미 접속되고 있는 경우

관련 항목:

getIfModifiedSince()

getIfModifiedSince

public long getIfModifiedSince()

이 객체의 ifModifiedSince 필드값을 리턴합니다.

반환값:

이 객체의 ifModifiedSince 필드값

관련 항목:

setIfModifiedSince(long)

getDefaultUseCaches

public boolean getDefaultUseCaches()

URLConnection useCaches 플래그의 기본값을 리턴합니다.

기본값는 「sticky」(모든 URLConnection 정적인 상태의 일부)입니다. 이 플래그는 이후에 작성되는 모든 URLConnection 객체에 적용됩니다.

반환값:

URLConnection useCaches 플래그의 기본값

관련 항목:

setDefaultUseCaches(boolean)

setDefaultUseCaches

public void setDefaultUseCaches(boolean defaultusecaches)

useCaches 필드의 기본값을, 지정된 값으로 설정합니다.

파라미터:

defaultusecaches - 새로운 값

관련 항목:

getDefaultUseCaches()

setRequestProperty

public void setRequestProperty(String  key,
                               String  value)

일반 요구 프로퍼티를 설정합니다. 키를 가지는 프로퍼티가 이미 존재하는 경우는 그 값을 새로운 값으로 덧쓰기합니다.

주: 복수의 프로퍼티를 하나의 프로퍼티에 부가할 수 있도록 하는 콤마로 단락지어진 리스트 구문을 사용하기 위해서 HTTP는 같은 키로 복수의 인스턴스를 정당하게 가질 수 있는 요구 프로퍼티를 모두 필요로 합니다.

파라미터:

key - 요구를 식별하는 키워드 ( 「accept」 등)

value - 키워드에 관련한 값

예외:

IllegalStateException - 이미 접속되고 있는 경우

NullPointerException - 키가 null인 경우

관련 항목:

getRequestProperty(java.lang.String)

addRequestProperty

public void addRequestProperty(String  key,
                               String  value)

키와 값의 페어에 의해 지정된 일반 요구 프로퍼티를 추가합니다. 이 메서드는 같은 키에 관련한 기존의 값은 덧쓰기하지 않습니다.

파라미터:

key - 요구를 식별하는 키워드 ( 「accept」 등)

value - 키워드에 관련한 값

예외:

IllegalStateException - 이미 접속되고 있는 경우

NullPointerException - 키가 null인 경우

도입된 버전 :

1.4

관련 항목:

getRequestProperties()

getRequestProperty

public String  getRequestProperty(String  key)

이 접속의 지정된 일반 요구 프로퍼티의 값을 리턴합니다.

파라미터:

key - 요구를 식별하는 키워드 ( 「accept」 등)

반환값:

이 접속의 지정된 일반 요구 프로퍼티의 값. 키가 null인 경우는 null이 리턴된다

예외:

IllegalStateException - 이미 접속되고 있는 경우

관련 항목:

setRequestProperty(java.lang.String, java.lang.String)

getRequestProperties

public Map <String,
List <String >> getRequestProperties()

이 접속의 일반 요구 프로퍼티의 변경 불가능한 맵을 리턴합니다. 맵 키는 요구 헤더의 필드명을 나타내는 Strings 입니다. 각 맵치는 대응하는 필드값을 나타내는 변경 불가능한 Strings 리스트입니다.

반환값:

이 접속의 일반 요구 프로퍼티의 맵

예외:

IllegalStateException - 이미 접속되고 있는 경우

도입된 버전 :

1.4

setDefaultRequestProperty

@Deprecated 
public static void setDefaultRequestProperty(String  key,
                                                        String  value)

추천하지 않습니다. URLConnection 해당 인스턴스를 취득한 뒤는 인스턴스 고유의 setRequestProperty를 사용합니다. 이 메서드를 호출해도, 아무것도 행해지지 않습니다.

일반 요구 프로퍼티의 기본값을 설정합니다. URLConnection는 작성시에 이러한 값을 사용해 초기화됩니다.

파라미터:

key - 요구를 식별하는 키워드 ( 「accept」 등)

value - 키워드에 관련한 값

관련 항목:

setRequestProperty(java.lang.String, java.lang.String), getDefaultRequestProperty(java.lang.String)

getDefaultRequestProperty

@Deprecated 
public static String  getDefaultRequestProperty(String  key)

추천하지 않습니다. URLConnection 해당 인스턴스를 취득한 뒤는 인스턴스 고유의 getRequestProperty를 사용합니다.

디폴트의 요구 프로퍼티치를 리턴합니다. 디폴트의 요구 프로퍼티는 모든 접속으로 설정되어 있습니다.

파라미터:

key - 요구를 식별하는 키워드 ( 「accept」 등)

반환값:

지정된 키의 디폴트의 일반 프로퍼티치

관련 항목:

getRequestProperty(java.lang.String), setDefaultRequestProperty(java.lang.String, java.lang.String)

setContentHandlerFactory

public static void setContentHandlerFactory(ContentHandlerFactory  fac)

어플리케이션의 ContentHandlerFactory를 설정합니다. 어플리케이션에서는 최대로 1회 호출할 수 있습니다 .

컨텐츠의 종류를 기본으로 ContentHandler를 구축하려면 ContentHandlerFactory가 사용됩니다.

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

파라미터:

fac - 목적의 팩토리

예외:

Error - 팩토리가 이미 정의되고 있는 경우

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

관련 항목:

ContentHandlerFactory, getContent(), SecurityManager.checkSetFactory()

guessContentTypeFromName

public static String  guessContentTypeFromName(String  fname)

URL 지정된 「파일」컴퍼넌트를 기본으로 객체의 컨텐츠형을 추측합니다. 이 메서드는 getContentType 메서드를 오버라이드(override) 하는 서브 클래스에서 사용하면 편리합니다.

파라미터:

fname - 파일명

반환값:

파일명을 기본으로 추측한 객체의 컨텐츠형

관련 항목:

getContentType()

guessContentTypeFromStream

public static String  guessContentTypeFromStream(InputStream  is)
                                         throws IOException 

입력 스트림의 선두의 문자를 기본으로 입력 스트림의 종류의 결정을 시도합니다. 이 메서드는 getContentType 메서드를 오버라이드(override) 하는 서브 클래스에서 사용할 수 있습니다 .

이상적인 상태에서는 이 루틴은 필요 없습니다. 그러나, 컨텐츠형으로서 부정한 값을 돌려주는 http 서버는 많이 있습니다. 게다가 표준적이 아닌 확장자(extension)도 많이 있습니다. 이 때문에 http 서버가 돌려주는 컨텐츠형을 그대로 받아들이는 것보다도, 데이터를 기본으로 컨텐츠형을 직접 추측한 (분)편이 정확한 경우가 자주 있습니다.

파라미터:

is - 지원가 마크 하는 입력 스트림

반환값:

추측한 컨텐츠형. 추측할 수 없는 경우는 null

예외:

IOException - 입력 스트림의 독해중에 입출력 에러가 발생했을 경우

관련 항목:

InputStream.mark(int), InputStream.markSupported(), getContentType()