java.net
클래스 URLConnection

java.lang.Object 
  |
  +--java.net.URLConnection

직계의 기존의 서브 클래스:

HttpURLConnection , JarURLConnection

public abstract class URLConnection

extends Object

추상 클래스 URLConnection 는 어플리케이션과 URL 와의 사이의 통신 링크를 나타내는 모든 클래스의 슈퍼 클래스입니다. 이 클래스의 인스턴스를 사용해, URL 로 참조하는 리소스의 read와 기입의 양쪽 모두를 실시할 수가 있습니다. 일반적으로, 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 필드치를 돌려줍니다.
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 () 데이터 파일로부터 파일명 MAP (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	getHeaderFields () 헤더 필드의 변경 불가능한 MAP를 돌려줍니다.
long	getIfModifiedSince () 이 오브젝트의 ifModifiedSince 필드치를 돌려줍니다.
InputStream	getInputStream () 이 접속으로부터의 입력을 받는 입력 스트림을 돌려줍니다.
long	getLastModified () last-modified 헤더 필드의 값을 돌려줍니다.
OutputStream	getOutputStream () 이 접속에 기입을 실시하는 출력 스트림을 돌려줍니다.
Permission	getPermission () 이 오브젝트가 나타내는 접속의 실행에 필요한 액세스권을 나타내는 Permission 오브젝트를 돌려줍니다.
Map	getRequestProperties () 이 접속의 일반 요구 프로퍼티의 변경 불가능한 MAP를 돌려줍니다.
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 필드치를 설정합니다.
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	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 constructor 의 URL 인수의 값입니다.

관련 항목:

getURL() , url

doInput

protected boolean doInput

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

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

이 필드의 디폴트 값은 true 입니다.

관련 항목:

getDoInput() , setDoInput(boolean)

doOutput

protected boolean doOutput

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

URL 접속을 사용해, 입력이나 출력을 실시할 수가 있습니다. 어플리케이션으로 URL 접속에 기입을 실시하는 경우는 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

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

제로 이외의 값은 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()

데이터 파일로부터 파일명 MAP (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 등)을 실시하면, 필요에 따라서 접속이 암묵적으로 확립됩니다.

예외:

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

관련 항목:

connected

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  getHeaderFields()

헤더 필드의 변경 불가능한 MAP를 돌려줍니다. MAP 키는 응답 헤더의 필드명을 나타내는 Strings 입니다. 각 MAP치는 대응하는 필드치를 나타내는 변경 불가능한 Strings 의 리스트입니다.

반환값:

헤더 필드의 MAP

도입된 버젼:

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 - 인덱스

반환값:

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

getHeaderField

public String  getHeaderField(int n)

n 번째의 헤더 필드의 값을 돌려줍니다. 필드의 수가 n 개보다 적은 경우는 null 를 돌려줍니다.

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

파라미터:

n - 인덱스

반환값:

n 번째의 헤더 필드의 값

관련 항목:

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 가 슬로우 된다

반환값:

취득한 오브젝트. 돌려주어진 오브젝트의 종류를 조사하려면 ,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 

이 접속으로부터의 입력을 받는 입력 스트림을 돌려줍니다.

반환값:

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

예외:

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

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

getOutputStream

public OutputStream  getOutputStream()
                             throws IOException 

이 접속에 기입을 실시하는 출력 스트림을 돌려줍니다.

반환값:

이 접속에 기입을 실시하는 출력 스트림

예외:

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(java.lang.String)

getRequestProperty

public String  getRequestProperty(String  key)

이 접속의 지정된 일반 요구 프로퍼티의 값을 돌려줍니다.

파라미터:

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

반환값:

이 접속의 지정된 일반 요구 프로퍼티의 값. 키가 null 의 경우는 null 가 돌려주어진다

예외:

IllegalStateException - 벌써 접속되고 있는 경우

관련 항목:

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

getRequestProperties

public Map  getRequestProperties()

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

반환값:

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

예외:

IllegalStateException - 벌써 접속되고 있는 경우

도입된 버젼:

1.4

setDefaultRequestProperty

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

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) 하는 서브 클래스에서 사용할 수가 있습니다.

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

파라미터:

is - 서포트가 마크 하는 입력 스트림

반환값:

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

예외:

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

관련 항목:

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