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 - 프록시가 처리에 실패한 URI

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

ioe - 접속에 실패했을 때에 발생되는 I/O 예외

예외:

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