java.net
클래스 ProxySelector

java.lang.Object 
  java.net.ProxySelector

public abstract class ProxySelector
extends Object 

URL 로 참조되는 네트워크 자원에의 접속시에 사용하는 프록시 서버-가 존재하는 경우에, 그것들을 선택합니다. 프록시 셀렉터는 이 클래스의 구상 서브 클래스이며,setDefault 메소드를 호출하는 것으로 등록됩니다. 현재 등록되어 있는 프록시 셀렉터를 가져오려면 ,getDefault 메소드를 호출합니다.

프록시 셀렉터가 등록되어 있는 경우, 예를 들어, URLConnection 클래스의 서브 클래스는, URL 요구 마다 그 select 메소드를 호출하면, 그 프록시 셀렉터가, 직접 접속, 프록시 접속의 머지않아를 사용해야할 것인가를 결정할 수 있습니다. select 메소드는, 추천의 접속 방법으로 컬렉션의 반복자를 돌려줍니다.

프록시 (PROXY 또는 SOCKS) 서버에의 접속을 확립할 수 없는 경우, 호출원래는, 프록시 셀렉터의 connectFailed 메소드를 호출하는 것으로, 그 프록시 서버-가 사용 불가능한 것을 프록시 셀렉터에 통지합니다.

도입된 버젼:

1.5

생성자 의 개요

ProxySelector ()

메소드의 개요

abstract void	connectFailed (URI uri, SocketAddress sa, IOException ioe) 있는 PROXY 또는 SOCKS 서버에의 접속을 확립할 수 없었던 것을 나타내기 위해서(때문에) 불려 갑니다.
static ProxySelector	getDefault () 시스템 전체의 프록시 셀렉터를 가져옵니다.
abstract List <Proxy >	select (URI uri) 자원에의 액세스에 사용하는 프로토콜과 자원에의 액세스처가 되는 주소에 근거해, 적용 가능한 모든 프록시를 선택합니다.
static void	setDefault (ProxySelector ps) 시스템 전체의 프록시 셀렉터를 설정 (또는 설정 해제)합니다.

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

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

생성자 의 상세

ProxySelector

public ProxySelector()

메소드의 상세

getDefault

public static ProxySelector  getDefault()

시스템 전체의 프록시 셀렉터를 가져옵니다.

반환값:

시스템 전체의 ProxySelector

예외:

SecurityException - 시큐리티 매니저가 인스톨 되고 있어, 그것이 NetPermission ("getProxySelector") 를 거부했을 경우

도입된 버젼:

1.5

관련 항목:

setDefault(ProxySelector)

setDefault

public static void setDefault(ProxySelector  ps)

시스템 전체의 프록시 셀렉터를 설정 (또는 설정 해제)합니다. 주:표준이 아닌 프로토콜 핸들러는, 이 설정을 무시할 가능성이 있습니다.

파라미터:

ps - HTTP 프록시 셀렉터. 프록시 셀렉터를 설정 해제하는 경우는 null

예외:

SecurityException - 시큐리티 매니저가 인스톨 되고 있어, 그것이 NetPermission ("setProxySelector") 를 거부했을 경우

도입된 버젼:

1.5

관련 항목:

getDefault()

select

public abstract List <Proxy > select(URI  uri)

자원에의 액세스에 사용하는 프로토콜과 자원에의 액세스처가 되는 주소에 근거해, 적용 가능한 모든 프록시를 선택합니다. URI 의 형식은 다음과 같이 정의되고 있습니다.

• HTTP 접속의 경우는 http URI
• HTTPS 접속의 경우는 https URI
• FTP 접속의 경우는 ftp URI
• TCP 클라이언트 소켓 접속의 경우는 socket://host:port
  

파라미터:

uri - 접속이 필요한 URI

반환값:

프록시의 리스트. 리스트내의 각 요소의 형태는 Proxy 가 된다. 사용 가능한 프록시가 존재하지 않는 경우, 이 리스트에는 직접 접속을 나타내는 형 Proxy 의 요소가 1 개 포함된다

예외:

IllegalArgumentException - 어느 쪽인가의 인수가 null 의 경우

connectFailed

public abstract void connectFailed(URI  uri,
                                   SocketAddress  sa,
                                   IOException  ioe)

어느 PROXY 또는 SOCKS 서버에의 접속을 확립할 수 없었던 것을 나타내기 위해서(때문에) 불려 갑니다. 이 메소드의 구현은, 지정된 주소와 IOException 의 종류에 근거해, 프록시를 일시적으로 삭제하거나 select(String, String)로부터 반환되는 프록시의 차례를 늘어놓고 바꾸거나 할 수가 있습니다.

파라미터:

uri - sa 의 프록시를 제공할 수 없었던 URI

sa - PROXY 또는 SOCKS 서버의 소켓 주소

ioe - 접속의 실패시에 입출력 예외가 throw 되었을 경우

예외:

IllegalArgumentException - 어느 쪽인가의 인수가 null 의 경우