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 객체를 그룹화 하려면, 우선 그 특정의 형태에 대해서 newPermissionCollection 메서드를 호출할 필요가 있습니다. Permission 클래스의 경우, 이 메서드의 디폴트 동작은 단순하게 null을 돌려준다고 하는 것입니다. PermissionCollection.implies 메서드의 호출시에 올바른 시멘틱스를 제공할 수 있도록 특정의 PermissionCollection 객체내에 접근 권한을 포함할 필요가 있는 경우에는 클래스 Permission 서브 클래스가 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 <Permission >	elements () 컬렉션내의 모든 Permission 객체의 열거를 리턴합니다.
abstract boolean	implies (Permission permission) 지정된 접근 권한이, 이 PermissionCollection 로 보관 유지되는 Permission 객체의 컬렉션에 의해 포함 될지 어떨지를 판정합니다.
boolean	isReadOnly () PermissionCollection 객체가 읽기 전용 으로서 마크 되고 있는 경우에 true를 리턴합니다.
void	setReadOnly () PermissionCollection 객체를 「읽기 전용 」으로서 마크 합니다.
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 <Permission > elements()

컬렉션내의 모든 Permission 객체의 열거를 리턴합니다.

반환값:

모든 Permissions 열거

setReadOnly

public void setReadOnly()

PermissionCollection 객체를 「읽기 전용 」으로서 마크 합니다. PermissionCollection 객체를 읽기 전용 으로서 마크 하면 새로운 Permission 객체를 add로 PermissionCollection에 추가할 수 없습니다.

isReadOnly

public boolean isReadOnly()

PermissionCollection 객체가 읽기 전용 으로서 마크 되고 있는 경우에 true를 리턴합니다. 읽기 전용 의 경우, 새로운 Permission 객체를 add로 PermissionCollection에 추가할 수 없습니다.

디폴트에서는 객체는 읽기 전용이 아닙니다. setReadOnly를 호출하는 것에 의해 읽기 전용 으로 설정할 수 있습니다.

반환값:

이 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 객체에 대한 정보 (전술을 참조)