java.util
클래스 PropertyPermission

java.lang.Object 
  java.security.Permission 
      java.security.BasicPermission 
          java.util.PropertyPermission

모든 구현된 인터페이스:

Serializable , Guard

public final class PropertyPermission
extends BasicPermission 

이 클래스는 프로퍼티에의 액세스권을 위한 클래스입니다.

이름에는, 프로퍼티의 이름 (java.home 나 os.name 등)을 지정합니다. 명명 규약은, 계층형 프로퍼티의 명명 규약에 따릅니다. 또, 타겟명의 후에 asterisk를 지정해 ( 「.」의 후에 지정하는지, 단독으로 지정), 와일드 카드에 의한 조합을 실시할 수도 있습니다. 다음에 예를 나타냅니다. 예를 들어, 「java. *」(이)나 「*」은 유효합니다만, 「*java」나 「a*b」는 무효입니다.

허가하는 액션은, 콤마로 단락지어진 0 개 이상의 키워드의 리스트를 내용으로 하는 캐릭터 라인으로서 생성자 에 인도해집니다. 지정할 수 있는 키워드는, read 와 write 입니다. 각각의 의미는, 다음과 같이 정의됩니다.

read

read권. System.getProperty 를 호출할 수 있게 된다

write

쓰기 권한. System.setProperty 를 호출할 수 있게 된다

액션 캐릭터 라인은, 처리되기 전에 소문자에 변환됩니다.

특정의 시스템 프로퍼티에의 액세스권을 코드에게 줄 때는 주의해 주세요. 예를 들어, 시스템 프로퍼티 java.home 에의 액세스권을 주면(자), 악의가 있는 코드에 의해, 시스템 환경에 관한 기밀 정보 (Java 의 인스톨 디렉토리)가 도둑맞을 가능성이 있습니다. 또, 시스템 프로퍼티 user.name 및 user.home 에의 액세스권을 주면(자), 악의가 있는 코드에 의해, 사용자 환경에 관한 중요한 정보 (사용자의 어카운트명으로 홈 디렉토리)가 도둑맞을 가능성이 있습니다.

도입된 버젼:

1.2

관련 항목:

BasicPermission , Permission , Permissions , PermissionCollection , SecurityManager

생성자 의 개요

PropertyPermission (String name, String actions)
이름을 지정해 새로운 PropertyPermission 객체를 작성합니다.

메소드의 개요

boolean	equals (Object obj) 2 개의 PropertyPermission 객체가 같은지 어떤지를 판정합니다.
String	getActions () 액션의 「정규의 캐릭터 라인 표현」을 돌려줍니다.
int	hashCode () 이 객체의 해시 코드값를 돌려줍니다.
boolean	implies (Permission p) PropertyPermission 객체가, 지정된 액세스권을 포함하고 있는지 어떤지를 판정합니다.
PermissionCollection	newPermissionCollection () PropertyPermission 객체를 포함하기 위한 새로운 PermissionCollection 객체를 돌려줍니다.

클래스 java.security. Permission 로부터 상속된 메소드

checkGuard , getName , toString

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

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

생성자 의 상세

PropertyPermission

public PropertyPermission(String  name,
                          String  actions)

이름을 지정해 새로운 PropertyPermission 객체를 작성합니다. name 는 시스템 프로퍼티의 이름으로,actions 에는, 프로퍼티으로 허가되고 있는 목적의 액션의 콤마로 단락지어진 리스트가 들어갑니다. 유효한 액션은 read 와 write 입니다.

파라미터:

name - PropertyPermission 의 이름

actions - 액션의 캐릭터 라인

예외:

NullPointerException - name 가 null 의 경우

IllegalArgumentException - name 가 빈 상태(empty)의 경우, 또는 actions 가 무효인 경우

메소드의 상세

implies

public boolean implies(Permission  p)

PropertyPermission 객체가, 지정된 액세스권을 포함하고 있는지 어떤지를 판정합니다.

즉, 이 메소드는 다음의 경우에 true 를 돌려줍니다.

• p 가 PropertyPermission 의 인스턴스이다

• p 의 액션은, 이 객체의 액션의 부분집합이다

• p 의 이름이 이 객체의 이름에 포함되어 있다. 예를 들어, java. * (은)는 java.home 를 포함한다

오버라이드(override):

클래스 BasicPermission 내의 implies

파라미터:

p - 체크 대상의 액세스권

반환값:

지정된 액세스권이 이 객체에 포함되는 경우는 true, 그렇지 않은 경우는 false

equals

public boolean equals(Object  obj)

2 개의 PropertyPermission 객체가 같은지 어떤지를 판정합니다. obj 가 PropertyPermission 이며, 객체와 같은 이름과 액션을 가지고 있을지 어떨지를 판정합니다.

오버라이드(override):

클래스 BasicPermission 내의 equals

파라미터:

obj - 이 객체와 동일한지 어떤지를 판정하는 객체

반환값:

obj 가 PropertyPermission 이며, 이 PropertyPermission 객체와 같은 이름과 액션을 가지고 있는 경우는 true

관련 항목:

Object.hashCode() , Hashtable

hashCode

public int hashCode()

이 객체의 해시 코드값를 돌려줍니다. 사용되는 해시 코드는, 이 액세스권의 이름의 해시 코드, 즉,getName(). hashCode() (Permission 슈퍼 클래스로부터의 getName)입니다.

오버라이드(override):

클래스 BasicPermission 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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

getActions

public String  getActions()

액션의 「정규의 캐릭터 라인 표현」을 돌려줍니다. 즉, 이 메소드는 항상 read, write 의 순서로 현재의 액션을 돌려줍니다. 예를 들어, 이 PropertyPermission 객체가 write 및 read 액션을 허가하는 경우,getActions 를 호출하면(자), 「read, write」라고 하는 캐릭터 라인이 돌려주어집니다.

오버라이드(override):

클래스 BasicPermission 내의 getActions

반환값:

액션의 정규의 캐릭터 라인 표현

newPermissionCollection

public PermissionCollection  newPermissionCollection()

PropertyPermission 객체를 포함하기 위한 새로운 PermissionCollection 객체를 돌려줍니다.

오버라이드(override):

클래스 BasicPermission 내의 newPermissionCollection

반환값:

PropertyPermission 를 포함하는데 적절한 신규 PermissionCollection 객체