PrivateCredentialPermission (Java Platform SE 6)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

javax.security.auth
클래스 PrivateCredentialPermission

java.lang.Object 
  java.security.Permission 
      javax.security.auth.PrivateCredentialPermission

모든 구현된 인터페이스:: Serializable , Guard

public final class PrivateCredentialPermission
extends Permission
extends Permission

text/html; charset=euc-jp 이 클래스는, 특정의 Subject 에 속하는 비공개 Credential 를 액세스로부터 보호합니다. 주제는, 주체세트에 의해 나타내집니다.

이 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";
    };

상기의 예에서는, 「duke」라고 하는 이름의 「a.b.Principal」라고, 「dukette」라고 하는 이름의 「c.d.Principal」가 적어도 2 개의 관련하는 Principal 를 가지는 Subject 에 속하는 비공개 자격의 「a.b.Credential」에의 액세스가 허가됩니다.

관련 항목:: 직렬화 된 형식

생성자 의 개요
`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 가 읽어들여 가능한 것을 지정하는 액션
예외:: IllegalArgumentException - name 의 구문이 올바르지 않은 경우, 또는 action 가 「read」(읽기)이 아닌 경우

메소드의 상세

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"] implies [a.b.Credential P1 "duke"].
        [C1 P1 "duke"] implies [C1 P1 "duke" P2 "dukette"].
        [C1 P2 "dukette"] implies [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
관련 항목:: Object.hashCode() , Hashtable

hashCode

public int hashCode()

이 객체의 해시 코드값를 돌려줍니다.

정의:: 클래스 Permission 내의 hashCode

반환값:: 이 객체의 해시 코드값
관련 항목:: Object.equals(java.lang.Object) , Hashtable

getActions

public String  getActions()

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

정의:: 클래스 Permission 내의 getActions

반환값:: 액션 (항상 「read」를 돌려준다)

newPermissionCollection

public PermissionCollection  newPermissionCollection()

PermissionCollection 에 있는 PrivateCredentialPermissions 의 동종 컬렉션을 돌려줍니다. 그러한 PermissionCollection 는 정의되어 있지 않기 때문에, 이 메소드는 항상 null 를 돌려줍니다.

오버라이드(override):: 클래스 Permission 내의 newPermissionCollection

반환값:: null (어떠한 경우에서도)

개요