java.io
클래스 FilePermission

java.lang.Object 
  |
  +--java.security.Permission 
        |
        +--java.io.FilePermission

모든 구현 인터페이스:

Guard , Serializable

public final class FilePermission

extends Permission

implements Serializable

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

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

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

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

read

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 kr의 「*」으로 구성되는 패스명은 현재의 디렉토리의 모든 파일을 나타내, 1 kr의 「-」으로 구성되는 패스명은 현재의 디렉토리의 모든 파일, 및 (재귀적으로) 현재의 디렉토리에 저장 떠날 수 있어 모든 파일 및 서브 디렉토리를 나타냅니다.

파라미터:

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

hashCode

public int hashCode()

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

정의:

클래스 Permission 내의 hashCode

반환값:

이 오브젝트의 해시 코드치

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 오브젝트