java.security
클래스 Permission

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

모든 구현 인터페이스:

Guard , Serializable

직계의 기존의 서브 클래스:

AllPermission , BasicPermission , FilePermission , 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 를 슬로우 합니다.

정의:

인터페이스 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 에 대한 정보