java.net
클래스 SocketPermission

java.lang.Object 
  java.security.Permission 
      java.net.SocketPermission

모든 구현된 인터페이스:

Serializable, Guard

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개 만 사용할 수 있습니다. 다만와 일드 카드 문자는 「*. 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)로 사용했을 경우에만 미가 있습니다. 해결 액션은 다른 임의의 액션이 지정되었을 경우에는 암묵적으로 지정됩니다.

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 포트 범위가 이 포트 범위에 포함된다 (주: 액션 resolve가 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. obj 밖에 액션 resolve가 포함되지 않는 경우, 비교시에 포트 범위는 무시되는

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 객체의 해시 코드값을 리턴합니다.

정의:

클래스 Permission 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

getActions

public String  getActions()

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

정의:

클래스 Permission 내의 getActions

반환값:

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

newPermissionCollection

public PermissionCollection  newPermissionCollection()

SocketPermission 객체를 포함하기 위한, 새로운 PermissionCollection 객체를 리턴합니다.

SocketPermission 객체의 포함 형식은 동객체를 임의의 차례로 컬렉션에 삽입할 수 있어 게다가 PermissionCollection implies 메서드가 효율적 또한 모순이 없게 구현할 수 있는 형식이 아니면 안됩니다.

오버라이드(override):

클래스 Permission 내의 newPermissionCollection

반환값:

SocketPermissions를 포함하는데 적절한 새로운 PermissionCollection 객체