javax.security.auth
클래스 PrivateCredentialPermission

java.lang.Object 
  |
  +--java.security.Permission 
        |
        +--javax.security.auth.PrivateCredentialPermission

모든 구현 인터페이스:

Guard , Serializable

public final class PrivateCredentialPermission

extends Permission

이 클래스는 특정의 Subject 에 속하는 비공개 Credential 에의 액세스로부터 보호합니다. Subject 는 Principal 의 Set 로 나타내집니다.

이 Permission 의 타겟명은 Credential 의 클래스명 및 Principal 의 Set 를 지정합니다. 이 Permission 의 액션에 유효한 값은 read 뿐입니다. 타겟명은 다음의 구문에 따를 필요가 있습니다.

	CredentialClass {PrincipalClass "PrincipalName"}*
 

예를 들어 이하의 액세스권은 com.sun.Principal 를 이름 「duke」로 보관 유지하는 Subject 가 소유하는 com.sun.PrivateCredential 에의 액세스를 허가합니다. 이하에 나타내는 예 모두같이, 이 예에서도 단순화 하기 위해서 Codebase, Signedby, Principal 의 정보를 grant 문에 포함하고 있지 않습니다만, 실제의 폴리시 구성에서는 필요에 따라서 지정할 필요가 있습니다.

    grant {
	permission javax.security.auth.PrivateCredentialPermission
		"com.sun.PrivateCredential com.sun.Principal \"duke\"",
		"read";
    };
 

CredentialClass 가 "*" 의 경우는 지정한 Subject 에 속하는 모든 비공개 Credential 에의 액세스가 부여됩니다. "PrincipalName" 이 "*" 의 경우는 실제의 PrincipalName 에 관계없이, 지정한 Principal 를 보관 유지하는 임의의 Subject 가 소유하는 지정한 Credential 에의 액세스가 허가됩니다. 예를 들어, a.b.Principal 를 보관 유지하는 임의의 Subject 가 소유하는 a.b.Credential 에의 액세스를 허가하려면 다음과 같이 합니다.

    grant {
	permission javax.security.auth.PrivateCredentialPermission
		"a.b.Credential a.b.Principal "*"",
		"read";
    };
 

PrincipalClass 와 "PrincipalName" 의 양쪽 모두가 "*" 인 경우는 임의의 Subject 가 소유하는 지정한 Credential 에의 액세스가 허가됩니다.

게다가 PrincipalClass 와 PrincipalName 의 페어는 반복할 수가 있습니다.

    grant {
	permission javax.security.auth.PrivateCredentialPermission
		"a.b.Credential a.b.Principal "duke" c.d.Principal "dukette"",
		"read";
    };
 

상기의 예에서는 비공개 Credential 인 a.b.Credential 에의 액세스가 허가되고 있습니다. 이 비공개 Credential 는 이름 duke 의 a.b.Principal 과 이름 dukette 의 c.d.Principal 의, 적어도 2 개의 관련하는 Principal 를 가지는 Subject 에 속하고 있습니다.

관련 항목:

직렬화 된 형식

생성자의 개요

PrivateCredentialPermission (String name, String actions)
지정한 name 로, 새로운 PrivateCredentialPermission 를 작성합니다.

메소드의 개요

boolean	equals (Object obj) 2 개의 PrivateCredentialPermission 의 동일성을 판정합니다.
String	getActions () 이 액션의 「표준적인 캐릭터 라인 표현」을 돌려줍니다.
String	getCredentialClass () 이 PrivateCredentialPermission 에 관련한 Credential 의 Class 명을 돌려줍니다.
String [][]	getPrincipals () 이 PrivateCredentialPermission 에 관련하는 Principal 클래스와 이름을 돌려줍니다.
int	hashCode () 이 오브젝트의 해시 코드치를 돌려줍니다.
boolean	implies (Permission p) 이 PrivateCredentialPermission 오브젝트가, 지정된 Permission 를 나타낼지 어떨지를 판정합니다.
PermissionCollection	newPermissionCollection () PermissionCollection 에 있는 PrivateCredentialPermissions 의 동종 콜렉션을 돌려줍니다.

클래스 java.security. Permission 에서 상속받은 메소드

checkGuard , getName , toString

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

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

생성자의 상세

PrivateCredentialPermission

public PrivateCredentialPermission(String  name,
                                   String  actions)

지정한 name 로, 새로운 PrivateCredentialPermission 를 작성합니다. name 에는 Credential 클래스와 Principal 의 Set 의 양쪽 모두를 지정합니다.

파라미터:

name - Credential 클래스 및 Principal 의 Set 를 지정하는 이름

actions - Credential 가 읽어들여 가능한 것을 지정하는 액션

메소드의 상세

getCredentialClass

public String  getCredentialClass()

이 PrivateCredentialPermission 에 관련한 Credential 의 Class 명을 돌려줍니다.

반환값:

이 PrivateCredentialPermission 에 관련지을 수 있었던 Credential 의 Class 명

getPrincipals

public String [][] getPrincipals()

이 PrivateCredentialPermission 에 관련하는 Principal 클래스와 이름을 돌려줍니다. 정보는 2 차원 배열 (array[x][y])로 돌려주어집니다. x 의 값은 Principal 클래스와 이름의 페어의 수에 대응하고 있습니다. y==0 때 y 는 Principal 클래스의 값에 대응해, y==1 때는 Principal 명의 값에 대응합니다. 예를 들어 array[0][0] 은 배열의 최초로 있는 Principal 의 클래스명에 대응합니다. array[0][1] 에서는 배열의 최초로 있는 Principal 의 Principal 명에 대응합니다.

반환값:

PrivateCredentialPermission 에 관련지을 수 있었던 Principal 클래스와 이름

implies

public boolean implies(Permission  p)

이 PrivateCredentialPermission 오브젝트가, 지정된 Permission 를 나타낼지 어떨지를 판정합니다.

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

• p 가 PrivateCredentialPermission 의 인스턴스이며, 한편

• p 의 타겟명이, 이 오브젝트의 타겟명에 포함되어 있다. 즉,

  	[* P1 "duke"] 는 [a.b.Credential P1 "duke"] 를 의미한다.
  	[C1 P1 "duke"] 는 [C1 P1 "duke" P2 "dukette"] 를 의미한다.
  	[C1 P2 "dukette"] 는 [C1 P1 "duke" P2 "dukette"] 를 의미한다
  

정의:

클래스 Permission 내의 implies

파라미터:

p - 체크 대상의 Permission

반환값:

이 PrivateCredentialPermission 오브젝트로 지정된 Permission 가 포함되어 있는 경우는 true, 포함되지 않은 경우는 false

equals

public boolean equals(Object  obj)

2 개의 PrivateCredentialPermission 의 동일성을 판정합니다. obj 가 PrivateCredentialPermission 이며, 이 오브젝트와 같은 자격 클래스 및 같은 Principal 를 보관 유지하는 것을 확인합니다. 각 Permission 의 타겟명에서의 Principal 의 차례는 관계 없습니다.

정의:

클래스 Permission 내의 equals

파라미터:

obj - 이 오브젝트와 동일한지 어떤지를 판정하는 오브젝트

반환값:

obj 가 PrivateCredentialPermission 이며, 한편, 이 오브젝트와 같은 자격 클래스 및 같은 Principal 를 보관 유지하는 경우는 true

hashCode

public int hashCode()

이 오브젝트의 해시 코드치를 돌려줍니다.

정의:

클래스 Permission 내의 hashCode

반환값:

이 오브젝트의 해시 코드치

getActions

public String  getActions()

이 액션의 「표준적인 캐릭터 라인 표현」을 돌려줍니다. 이 메소드는 항상 String 인 read 를 돌려줍니다.

정의:

클래스 Permission 내의 getActions

반환값:

액션 (항상 read 를 돌려준다)

newPermissionCollection

public PermissionCollection  newPermissionCollection()

PermissionCollection 에 있는 PrivateCredentialPermissions 의 동종 콜렉션을 돌려줍니다. 이런 종류의 PermissionCollection 가 정의되어 있지 않은 경우, 이 메소드는 항상 null 를 돌려줍니다.

오버라이드(override):

클래스 Permission 내의 newPermissionCollection

반환값:

null (어떠한 경우에서도)