java.security
클래스 Policy

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

public abstract class Policy

extends Object

Java 어플리케이션 환경의 system security 폴리시 (각종 소스의 코드로 이용할 수 있는 액세스권은 어떤 것인지를 지정한다)를 나타내는 추상 클래스입니다. 즉, 시큐러티 폴리시는 이 Policy 클래스에서 abstract 메소드의 구현을 제공하는 Policy 서브 클래스에 의해 표현됩니다.

항상 유효한 Policy 오브젝트는 1 개 뿐입니다.

Policy 오브젝트가 사용하는 폴리시 정보의 소스의 위치는 Policy 의 구현에 의존합니다. 폴리시의 설정은 예를 들어, 플랫 ASCII 파일, Policy 클래스의 직렬화 된 바이노리필드, 데이타베이스등으로 해서 저장할 수 있습니다.

현재 인스톨 되고 있는 Policy 오브젝트는 getPolicy 메소드를 호출하는 것에 의해 취득할 수 있어setPolicy 메소드의 호출에 의해 (Policy 를 리셋트 하는 액세스권 첨부의 코드로) 변경할 수 있습니다.

refresh 메소드에 의해, 폴리시 오브젝트의 현재의 설정이 리프레쉬 또는 재독 보고 붐비어 됩니다.

이 처리는 구현에 의존합니다. 예를 들어, 폴리시 오브젝트가 그 폴리시를 설정 파일에 저장하는 경우에 refresh 를 호출하면(자), 폴리시 설정 파일이 재독 보고 붐비어 됩니다. 리프레쉬 된 폴리시는 ProtectionDomain 의 클래스에는 유효하지 않은 경우가 있습니다. 이 폴리시는 Policy 프로바이더의 implies 메소드의 구현과 PermissionCollection 의 기입 스트래터지에 의존하고 있습니다.

디폴트의 Policy 구현은 (Java 시큐러티 프로퍼티 파일의) policy.provider 시큐러티 프로퍼티에, 희망하는 Policy 구현 클래스의 완전 지정명을 설정하는 것에 의해 변경할 수 있습니다. Java 시큐러티 프로퍼티 파일은 <JAVA_HOME>/lib/security/java.security 라는 이름의 파일에 저장되고 있습니다. 다만, <JAVA_HOME> 는 SDK 가 인스톨 되고 있던 디렉토리를 나타냅니다.

관련 항목:

CodeSource , PermissionCollection , SecureClassLoader

생성자의 개요

Policy ()

메소드의 개요

abstract PermissionCollection	getPermissions (CodeSource codesource) 글로벌 폴리시를 평가해, 지정된 코드 소스의 코드로 허가되고 있는 액세스권세트를 지정하는 PermissionCollection 오브젝트를 돌려줍니다.
PermissionCollection	getPermissions (ProtectionDomain domain) 글로벌 폴리시를 평가해, 보호 도메인의 지정된 특성으로 허가되고 있는 액세스권세트를 지정하는 PermissionCollection 오브젝트를 돌려줍니다.
static Policy	getPolicy () 인스톨 끝난 Policy 오브젝트를 돌려줍니다.
boolean	implies (ProtectionDomain domain, Permission permission) ProtectionDomain 에 허가된 액세스권에 대해 글로벌 폴리시를 평가해, 그 액세스권이 허가되고 있는지 어떤지를 판정합니다.
abstract void	refresh () 폴리시 설정을 리프레쉬 또는 재독 보고 붐비어 합니다.
static void	setPolicy (Policy policy) 시스템 전체의 Policy 오브젝트를 설정합니다.

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

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

생성자의 상세

Policy

public Policy()

메소드의 상세

getPolicy

public static Policy  getPolicy()

인스톨 끝난 Policy 오브젝트를 돌려줍니다. 이 값은 setPolicy 에의 호출에 의해 변경이 가능해서, 캐쉬하지 말아 주세요. 이 메소드는 최초로 SecurityPermission("getPolicy") 액세스권을 사용해 SecurityManager.checkPermission 를 호출해, Policy 오브젝트를 취득해도 괜찮은지 어떤지를 확인합니다.

반환값:

인스톨 끝난 Policy

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에, 시큐러티 매니저의 checkPermission 가 Policy 오브젝트의 취득을 허가하지 않을 때

관련 항목:

SecurityManager.checkPermission(Permission) , setPolicy(java.security.Policy)

setPolicy

public static void setPolicy(Policy  policy)

시스템 전체의 Policy 오브젝트를 설정합니다. 이 메소드는 최초로 SecurityPermission("setPolicy") 액세스권을 사용해 SecurityManager.checkPermission 를 호출해, Policy 를 설정해도 괜찮은지 어떤지를 확인합니다.

파라미터:

policy - 신규 시스템 Policy 오브젝트

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에, 시큐러티 매니저의 checkPermission 가 Policy 의 설정을 허가하지 않을 때

관련 항목:

SecurityManager.checkPermission(Permission) , getPolicy()

getPermissions

public abstract PermissionCollection  getPermissions(CodeSource  codesource)

글로벌 폴리시를 평가해, 지정된 코드 소스의 코드로 허가되고 있는 액세스권세트를 지정하는 PermissionCollection 오브젝트를 돌려줍니다.

파라미터:

codesource - 호출 측에 관련한 CodeSource. 이것은 코드의 출처(소)인 원래의 위치와 그 서명자의 1 개 또는 복수의 공개열쇠를 캡슐화한다

반환값:

폴리시에 근거해 codesource 의 코드로 허가되고 있는 액세스권세트. 돌려주어지는 액세스권세트는 새로운 가변 인스턴스가 아니면 안되어, Permission 형의 이종을 서포트하고 있을 필요가 있습니다.

getPermissions

public PermissionCollection  getPermissions(ProtectionDomain  domain)

글로벌 폴리시를 평가해, 보호 도메인의 지정된 특성으로 허가되고 있는 액세스권세트를 지정하는 PermissionCollection 오브젝트를 돌려줍니다.

파라미터:

domain - 호출 바탕으로 관련한 ProtectionDomain

반환값:

폴리시에 근거해 domain 로 허가되고 있는 액세스권세트. 돌려주어지는 액세스권세트는 새로운 가변 인스턴스가 아니면 안되어, Permission 형의 이종을 서포트하고 있을 필요가 있습니다.

도입된 버젼:

1.4

관련 항목:

ProtectionDomain , SecureClassLoader

implies

public boolean implies(ProtectionDomain  domain,
                       Permission  permission)

ProtectionDomain 에 허가된 액세스권에 대해 글로벌 폴리시를 평가해, 그 액세스권이 허가되고 있는지 어떤지를 판정합니다.

파라미터:

domain - 판정 대상의 ProtectionDomain

permission - 포함되어 있는지 어떤지를 판정하는 Permission 오브젝트

반환값:

permission 가 이 ProtectionDomain 에 허가된 액세스권의 적절한 부분집합의 경우는 true.

도입된 버젼:

1.4

관련 항목:

ProtectionDomain

refresh

public abstract void refresh()

폴리시 설정을 리프레쉬 또는 재독 보고 붐비어 합니다. 이 메소드의 동작은 구현에 의존합니다. 예를 들어, 파일의 형식의 폴리시에 대해서 refresh 를 호출하면(자), 파일이 재독 보고 붐비어 됩니다.