java.net
클래스 URLStreamHandler

java.lang.Object 
  java.net.URLStreamHandler

public abstract class URLStreamHandler
extends Object 

추상 클래스 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 등의, 핸들러의 프로토콜에 대해서는 java.lang, java.io, java.util, 또는 java.net 패키지, 혹은 그 서브 패키지에 속하는 일반 또는 특수한 URLConnection 서브 클래스가 있습니다. 리턴된 접속은 그 서브 클래스의 것이 됩니다. 예를 들어 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 디폴트의 포트

equals

protected boolean equals(URL  u1,
                         URL  u2)

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

파라미터:

u1 - URL 객체

u2 - URL 객체

반환값:

2개의 URL가 동등하다라고 보이는 경우, 즉 2개의 URL가 같은 파일의 같은 fragment를 참조하는 경우는 true

hashCode

protected int hashCode(URL  u)

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

파라미터:

u - URL 객체

반환값:

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

sameFile

protected boolean sameFile(URL  u1,
                           URL  u2)

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

파라미터:

u1 - URL 객체

u2 - URL 객체

반환값:

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

getHostAddress

protected InetAddress  getHostAddress(URL  u)

호스트의 IP 주소를 취득합니다. 비어있는 호스트 필드 또는 DNS 장해의 경우, null이 리턴됩니다 .

파라미터:

u - URL 객체

반환값:

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

hostsEqual

protected boolean hostsEqual(URL  u1,
                             URL  u2)

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

파라미터:

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

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

반환값:

2개의 URL 호스트 컴퍼넌트가 동일한 경우는 true, 그렇지 않은 경우는 false

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 프로토콜 핸들러가 이것과 다른 경우

관련 항목:

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 프로토콜 핸들러가 이것과 다른 경우