java.security
클래스 PermissionCollection

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

모든 구현 인터페이스:

Serializable

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

Permissions

public abstract class PermissionCollection

extends Object

implements Serializable

Permission 오브젝트의 콜렉션을 나타내는 abstract 클래스입니다.

PermissionCollection 를 사용하면(자), 이하의 처리를 실시할 수 있습니다.

• add 메소드를 사용해, 콜렉션에 액세스권을 추가한다
• implies 메소드를 사용해, 특정의 액세스권이 콜렉션에 포함되어 있는지 어떤지를 조사한다
• elements 메소드를 사용해, 모든 액세스권을 열거한다

같은 종류의 상당수의 Permission 오브젝트를 함께 그룹화 하려면 , 특정 종류의 Permission 오브젝트의 newPermissionCollection 메소드를 최초로 호출하지 않으면 안됩니다. 디폴트의 동작 (Permission 클래스로부터)에서는 단순하게 null 를 돌려줍니다. Permission 클래스의 서브 클래스는 PermissionCollection.implies 메소드의 호출시에 올바른 시멘틱스를 제공하기 위해서 그 액세스권을 특정의 PermissionCollection 오브젝트에 저장할 필요가 있는 경우,newPermissionCollection 메소드를 오버라이드(override) 합니다. null 이외의 값이 돌려주어지면(자), 그 PermissionCollection 가 사용되지 않으면 안됩니다. null 가 돌려주어지면(자),newPermissionCollection 의 호출측은 지정된 종류의 액세스권을, 선택하는 어느 PermissionCollection 에 대해서도 자유롭게 저장할 수 있습니다 (Hashtable 를 사용하는 것, Vector 를 사용하는 것 등).

Permission.newPermissionCollection 메소드가 돌려주는 PermissionCollection 는 동종 콜렉션이며, 지정된 종류의 액세스권의 Permission 오브젝트만을 저장합니다. PermissionCollection 는 이종 콜렉션이기도 합니다. 예를 들어 Permissions 는 PermissionCollections 의 콜렉션을 나타내는 PermissionCollection 서브 클래스입니다. 즉 그 멤버는 각각이 동종의 PermissionCollection 입니다. 예를 들어 Permissions 오브젝트는 모든 FilePermission 오브젝트에 대해서는 FilePermissionCollection, 모든 SocketPermission 오브젝트에 대해서는 SocketPermissionCollection 등이라고 하는 대응으로 콜렉션을 가집니다. 그 add 메소드는 액세스권을 적절한 콜렉션에 추가합니다.

Permissions 등의 이종의 PermissionCollection 에 액세스권이 추가될 때, 및 지정된 종류의 액세스권의 PermissionCollection 를 PermissionCollection 가 아직 보관 유지하고 있지 않을 때는 PermissionCollection 는 액세스권의 클래스에서 newPermissionCollection 메소드를 호출해, 그것이 특별한 PermissionCollection 를 필요로 할지 어떨지를 조사하지 않으면 안됩니다. newPermissionCollection 가 null 를 돌려주면(자), PermissionCollection 는 희망하는 어느 종류의 PermissionCollection 라도 액세스권을 저장할 수 있습니다 (Hastable 를 사용하는 것, Vector 를 사용하는 것 등). 예를 들어 Permissions 오브젝트는 액세스권 오브젝트를 Hashtable 에 저장하는 디폴트의 PermissionCollection 구현을 사용합니다.

PermissionCollection 의 서브 클래스 구현은 복수 thread로부터 동시에 불려 가는 것을 상정하지 않으면 안되어, 그 때문에, 적절히 동기를 취하지 않으면 안됩니다. 그 만큼이 아니고,elements 메소드로 돌려주어지는 Enumerations 는 「페이르파스트」가 아닙니다. 콜렉션의 열거중에, 콜렉션에 변경을 더해서는 안됩니다.

관련 항목:

Permission , Permissions , 직렬화 된 형식

생성자의 개요

PermissionCollection ()

메소드의 개요

abstract void	add (Permission permission) 액세스권 오브젝트의 현재의 콜렉션에 액세스권 오브젝트를 추가합니다.
abstract Enumeration	elements () 콜렉션내의 모든 Permission 오브젝트의 열거를 돌려줍니다.
abstract boolean	implies (Permission permission) 지정된 액세스권이, 이 PermissionCollection 로 보관 유지되는 Permission 오브젝트의 콜렉션에 의해 포함 될지 어떨지를 판정합니다.
boolean	isReadOnly () PermissionCollection 오브젝트가 읽어들여 전용으로서 마크 되고 있는 경우에 true 를 돌려줍니다.
void	setReadOnly () PermissionCollection 오브젝트를 「read 전용」으로서 마크 합니다.
String	toString () PermissionCollection 오브젝트를 기술하는 캐릭터 라인을 돌려주어, 오브젝트가 보관 유지하는 모든 액세스권에 대한 정보를 제공합니다.

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

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자의 상세

PermissionCollection

public PermissionCollection()

메소드의 상세

add

public abstract void add(Permission  permission)

액세스권 오브젝트의 현재의 콜렉션에 액세스권 오브젝트를 추가합니다.

파라미터:

permission - 추가되는 Permission 오브젝트

예외:

SecurityException - - 이 PermissionCollection 오브젝트가 읽어들여 전용으로서 마크 되고 있는 경우

implies

public abstract boolean implies(Permission  permission)

지정된 액세스권이, 이 PermissionCollection 로 보관 유지되는 Permission 오브젝트의 콜렉션에 의해 포함 될지 어떨지를 판정합니다.

파라미터:

permission - 비교 대상의 Permission 오브젝트

반환값:

permission 가 콜렉션내의 액세스권에 의해 포함 되는 경우는 true, 그렇지 않은 경우는 false

elements

public abstract Enumeration  elements()

콜렉션내의 모든 Permission 오브젝트의 열거를 돌려줍니다.

반환값:

모든 Permissions 의 열거

setReadOnly

public void setReadOnly()

PermissionCollection 오브젝트를 「read 전용」으로서 마크 합니다. PermissionCollection 오브젝트를 읽어들여 전용으로서 마크 하면(자) 신규 Permission 오브젝트를 add 로 PermissionCollection 에 추가할 수 없습니다.

isReadOnly

public boolean isReadOnly()

PermissionCollection 오브젝트가 읽어들여 전용으로서 마크 되고 있는 경우에 true 를 돌려줍니다. read 전용의 경우, 신규 Permission 오브젝트를 add 로 PermissionCollection 에 추가할 수 없습니다.

디폴트에서는 오브젝트는 읽어들여 전용이 아닙니다. setReadOnly 를 호출하는 것에 의해 read 전용으로 설정할 수 있습니다.

반환값:

이 PermissionCollection 오브젝트가 읽어들여 전용으로서 마크 되고 있는 경우는 true, 그렇지 않은 경우는 false

toString

public String  toString()

PermissionCollection 오브젝트를 기술하는 캐릭터 라인을 돌려주어, 오브젝트가 보관 유지하는 모든 액세스권에 대한 정보를 제공합니다. 다음에 형식을 나타냅니다.

 super.toString() (
   // enumerate all the Permission
   // objects and call toString() on them,
   // one per line..
 )

super.toString 는 이 오브젝트의 슈퍼 클래스 (즉 Object)의 toString 메소드의 호출입니다. 결과적으로 돌려주어지는 것은 이 PermissionCollection 의 종류명의 후에 이 오브젝트의 해시 코드가 계속되는 캐릭터 라인이므로, 복수의 PermissionCollections 오브젝트가 같은 액세스권을 보관 유지하는 경우에서도, 클라이언트는 각 오브젝트를 구별할 수 있습니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

PermissionCollection 오브젝트에 대한 정보 (상기를 참조)