java.net
클래스 URLStreamHandler

java.lang.Object 
  java.net.URLStreamHandler

public abstract class URLStreamHandler
extends Object 

abstract 클래스 URLStreamHandler 는, 모든 스트림 프로토콜 핸들러에 공통의 슈퍼 클래스입니다. 스트림 프로토콜 핸들러는,http,ftp,gopher 등, 특정의 프로토콜 타입에서의 접속의 확립 방법을 알고 있습니다.

대부분의 경우,URLStreamHandler 서브 클래스의 인스턴스가 어플리케이션에 의해 직접 작성될 것은 없습니다. 그렇지 않고,URL 구축시에 프로토콜명이 처음으로 검출되었을 때에, 적절한 스트림 프로토콜 핸들러가 자동적으로 로드 됩니다.

도입된 버젼:

JDK1. 0

관련 항목:

URL.URL(java.lang.String, java.lang.String, int, java.lang.String)

생성자 의 개요

URLStreamHandler ()

메소드의 개요

protected boolean	equals (URL u1, URL u2) 디폴트의 등가 계산을 제공합니다.
protected int	getDefaultPort () 이 핸들러가 구문 분석 하는 URL 의 디폴트의 포트를 돌려줍니다.
protected InetAddress	getHostAddress (URL u) 호스트의 IP 주소를 가져옵니다.
protected int	hashCode (URL u) 디폴트의 해시 계산을 제공합니다.
protected boolean	hostsEqual (URL u1, URL u2) 2 개의 URL 의 호스트 컴퍼넌트를 비교합니다.
protected abstract URLConnection	openConnection (URL u) URL 인수에 의해 참조되는 객체에의 접속을 오픈합니다.
protected URLConnection	openConnection (URL u, Proxy p) openConnection(URL)와 거의 같습니다만, 접속의 확립이 지정된 프록시 경유로 행해지는 점이 다릅니다.
protected void	parseURL (URL u, String spec, int start, int limit) URL 의 캐릭터 라인 표현을 구문 분석 해,URL 객체로 변환합니다.
protected boolean	sameFile (URL u1, URL u2) 2 개의 URL 를 비교해, 양자가 같은 파일을 참조하고 있을지 어떨지, 즉 같은 프로토콜, 호스트, 포트, 및 패스를 가질지 어떨지를 확인합니다.
protected void	setURL (URL u, String protocol, String host, int port, String file, String ref) 추천 되고 있지 않습니다. setURL(URL, String, int, String, String, String, String)를 사용해 주세요.
protected void	setURL (URL u, String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref) URL 인수의 각 필드가 지정된 값으로 설정합니다.
protected String	toExternalForm (URL u) 특정의 프로토콜의 URL 를 String 로 변환합니다.

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

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

생성자 의 상세

URLStreamHandler

public URLStreamHandler()

메소드의 상세

openConnection

protected abstract URLConnection  openConnection(URL  u)
                                         throws IOException 

URL 인수에 의해 참조되는 객체에의 접속을 오픈합니다. 서브 클래스는 이 메소드를 오버라이드(override) 할 필요가 있습니다.

HTTP 나 JAR 라고 하는 핸들러의 프로토콜 마다 일반 또는 특수한 URLConnection 서브 클래스가 존재하고 있어, 그 서브 클래스는 다음의 패키지 또는 그 서브 패키지의 어느 쪽인가에 속합니다. java.lang, java.io, java.util, java.net. 반환되는 접속의 형태는, 그 서브 클래스가 됩니다. 예를 들어, HTTP 의 경우는 HttpURLConnection 가 돌려주어져 JAR 의 경우는 JarURLConnection 가 돌려주어집니다.

파라미터:

u - 접속처의 URL

반환값:

URL 에의 URLConnection 객체

예외:

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

openConnection

protected URLConnection  openConnection(URL  u,
                                       Proxy  p)
                                throws IOException 

openConnection(URL)와 거의 같습니다만, 접속의 확립이 지정된 프록시 경유로 행해지는 점이 다릅니다. 프록시 처리를 지원하지 않는 프로토콜 핸들러는, 프록시의 파라미터를 무시해, 일반적으로의 접속을 확립합니다. 이 메소드를 호출하면(자), 시스템의 디폴트의 ProxySelector 설정이 횡령됩니다.

파라미터:

u - 접속처의 URL

p - 접속의 확립에 사용되는 프록시. 직접 접속을 실시하고 싶은 경우는 Proxy.NO_PROXY 를 지정해야 한다

반환값:

URL 에의 URLConnection 객체

예외:

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

IllegalArgumentException - u, p 중 한쪽이 null 인지, p 의 형태가 올바르지 않은 경우

UnsupportedOperationException - 프로토콜을 구현하는 서브 클래스가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.5

parseURL

protected void parseURL(URL  u,
                        String  spec,
                        int start,
                        int limit)

URL 의 캐릭터 라인 표현을 구문 분석 해,URL 객체로 변환합니다.

상속되는 패스가 있는 경우는,URL 인수에 벌써 카피되고 있습니다.

URLStreamHandler 의 parseURL 메소드는, 캐릭터 라인 표현을 http 지정으로 간주해 구문 분석 합니다. URL 프로토콜 패밀리의 대부분에서는, 유사한 구문 분석을 합니다. 다른 구문을 가지는 프로토콜의 스트림 프로토콜 핸들러는, 이 루틴을 오버라이드(override) 할 필요가 있습니다.

파라미터:

u - 지정의 구문 분석 결과를 받는 URL

spec - 구문 분석 해야 할 URL 를 나타내는 String

start - 구문 분석의 개시 위치를 나타내는 문자 인덱스. 이것은 프로토콜명의 확정을 나타내는 「:」(존재하는 경우)의 직후에 오는

limit - 구문 분석을 종료해야 할 문자 위치. 이것은 캐릭터 라인의 말미가 된다. 다만, 「#」문자가 존재하는 경우는 그 위치가 된다. 샤프 기호의 뒤에 있는 정보는 모두, 엥커를 나타낸다

getDefaultPort

protected int getDefaultPort()

이 핸들러가 구문 분석 하는 URL 의 디폴트의 포트를 돌려줍니다. 이 메소드는, 디폴트의 포트 번호에 근거해 핸들러에 의해 오버라이드(override) 되는 것을 전제로 만들어지고 있습니다.

반환값:

이 핸들러가 구문 분석 하는 URL 의 디폴트의 포트

도입된 버젼:

1.3

equals

protected boolean equals(URL  u1,
                         URL  u2)

디폴트의 등가 계산을 제공합니다. equals()에 대해서 다른 요건을 가지는 것 외의 프로토콜의 핸들러는, 이것을 오버라이드(override) 할 수가 있습니다. 이 메소드는, 인수가 모두 null 가 아닌 것이 필요합니다. java.net.URL 클래스만이 이 메소드를 호출하기 (위해)때문에, 이것은 보증되고 있습니다.

파라미터:

u1 - URL 객체

u2 - URL 객체

반환값:

2 개의 URL 가 동일하다고 보였을 경우, 즉 양자가 동일 파일내의 동일 fragment를 참조하고 있는 경우는 true

도입된 버젼:

1.3

hashCode

protected int hashCode(URL  u)

디폴트의 해시 계산을 제공합니다. hashCode 계산에 대해서 다른 요건을 가지는 것 외의 프로토콜의 핸들러는, 이것을 오버라이드(override) 할 수가 있습니다.

파라미터:

u - URL 객체

반환값:

해시 테이블의 인덱스부에 적절한 int

도입된 버젼:

1.3

sameFile

protected boolean sameFile(URL  u1,
                           URL  u2)

2 개의 URL 를 비교해, 양자가 같은 파일을 참조하고 있을지 어떨지, 즉 같은 프로토콜, 호스트, 포트, 및 패스를 가질지 어떨지를 확인합니다. 이 메소드는, 어느 쪽의 인수도 null 가 아닌 것을 필요로 합니다. java.net.URL 클래스만이 이 메소드를 호출하기 (위해)때문에, 이것은 보증되고 있습니다.

파라미터:

u1 - URL 객체

u2 - URL 객체

반환값:

URL1 와 URL2 가 같은 파일을 참조하는 경우, true

도입된 버젼:

1.3

getHostAddress

protected InetAddress  getHostAddress(URL  u)

호스트의 IP 주소를 가져옵니다. 호스트 필드가 빈 상태(empty)일까 DNS 로 문제가 발생했을 경우에는, null 가 돌려주어집니다.

파라미터:

u - URL 객체

반환값:

호스트의 IP 주소를 나타내는 InetAddress

도입된 버젼:

1.3

hostsEqual

protected boolean hostsEqual(URL  u1,
                             URL  u2)

2 개의 URL 의 호스트 컴퍼넌트를 비교합니다.

파라미터:

u1 - 비교하는 최초의 호스트의 URL

u2 - 비교하는 제 2 의 호스트의 URL

반환값:

그것들이 동일한 경우만 true, 그 이외의 경우는 false

도입된 버젼:

1.3

toExternalForm

protected String  toExternalForm(URL  u)

특정의 프로토콜의 URL 를 String 로 변환합니다.

파라미터:

u - URL

반환값:

URL 인수의 캐릭터 라인 표현

setURL

protected void setURL(URL  u,
                      String  protocol,
                      String  host,
                      int port,
                      String  authority,
                      String  userInfo,
                      String  path,
                      String  query,
                      String  ref)

URL 인수의 각 필드가 지정된 값으로 설정합니다. URL 의 set 메소드를 호출할 수 있는 것은 URLStreamHandler 의 상속 클래스 뿐입니다.

파라미터:

u - 수정하는 URL

protocol - 프로토콜명

host - URL 의 원격 호스트치

port - 원격 머신상의 포트

authority - URL 의 권한 부분

userInfo - URL 의 사용자 정보부분

path - URL 의 패스 컴포넌트

query - URL 의 쿼리부분

ref - 참조

예외:

SecurityException - 이 URL 의 프로토콜 핸들러가 이 핸들러와는 다른 경우

도입된 버젼:

1.3

관련 항목:

URL.set(java.lang.String, java.lang.String, int, java.lang.String, java.lang.String)

setURL

@Deprecated 
protected void setURL(URL  u,
                                 String  protocol,
                                 String  host,
                                 int port,
                                 String  file,
                                 String  ref)

추천 되고 있지 않습니다. setURL(URL, String, int, String, String, String, String)를 사용해 주세요.

URL 인수의 각 필드가 지정된 값으로 설정합니다. URL 의 set 메소드를 호출할 수 있는 것은 URLStreamHandler 의 상속 클래스 뿐입니다.

파라미터:

u - 수정하는 URL

protocol - 프로토콜명 1.2 이후, 이 값은 무시되는

host - URL 의 원격 호스트치

port - 원격 머신상의 포트

file - 파일

ref - 참조

예외:

SecurityException - 이 URL 의 프로토콜 핸들러가 이 핸들러와는 다른 경우