java.security
클래스 Permission

java.lang.Object 
  java.security.Permission

모든 구현된 인터페이스:

Serializable, Guard

알려진 직계 서브 클래스:

AllPermission, BasicPermission, FilePermission, MBeanPermission, PrivateCredentialPermission, ServicePermission, SocketPermission, UnresolvedPermission

public abstract class Permission
extends Object 
implements Guard,
 Serializable 

system resource에의 액세스를 표현하는 추상 클래스입니다. 모든 접근 권한은 특정의 Permission 서브 클래스의 시멘틱스를 정의하기 위한 추상 기능을 가지는 것 외에 구현을 서브 클래스에 의존된 이름을 가집니다.

대부분의 Permission 객체는 또, 객체에 허가되고 있는 액션을 통지하는 액션 리스트를 포함합니다. 예를 들어 java.io.FilePermission 객체에서는 접근 권한의 이름은 파일 또는 디렉토리의 패스명으로 액션 리스트 (읽기, 출력등)는 지정된 파일, 또는 디렉토리내의 파일에 어느 액션이 허가되고 있는지를 지정합니다. 액션 리스트는 그러한 리스트를 필요로 하지 않는 java.lang.RuntimePermission 등의 Permission 객체에서는 옵션입니다. 사용자는 이름 첨부의 접근 권한 (system.exit 등)을 가지는 경우와 가지지 않는 경우가 있습니다.

각 서브 클래스에 의해 구현해야 할 중요한 메서드는 Permissions를 비교하는 implies 메서드입니다. 기본적으로 「permission p1는 permission p2를 포함 한다」란 permission p1가 허가되었을 경우에는 permission p2도 당연히 허가된다고 하는 것입니다. 따라서, 이것은 적성 테스트가 아니고, 부분집합 테스트입니다.

Permission 객체는 한 번 작성하면 불변이 된다고 하는 점에서는 String 객체와 닮아 있습니다. 서브 클래스는 한 번 작성된 접근 권한 상태를 변경할 수 있는 메서드를 제공할 수 없습니다.

관련 항목:

Permissions, PermissionCollection, 직렬화 된 형식

생성자 개요

Permission (String name)
지정된 이름으로 접근 권한을 구축합니다.

메서드 개요

void	checkGuard (Object object) 접근 권한의 가이드 인터페이스를 구현합니다.
abstract boolean	equals (Object obj) 2개의 Permission 객체가 동일한지 어떤지를 판정합니다.
abstract String	getActions () 액션을 String 로 리턴합니다.
String	getName () Permission 이름을 리턴합니다.
abstract int	hashCode () Permission 객체의 해시 코드값을 리턴합니다.
abstract boolean	implies (Permission permission) 이 객체의 액션에의해 지정된 접근 권한의 액션이 포함 될지 어떨지를 판정합니다.
PermissionCollection	newPermissionCollection () 지정된 Permission 객체의 비어있는 PermissionCollection를 리턴합니다.
String	toString () Permission를 기술하는 캐릭터 라인을 리턴합니다.

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

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

생성자 상세

Permission

public Permission(String  name)

지정된 이름으로 접근 권한을 구축합니다.

파라미터:

name - 작성하는 Permission 객체의 이름

메서드의 상세

checkGuard

public void checkGuard(Object  object)
                throws SecurityException 

접근 권한의 가이드 인터페이스를 구현합니다. SecurityManager.checkPermission 메서드가 불려가 이 접근 권한 객체를 검사 대상으로의해 건네줍니다. 액세스가 허가되면, 아무것도 실시하지 않고 복귀합니다. 그렇지 않은 경우는 SecurityException을 Throw 합니다.

정의:

인터페이스 Guard 내의 checkGuard

파라미터:

object - 가이드가 있는 객체 (현재는 무시)

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkPermission 메서드가 액세스를 허가하지 않을 때

관련 항목:

Guard, GuardedObject, SecurityManager.checkPermission(java.security.Permission)

implies

public abstract boolean implies(Permission  permission)

이 객체의 액션에의해 지정된 접근 권한의 액션이 포함 될지 어떨지를 판정합니다.

Permission 객체에 시멘틱스를 부과할 수 있는 것은 Permission 서브 클래스 뿐이므로 이 메서드는 그러한 서브 클래스에 의해 구현되지 않으면 안됩니다.

implies 메서드는 AccessController에 의해 사용됩니다. 현재 실행중의 컨텍스트 으로 유효하다라고 하는 것이 알고 있는 다른 접근 권한에의해 요구된 접근 권한이 포함 되고 있는지를, 이 메서드를 사용해 조사합니다.

파라미터:

permission - 체크 대상의 접근 권한

반환값:

지정된 접근 권한이 이 객체에 포함되는 경우는 true, 그렇지 않은 경우는 false

equals

public abstract boolean equals(Object  obj)

2개의 Permission 객체가 동일한지 어떤지를 판정합니다.

액세스 제어를 결정하는데 equals 메서드는 사용하지 말아 주세요. 대신에 implies 메서드를 사용해 주세요.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 이 객체와 동일한지 어떤지가 판정되는 객체

반환값:

2개의 Permission 객체가 동일한 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public abstract int hashCode()

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

이하에 Permission 객체의 필요한 hashCode 동작을 나타냅니다.

• 같은 Permission 객체에 대해서 Java 어플리케이션의 실행시에 여러 차례 호출할 때마다, hashCode 메서드는 일관해 같은 정수를 돌려주지 않으면 안 된다. 다만, 이 정수는 같은 어플리케이션의 실행 마다 같은 필요는 없다

• equals 메서드에 근거해 2개의 Permission 객체가 동일한 경우는 2개의 Permission 객체로 각각 hashCode 메서드를 호출했을 때, 결과적으로 같은 정수가 생성되지 않으면 안 된다

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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

getName

public final String  getName()

Permission 이름을 리턴합니다. 예를 들어 java.io.FilePermission인 경우는 이름은 패스명이 됩니다.

반환값:

Permission 이름

getActions

public abstract String  getActions()

액션을 String 로 리턴합니다. 이것은 abstract 메서드이므로 필요성이 생길 때까지 서브 클래스는 String 표현의 작성을 지연 시킬 수가 있습니다. 서브 클래스는 항상, 표준 형식이라고 보는 형식에서 액션을 돌려주지 않으면 안됩니다. 예를 들어 2개의 FilePermission 객체는 아래의 방법으로 작성됩니다.

   perm1 = new FilePermission(p1,"read, write");
   perm2 = new FilePermission(p2,"write, read"); 
 

getActions 메서드가 불려가 면, 어느쪽이나 "read, write"를 리턴합니다.

반환값:

Permission 액션

newPermissionCollection

public PermissionCollection  newPermissionCollection()

지정된 Permission 객체의 비어있는 PermissionCollection를 리턴합니다. 다만, 정의 끝난 것이 없는 경우는 null을 리턴합니다. PermissionCollection.implies 메서드가 불려 갔을 때에 올바른 시멘틱스를 제공하기 위해서 특정의 PermissionCollection 객체에 그 접근 권한을 포함할 필요가 있는 경우, Permission 클래스의 서브 클래스는 이 메서드를 오버라이드(override) 합니다. null이 돌려주고졌을 경우, 이 메서드의 호출측은 이 종류의 접근 권한을 선택하는 어느 PermissionCollection에 대해서도 자유롭게 포함할 수 있습니다 (Hashtable를 사용하는 것, Vector를 사용하는 것 등).

반환값:

이 종류의 Permission 새로운 PermissionCollection 객체. 정의 끝난 것이 없는 경우는 null

toString

public String  toString()

Permission를 기술하는 캐릭터 라인을 리턴합니다. 규약에서는 클래스명, 접근 권한의 이름, 액션을 '("ClassName" "name" "actions")'라고 하는 형식에서 지정합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 Permission에 대한 정보