java.io
클래스 FilePermission

java.lang.Object 
  java.security.Permission 
      java.io.FilePermission

모든 구현된 인터페이스:

Serializable, Guard

public final class FilePermission
extends Permission 
implements Serializable 

이 클래스는 파일 또는 디렉토리에의 액세스를 나타냅니다. FilePermission는 패스명 및 그 패스명에 유효한 일련의 액션으로 구성됩니다.

패스명은 지정된 액션이 허가되고 있는 파일 또는 디렉토리의 패스명입니다. 「/*」( 「/」은 파일 단락 문자 File.separatorChar)로 끝나는 패스명은 그 디렉토리에 포함 떠날 수 있어 모든 파일 및 디렉토리를 나타냅니다. 「/-」으로 끝나는 패스명은 그 디렉토리에 포함 떠날 수 있어 모든 파일 및 서브 디렉토리를 (재귀적으로) 나타냅니다. 특별한 토큰 「<<ALL FILES>>」로 구성되는 패스명은, 어느 파일과도일치합니다.

주: 1개의 「*」으로 구성되는 패스명은 현재의 디렉토리의 모든 파일을 나타내, 1개의 「-」으로 구성되는 패스명은 현재의 디렉토리의 모든 파일 및 (재귀적으로) 현재의 디렉토리에 포함 떠날 수 있어 모든 파일 및 서브 디렉토리를 나타냅니다.

허가되는 액션은 1개 또는 복수의 콤마로 단락지어진 키워드의 리스트로부터 완성되는 캐릭터 라인으로서 생성자에게 건네집니다. 지정할 수 있는 키워드는 「read」, 「write」, 「execute」 및 「delete」입니다. 이러한 키워드의 미는 다음과 같이 정의되고 있습니다.

read

읽기 권한

write

쓰기 권한

execute

실행 권한. Runtime.exec 호출을 허가한다. SecurityManager.checkExec에 대응

delete

삭제 권한. File.delete 호출을 허가한다. SecurityManager.checkDelete에 대응

액션 캐릭터 라인은 처리전에 소문자에 변환됩니다.

FilePermission를 허가할 경우에는 주의가 필요합니다. 다양한 파일 및 디렉토리에의 읽기 액세스 및 특별히 쓰기 권한을 허가하는 것에 한 영향을 생각해 주세요. 출력 액션을 가지는 「<<ALL FILES>>」접근 권한은 특히 위험합니다. 이것은 파일 시스템 전체에의 출력접근 권한을 허용합니다. 사실상, JVM Runtime Environment를 포함한, 시스템 바이너리의 치환마저도 허용합니다.

주: 코드는 항상 이 코드가 포함되고 있는 디렉토리 (또는 그 서브 디렉토리) 내로부터 파일을 읽어들일 수가 있습니다. 그 때문의 명시적인 접근 권한은 필요 없습니다.

도입된 버전 :

1.2

관련 항목:

Permission, Permissions, PermissionCollection

생성자 개요

FilePermission (String path, String actions)
지정된 액션을 가지는 새로운 FilePermission 객체를 작성합니다.

메서드 개요

boolean	equals (Object obj) 2개의 FilePermission 객체가 동일한지 어떤지를 판정합니다.
String	getActions () 액션의 「정규의 캐릭터 라인 표현」을 리턴합니다.
int	hashCode () 이 객체의 해시 코드값을 리턴합니다.
boolean	implies (Permission p) 이 FilePermission 객체에 지정된 접근 권한이 포함되어 있는지를 판정합니다.
PermissionCollection	newPermissionCollection () FilePermission 객체를 포함하기 위한 새로운 PermissionCollection 객체를 리턴합니다.

클래스 java.security. Permission 로부터 상속된 메서드

checkGuard, getName, toString

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

FilePermission

public FilePermission(String  path,
                      String  actions)

지정된 액션을 가지는 새로운 FilePermission 객체를 작성합니다. path는 파일 또는 디렉토리의 패스명으로actions는 파일 또는 디렉토리에서 허가되는 액션의 콤마로 단락지어진 리스트입니다. 지정할 수 있는 액션은 「read」, 「write」, 「execute」 및 「delete」입니다.

「/*」( 「/」은 파일 단락 문자 File.separatorChar)로 끝나는 패스명은 디렉토리 및 그 디렉토리에 포함 떠날 수 있어 모든 파일을 나타냅니다. 「/-」으로 끝나는 패스명은 디렉토리 및 (재귀적으로) 그 디렉토리에 포함 떠날 수 있어 모든 파일 및 서브 디렉토리를 나타냅니다. 특별한 패스명 「<<ALL FILES>>」는 모든 파일과 일치합니다.

주: 1개의 「*」으로 구성되는 패스명은 현재의 디렉토리의 모든 파일을 나타내, 1개의 「-」으로 구성되는 패스명은 현재의 디렉토리의 모든 파일 및 (재귀적으로) 현재의 디렉토리에 포함 떠날 수 있어 모든 파일 및 서브 디렉토리를 나타냅니다.

파라미터:

path - 파일 또는 디렉토리의 패스명

actions - 액션의 캐릭터 라인

메서드의 상세

implies

public boolean implies(Permission  p)

이 FilePermission 객체에 지정된 접근 권한이 포함되어 있는지를 판정합니다.

즉, 이 메서드는 다음의 경우에 true를 리턴합니다.

• p가 FilePermission 인스턴스이다

• p 액션은 이 객체의 액션의 적절한 부분집합이다

• p 패스명이, 이 객체의 패스명에 포함되어 있다. 예를 들어 「/tmp/*」는 「/tmp/foo」를 포함하고 있다. 이것은 「/tmp/*」에는 「/tmp」디렉토리 및 「foo」라고 하는 이름의 파일도 포함해 그 디렉토리내의 모든 파일이 포함되어 있기 때문에

정의:

클래스 Permission 내의 implies

파라미터:

p - 체크 대상의 접근 권한

반환값:

지정된 접근 권한이 이 객체에 포함되는 경우는 true, 그렇지 않은 경우는 false

equals

public boolean equals(Object  obj)

2개의 FilePermission 객체가 동일한지 어떤지를 판정합니다. obj가 FilePermission 이며, 이 객체와 같은 패스명 및 액션을 가질지 어떨지를 조사합니다.

정의:

클래스 Permission 내의 equals

파라미터:

obj - 이 객체와 동일한지 어떤지를 판정하는 객체

반환값:

obj가 FilePermission 이며, 이 FilePermission 객체와 같은 패스명 및 액션을 가지는 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 객체의 해시 코드값을 리턴합니다.

정의:

클래스 Permission 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

getActions

public String  getActions()

액션의 「정규의 캐릭터 라인 표현」을 리턴합니다. 즉, 이 메서드는 존재하는 액션을 항상 read, write, execute, delete 순서로 리턴합니다. 예를 들어이 FilePermission 객체가 write와 read 양쪽 모두의 액션을 허가하는 경우, getActions 호출은 캐릭터 라인 「read, write」를 리턴합니다.

정의:

클래스 Permission 내의 getActions

반환값:

액션의 표준적인 캐릭터 라인 표현

newPermissionCollection

public PermissionCollection  newPermissionCollection()

FilePermission 객체를 포함하기 위한 새로운 PermissionCollection 객체를 리턴합니다.

FilePermission 객체는 임의의 순서로 컬렉션에 삽입되도록, 또한 PermissionCollection implies 메서드가 효율적으로 ( 및 안정되어) 구현되도록 포함될 필요가 있습니다.

예를 들어 다음의 2개의 FilePermission가 있어,

1. "/tmp/-", "read"
2. "/tmp/scratch/foo", "read, write",

그리고 다음의 FilePermission 로 implies 메서드를 호출하는 경우

   "/tmp/scratch/foo", "read, write", 
 

implies 함수는 「/tmp/-」 및 「/tmp/scratch/foo」의 양쪽 모두의 접근 권한을 고려하지 않으면 안되어, 그 때문에 실질적인 접근 권한은 「read, write」이며, implies는 true를 리턴합니다. FilePermission 「implies」시멘틱스는 이 newPermissionCollection 메서드에 의해 리턴된 PermissionCollection 객체에 의해 올바르게 처리됩니다.

오버라이드(override):

클래스 Permission 내의 newPermissionCollection

반환값:

FilePermission을 포함하는데 적절한 새로운 PermissionCollection 객체