javax.tools
인터페이스 FileObject

기존의 서브 인터페이스의 일람:

JavaFileObject

기존의 구현 클래스의 일람:

ForwardingFileObject , ForwardingJavaFileObject , SimpleJavaFileObject

public interface FileObject

툴용의 파일의 추상화입니다. 이 문맥에서는, 「파일」이라고 하는 말로, 일반적으로 파일과 그 외의 데이터 소스를 추상적으로 나타냅니다. 예를 들어, 파일 객체를 사용해, 일반적으로 파일, 메모리 캐쉬, 또는 데이타베이스내의 데이터를 나타낼 수가 있습니다.

이 인터페이스에 포함되는 모든 메소드는, 시큐리티 예외가 발생했을 경우에, SecurityException 를 throw 할 가능성이 있습니다.

명시적으로 허가되어 있지 않은 경우에 인수로서 null 가 지정되면(자), 이 인터페이스에 포함되는 모든 메소드는 NullPointerException 를 throw 할 가능성이 있습니다.

도입된 버젼:

1.6

메소드의 개요

boolean	delete () 이 파일 객체를 삭제합니다.
CharSequence	getCharContent (boolean ignoreEncodingErrors) 가능하면, 이 파일 다이얼로그의 문자 컨텐츠를 가져옵니다.
long	getLastModified () 이 파일 객체가 마지막에 변경된 시각을 가져옵니다.
String	getName () 이 파일 객체를 나타내는, 사용자가 사용하기 쉬운 이름을 가져옵니다.
InputStream	openInputStream () 이 파일 객체의 InputStream 를 가져옵니다.
OutputStream	openOutputStream () 이 파일 객체의 OutputStream 를 가져옵니다.
Reader	openReader (boolean ignoreEncodingErrors) 이 객체의 리더를 가져옵니다.
Writer	openWriter () 이 파일 객체의 Writer 를 가져옵니다.
URI	toUri () 이 파일 객체를 식별하는 URI 를 돌려줍니다.

메소드의 상세

toUri

URI  toUri()

이 파일 객체를 식별하는 URI 를 돌려줍니다.

반환값:

URI

getName

String  getName()

이 파일 객체를 나타내는, 사용자가 사용하기 쉬운 이름을 가져옵니다. 반환되는 정확한 값은 지정되고 있지 않습니다만, 구현은, 사용자가 지정한 이름을 보관 유지하게 되어 있습니다. 예를 들어, 사용자가 커멘드행에 파일명 "BobsApp\Test.java" 를 지정했을 경우, 이 메소드는 "BobsApp\Test.java" 를 돌려줄 것입니다. 한편,toUri 메소드는 file:///C:/Documents%20and%20Settings/UncleBob/BobsApp/Test.java 를 돌려줄 가능성이 있습니다.

반환값:

사용자가 사용하기 쉬운 이름

openInputStream

InputStream  openInputStream()
                            throws IOException 

이 파일 객체의 InputStream 를 가져옵니다.

반환값:

InputStream

예외:

IllegalStateException - 이 파일 객체가, 기입해 가능한 동시에 읽어내 불가인 경우

UnsupportedOperationException - 이 종류의 파일 객체가 바이트 액세스를 지원하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

openOutputStream

OutputStream  openOutputStream()
                              throws IOException 

이 파일 객체의 OutputStream 를 가져옵니다.

반환값:

OutputStream

예외:

IllegalStateException - 이 파일 객체가, 읽어내 가능한 동시에 기입해 불가인 경우

UnsupportedOperationException - 이 종류의 파일 객체가 바이트 액세스를 지원하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

openReader

Reader  openReader(boolean ignoreEncodingErrors)
                  throws IOException 

이 객체의 리더를 가져옵니다. 반환되는 리더는, 복호화 할 수 없는 바이트를 디폴트의 변환 문자로 옮겨놓습니다. 게다가ignoreEncodingErrors 가 true 가 아니면, 진단 정보를 보고하는 일도 있습니다.

파라미터:

ignoreEncodingErrors - true 의 경우는 encode 에러를 무시

반환값:

Reader

예외:

IllegalStateException - 이 파일 객체가, 기입해 가능한 동시에 읽어내 불가인 경우

UnsupportedOperationException - 이 종류의 파일 객체가 문자 액세스를 지원하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

getCharContent

CharSequence  getCharContent(boolean ignoreEncodingErrors)
                            throws IOException 

가능하면, 이 파일 다이얼로그의 문자 컨텐츠를 가져옵니다. 복호화 할 수 없는 바이트는, 디폴트의 변환 문자로 옮겨놓을 수 있습니다. 게다가ignoreEncodingErrors 가 true 가 아니면, 진단 정보가 보고되는 일도 있습니다.

파라미터:

ignoreEncodingErrors - true 의 경우는 encode 에러를 무시

반환값:

이용 가능한 CharSequence 가 있는 경우는, 그 CharSequence. 그렇지 않은 경우는 null

예외:

IllegalStateException - 이 파일 객체가, 기입해 가능한 동시에 읽어내 불가인 경우

UnsupportedOperationException - 이 종류의 파일 객체가 문자 액세스를 지원하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

openWriter

Writer  openWriter()
                  throws IOException 

이 파일 객체의 Writer 를 가져옵니다.

반환값:

Writer

예외:

IllegalStateException - 이 파일 객체가, 읽어내 가능한 동시에 기입해 불가인 경우

UnsupportedOperationException - 이 종류의 파일 객체가 문자 액세스를 지원하지 않는 경우

IOException - 입출력 에러가 발생했을 경우

getLastModified

long getLastModified()

이 파일 객체가 마지막에 변경된 시각을 가져옵니다. 이 시각은, 1970 년 1 월 1 일 0 시 0 분 0 초 (그리니지 표준시)부터 밀리 세컨드 단위로 측정됩니다.

반환값:

이 파일 객체가 마지막에 변경된 시각. 파일 객체가 존재하지 않는 경우, 입출력 에러가 발생했을 경우, 또는 조작이 지원되어 있지 않은 경우는 0

delete

boolean delete()

이 파일 객체를 삭제합니다. 에러의 경우는 false 를 돌려줍니다.

반환값:

이 파일 객체가 정상적으로 삭제되었을 경우에 한해 true. 그렇지 않은 경우는 false