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>는 JDK가 인스톨 되고 있던 디렉토리를 나타냅니다.

관련 항목:

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 p) 시스템 전체의 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  p)

시스템 전체의 Policy 객체를 설정합니다. 이 메서드는 최초로 SecurityPermission("setPolicy") 접근 권한을 사용해 SecurityManager.checkPermission을 호출해, Policy를 설정해도 괜찮은지 어떤지를 확인합니다.

파라미터:

p - 새로운 시스템 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를 호출하면, 파일이 재독 보고 붐비어 됩니다.