java.net
클래스 SocketPermission

java.lang.Object 
  |
  +--java.security.Permission 
        |
        +--java.net.SocketPermission

모든 구현 인터페이스:

Guard , Serializable

public final class SocketPermission

extends Permission

implements Serializable

이 클래스는 소켓에 의한 네트워크에의 액세스를 나타냅니다. SocketPermission 는 호스트의 지정과 호스트에 접속하는 방법을 지정하는 일련의 액션으로부터 구성됩니다. 호스트는 다음과 같이 해 지정합니다.

    host = (hostname | IPv4address | iPv6reference) [:portrange]
    portrange = portnumber | -portnumber | portnumber-[portnumber]
 

host 에는 DNS 명, 수치에 의한 IP 주소, 또는 「localhost」(로컬 머신의 경우)의 어떤 것인지를 지정할 수 있습니다. DNS 에 의한 호스트 지정에서는 와일드 카드 캐릭터 「*」을 1 kr만 사용할 수 있습니다. 다만 와일드 카드 캐릭터는 「*. sun.com」와 같이, 반드시 좌단으로 지정할 필요가 있습니다.

IPv6reference 의 형식은 「RFC 2732: Format for Literal IPv6 Addresses in URLs」로 지정되고 있는 형식에 따릅니다.

    ipv6reference = "[" IPv6address "]"

예를 들어, 다음과 같이 SocketPermission 인스턴스를 구축할 수 있습니다.

    String hostAddress = inetaddress.getHostAddress();
    if (inetaddress instanceof Inet6Address) {
        sp = new SocketPermission("[" + hostAddress + "]:" + port, action);
    } else {
        sp = new SocketPermission(hostAddress + ":" + port, action);
    }
 

또는

    String host = url.getHost();
    sp = new SocketPermission(host + ":" + port, action);
 

IPv6 리터럴 주소의「비압축 형식」도 유효합니다.

port 또는 portrange 의 지정은 임의입니다. 포토 번호 N 에 대해 「N-」(이)라고 지정했을 경우는 번호가 N 이상의 모든 포토를 나타냅니다. 「-N」라고 지정했을 경우는 N 이하의 모든 포토를 나타냅니다.

호스트에의 접속 방법에는 다음의 종류가 있습니다.

 accept (수신)
 connect (접속)
 listen (대기)
 resolve (해결)

대기 액션은 로컬 호스트 (localhost)로 사용했을 경우에만 의미가 있습니다. 해결 액션 (호스트와 IP 의 사이의 네임 서비스 참조의 해결)은 다른 임의의 액션이 지정되었을 경우에는 암묵적으로 지정됩니다.

SocketPermissions 의 작성 및 그 의미를 예에 나타냅니다.

   p1 = new SocketPermission("puffin.eng.sun.com:7777", "connect, accept");
 

어느 코드에 대해서 위의 액세스권이 인정되었을 경우, 이것은 그 코드가,puffin.eng.sun.com 의 포토 7777 에의 접속, 및 그 포토상에서의 접속의 수락을 실시하는 것을 허가합니다.

같이

   p1 = new SocketPermission("puffin.eng.sun.com:7777", "connect, accept");
   p2 = new SocketPermission("localhost:1024-", "accept, connect, listen");
 

어느 코드에 대해서 위의 액세스권이 인정되었을 경우, 그 코드는 로컬 호스트상의 1024 ~ 65535 의 포토에 대해서, 접속의 수락, 접속, 대기를 실시하는 것을 허가됩니다.

주: 리모트 호스트로부터의 접속을 받아들이거나 리모트 호스트에 접속하기 위한 액세스권을 코드에 허가하는 것은 위험합니다. 이것은 악의가 있는 코드를 사용하는 것으로, 본래라면 기밀 데이터에의 액세스권이 없는 경우에서도, 기밀 데이터의 전송이나 공유를 용이하게 실시할 수 있게 되기 때문입니다.

관련 항목:

Permissions , SocketPermission

생성자의 개요

SocketPermission (String host, String action)
지정된 액션을 가지는 새로운 SocketPermission 오브젝트를 작성합니다.

메소드의 개요

boolean	equals (Object obj) 2 개의 SocketPermission 오브젝트가 동일한지 어떤지를 판정합니다.
String	getActions () 액션의 정식적 캐릭터 라인 표현을 돌려줍니다.
int	hashCode () 이 오브젝트의 해시 코드치를 돌려줍니다.
boolean	implies (Permission p) 지정된 액세스권이, 이 소켓 액세스권 오브젝트에 포함되어 있는지 어떤지를 판정합니다.
PermissionCollection	newPermissionCollection () SocketPermission 오브젝트를 저장하기 위한 , 새로운 PermissionCollection 오브젝트를 돌려줍니다.

클래스 java.security. Permission 에서 상속받은 메소드

checkGuard , getName , toString

클래스 java.lang. Object 에서 상속받은 메소드

clone , finalize , getClass , notify , notifyAll , wait , wait , wait

생성자의 상세

SocketPermission

public SocketPermission(String  host,
                        String  action)

지정된 액션을 가지는 새로운 SocketPermission 오브젝트를 작성합니다. 호스트명은 DNS 명인가, 수치에 의한 IP 주소로서 지정합니다. 필요에 따라서, 포토 번호 또는 포토 번호의 범위를 지정할 수 있습니다. DNS 명 또는 IP 주소의 후에, 구두점으로 단락지어 지정해 주세요.

로컬 머신을 지정하려면 , host 에 「localhost」라고 지정해 주세요. 또, host 를 하늘의 캐릭터 라인대로 해 두면(자), localhost 를 지정한 것과 같게 됩니다.

actions 파라미터에는 지정된 호스트 및 포토에 부여되는 액션의 리스트를, 콤마로 단락지은 형식에서 지정합니다. 지정할 수 있는 액션은 connect, listen, accept, resolve, 혹은 그러한 임의의 편성입니다. resolve 는 그 이외의 3 개중임의의 액션이 지정되었을 때에도, 자동적으로 추가됩니다.

SocketPermission 의 인스턴스 생성의 예를 다음에 나타냅니다.

    nr = new SocketPermission("www.catalog.com", "connect");
    nr = new SocketPermission("www.sun.com:80", "connect");
    nr = new SocketPermission("*. sun.com", "connect");
    nr = new SocketPermission("*. edu", "resolve");
    nr = new SocketPermission("204.160. 241.0", "connect");
    nr = new SocketPermission("localhost:1024-65535", "listen");
    nr = new SocketPermission("204.160. 241.0:1024-65535", "connect");
 

파라미터:

host - 컴퓨터의 호스트명 또는 IP 주소. 필요에 따라서, 구두점의 후에, 포토 번호 또는 포토 번호의 범위를 지정할 수 있는

action - 액션의 캐릭터 라인

메소드의 상세

implies

public boolean implies(Permission  p)

지정된 액세스권이, 이 소켓 액세스권 오브젝트에 포함되어 있는지 어떤지를 판정합니다.

구체적으로는 이 메소드는 최초로, 다음의 조건이 true 인 것을 확인합니다. 이러한 조건이 1 개에서도 true 가 아닌 경우, 이 메소드는 false 를 돌려줍니다.

• p 가 SocketPermission 의 인스턴스이다

• p 의 액션은 이 오브젝트의 액션의 적절한 부분집합이다

• p 의 포토 범위가, 이 포토 범위에 들어간다

다음에,implies 는 다음의 조건을 차례로 확인해, 조건에 해당하는 경우는 각각 붙어 true 를 돌려줍니다.

• 이 오브젝트가 단일의 IP 주소로 초기화되고 있는 경우에,p 의 IP 주소의 1 개가, 이 오브젝트의 IP 주소와 동일하다

• 이 오브젝트가,*. sun.com 와 같이 와일드 카드를 포함한 도메인명인 경우에,p 의 정식적 이름 (* 캐릭터를 제외한 이름)이, 이 오브젝트의 정식적 호스트명으로 끝난다. 예를 들어,*. sun.com 는 *. eng.sun.com 를 포함한다

• 이 오브젝트가 복수의 IP 주소에서는 초기화되고 있는 경우에, 이 오브젝트의 IP 주소의 1 개가,p 의 IP 주소의 1 개로 동일하다

• 이 (오브젝트의) 정식적 이름이,p 의 정식적 이름과 동일하다

이상이 1 개나 true 가 아닌 경우,implies 는 false 를 돌려줍니다.

정의:

클래스 Permission 내의 implies

파라미터:

p - 체크 대상의 액세스권

반환값:

지정된 액세스권이 이 오브젝트에 포함되는 경우는 true, 그렇지 않은 경우는 false

equals

public boolean equals(Object  obj)

2 개의 SocketPermission 오브젝트가 동일한지 어떤지를 판정합니다.

정의:

클래스 Permission 내의 equals

파라미터:

obj - 이 오브젝트와 동일한지 어떤지가 판정되는 오브젝트

반환값:

obj 가 SocketPermission 이며, 그 호스트명, 포토 범위, 및 액션이, 이 SocketPermission 오브젝트와 동일한 경우는 true

hashCode

public int hashCode()

이 오브젝트의 해시 코드치를 돌려줍니다.

정의:

클래스 Permission 내의 hashCode

반환값:

이 오브젝트의 해시 코드치

getActions

public String  getActions()

액션의 정식적 캐릭터 라인 표현을 돌려줍니다. 현재의 액션을, connect, listen, accept, resolve 의 순서로 돌려줍니다.

정의:

클래스 Permission 내의 getActions

반환값:

액션의 표준적인 캐릭터 라인 표현

newPermissionCollection

public PermissionCollection  newPermissionCollection()

SocketPermission 오브젝트를 저장하기 위한 , 새로운 PermissionCollection 오브젝트를 돌려줍니다.

SocketPermission 오브젝트의 저장 형식은 동오브젝트를 임의의 차례로 콜렉션에 삽입할 수 있어 게다가 PermissionCollection 의 implies 메소드가 효율적 또한 모순이 없게 구현할 수 있는 형식이 아니면 안됩니다.

오버라이드(override):

클래스 Permission 내의 newPermissionCollection

반환값:

SocketPermissions 를 저장하는데 적절한 새로운 PermissionCollection 오브젝트