java.io
클래스 File

java.lang.Object 
  java.io.File

모든 구현된 인터페이스:

Serializable, Comparable <File >

public class File
extends Object 
implements Serializable,
 Comparable <File >

파일 및 디렉토리의 패스명의 추상 표현입니다.

사용자 인터페이스 및 OS 는 시스템에 존재하는 「패스명」캐릭터 라인으로 파일 및 디렉토리를 지정합니다. 이 클래스는 계층적인 패스명의 추상적으로 시스템에 존하지 않는 뷰를 제공합니다. 「추상 패스명」은 2개의 컴퍼넌트로 구성됩니다.

1. 시스템에 의의존된 임의 지정의 「접두사」캐릭터 라인입니다. 디스크 드라이버 지시자, UNIX 루트 디렉토리의 "/" , Microsoft Windows UNC 패스명의 "\\\\" 등
2. 제로 이상의 「이름」캐릭터 라인의 순서

추상 패스명의 각 이름 (마지막 이름을 제외하다)은 디렉토리를 나타냅니다. 마지막 이름은 디렉토리나 파일의 어느 쪽인지를 나타냅니다. 빈 추상 패스명은 접두사를 가지지 않고, 빈 이름 순서입니다.

패스명 문자열과 추상 패스명의 사이의 변환은 본질적으로 시스템에 의존합니다. 추상 패스명이 패스명 문자열에 변환되면, 각 이름은 1개의 디폴트의 「단락 문자」로 단락지어집니다. 디폴트의 이름 단락 문자는 시스템 프로퍼티 file.separator로 정의되어 이 클래스의 public, static 필드인 separator 및 separatorChar 로 유효하게 됩니다. 패스명 문자열이 추상 패스명에 변환되면, 그 중의 이름은 디폴트의 이름 단락 문자로 단락지어지는지, 배후의 시스템이 지원하는 것 외의 이름 단락 문자로 단락지어집니다.

패스명 (추상 형식 또는 캐릭터 라인 형식의 어느쪽이라도)은 「절대」또는 「상대」의 어느 쪽인지입니다. 절대 패스명은 완전하고, 그것이 가리키는 파일을 찾아내기 위해서 다른 정보를 필요로 하지 않습니다. 한편, 상대 패스명은 다른 패스명으로부터의 정보를 이용해 해석될 필요가 있습니다. 디폴트에서는 java.io 패키지의 클래스는 항상 현재의 사용자 디렉토리를 기준에 상대 패스명을 해결합니다. 이 디렉토리는 시스템 프로퍼티 user.dir로 지정되어 일반적으로 Java 가상 머신의 호출원의 디렉토리입니다.

접두사의 개념은 다음과 같이, UNIX 플랫폼의 루트 디렉토리 및 Microsoft Windows 플랫폼의 드라이브 지시자, 루트 디렉토리 및 UNC 패스명을 취급하기 위해서 사용됩니다.

• UNIX 플랫폼의 경우, 절대 패스명의 접두사는 항상 "/". 상대 패스명은 접두사를 가지지 않는다. 루트 디렉토리를 나타내는 추상 패스명은 접두사 "/"와 비어있는 이름 순서를 가진다
• Microsoft Windows 플랫폼의 경우, 드라이브 지시자를 포함한 패스명의 접두사는 그 패스명이 절대의 경우는 드라이브 네임, ":" 및 "\\" 순서로 구성된다. UNC 패스명의 접두사는 "\\\\". 호스트명 및 공유명은 이름 순서 가운데 최초의 2개의 이름이 된다. 드라이브를 지정하지 않는 상대 패스명은 접두사를 가지지 않는다

File 클래스의 인스턴스는 불변입니다. 즉, 한 번 작성되면, File 객체로 나타내지는 추상 패스명은 변경되지 않습니다.

도입된 버전 :

JDK1. 0

관련 항목:

직렬화 된 형식

필드 개요

static String	pathSeparator 시스템에 의존된 패스 단락 문자입니다.
static char	pathSeparatorChar 시스템에 의존된 패스 단락 문자입니다.
static String	separator 시스템에 의존된 디폴트의 이름 단락 문자입니다.
static char	separatorChar 시스템에 의존된 디폴트의 이름 단락 문자입니다.

생성자 개요

File (File parent, String child)
부모 추상 패스명 및 자식 패스명 문자열로부터 새로운 File 인스턴스를 생성합니다.

File (String pathname)
지정된 패스명 문자열을 추상 패스명으로 변환해, 새로운 File 인스턴스를 생성합니다.

File (String parent, String child)
부모 패스명 문자열 및 자식 패스명 문자열로부터 새로운 File 인스턴스를 생성합니다.

File (URI uri)
지정된 file: URI를 추상 패스명으로 변환해, 새로운 File 인스턴스를 생성합니다.

메서드 개요

boolean	canRead () 이 추상 패스명이 가리키는 파일을읽어들일 수 있을지 어떨지를 판정합니다.
boolean	canWrite () 이 추상 패스명이 가리키는 파일을수정할 수 있을지 어떨지를 판정합니다.
int	compareTo (File pathname) 2개의 추상 패스명을 어휘적으로 비교합니다.
boolean	createNewFile () 이 추상 패스명이 가리키는 비어있는 새로운 파일을 불가분 (atomic)에 생성합니다 (그 파일이 아직 존재하지 않는 경우만).
static File	createTempFile (String prefix, String suffix) 지정된 접두사와 접미말을 파일명의 생성에 사용해, 디폴트의 임시 파일 디렉토리에 비어있는 파일을 생성합니다.
static File	createTempFile (String prefix, String suffix, File directory) 지정된 디렉토리에서 새로운 비어있는 파일을 생성해, 그 이름에는 지정된 접두사 및 접미말의 캐릭터 라인이 사용됩니다.
boolean	delete () 이 추상 패스명이 가리키는 파일 또는 디렉토리를 삭제합니다.
void	deleteOnExit () 이 추상 패스명이 가리키는 파일 또는 디렉토리가 가상 머신이 종료했을 때에 삭제되도록 요구합니다.
boolean	equals (Object obj) 이 추상 패스명이 지정된 객체와 동일한지 어떤지를 판정합니다.
boolean	exists () 이 추상 패스명이 가리키는 파일 또는 디렉토리가 존재할지 어떨지를 판정합니다.
File	getAbsoluteFile () 이 추상 패스명의 절대 형식을 리턴합니다.
String	getAbsolutePath () 이 추상 패스명의 절대 패스명 문자열을 리턴합니다.
File	getCanonicalFile () 이 추상 패스명의 정규의 형식을 리턴합니다.
String	getCanonicalPath () 이 추상 패스명의 정규의 패스명 문자열을 리턴합니다.
String	getName () 이 추상 패스명이 가리키는 파일 또는 디렉토리의 이름을 리턴합니다.
String	getParent () 이 추상 패스명의 부모 패스명 문자열을 리턴합니다.
File	getParentFile () 이 추상 패스명의 부모의 추상 패스명을 리턴합니다.
String	getPath () 이 추상 패스명을 패스명 문자열로 변환합니다.
int	hashCode () 이 추상 패스명의 해시 코드를 계산합니다.
boolean	isAbsolute () 이 추상 패스명이 절대인가 어떤가를 판정합니다.
boolean	isDirectory () 이 추상 패스명이 가리키는 파일이 디렉토리일지 어떨지를 판정합니다.
boolean	isFile () 이 추상 패스명이 가리키는 파일이 보통 파일인가 어떤가를 판정합니다.
boolean	isHidden () 이 추상 패스명이 가리키는 파일이 숨겨진 파일인가 어떤가를 판정합니다.
long	lastModified () 이 추상 패스명이 가리키는 파일이 마지막에 변경되었을 때의 시간을 리턴합니다.
long	length () 이 추상 패스명으로 가리키는 파일의 길이를 리턴합니다.
String []	list () 이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리를 나타내는 캐릭터 라인의 배열을 리턴합니다.
String []	list (FilenameFilter filter) 이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리 안에서 지정된 필터의 기준을 채우는 것의 캐릭터 라인의 배열을 리턴합니다.
File []	listFiles () 이 추상 패스명이 가리키는 디렉토리내의 파일을 나타내는 추상 패스명의 배열을 리턴합니다.
File []	listFiles (FileFilter filter) 이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리 안에서 지정된 필터의 기준을 채우는 것의 추상 패스명의 배열을 리턴합니다.
File []	listFiles (FilenameFilter filter) 이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리 안에서 지정된 필터의 기준을 채우는 것의 추상 패스명의 배열을 리턴합니다.
static File []	listRoots () 유효한 파일 시스템의 루트를 리스트 표시합니다.
boolean	mkdir () 이 추상 패스명이 가리키는 디렉토리를 생성합니다.
boolean	mkdirs () 이 추상 패스명이 가리키는 디렉토리를 생성합니다.
boolean	renameTo (File dest) 이 추상 패스명이 가리키는 파일의 이름을 변경합니다.
boolean	setLastModified (long time) 이 추상 패스명이 가리키는 파일 또는 디렉토리가 변경되었을 때의 시간을 설정합니다.
boolean	setReadOnly () 이 추상 패스명이 가리키는 파일 또는 디렉토리에 마크를 설정해, read 오퍼레이션만이 허가되도록 합니다.
String	toString () 이 추상 패스명의 패스명 문자열을 리턴합니다.
URI	toURI () 이 추상 패스명을 나타내는 file: URI를 구축합니다.
URL	toURL () 이 추상 패스명을 file: URL 로 변환합니다.

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

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

필드의 상세

separatorChar

public static final char separatorChar

시스템에 의존된 디폴트의 이름 단락 문자입니다. 이 필드는 시스템 프로퍼티 file.separator값의 최초의 문자를 포함하도록 초기화됩니다. UNIX 시스템의 경우, 이 필드의 값은 '/', Microsoft Windows 시스템의 경우는 '\\' 입니다.

관련 항목:

System.getProperty(java.lang.String)

separator

public static final String  separator

시스템에 의존된 디폴트의 이름 단락 문자입니다. 편리하게 캐릭터 라인으로 나타내집니다. 이 캐릭터 라인은 1 문자, 즉 separatorChar 입니다.

pathSeparatorChar

public static final char pathSeparatorChar

시스템에 의존된 패스 단락 문자입니다. 이 필드는 시스템 프로퍼티 path.separator값의 최초의 문자를 포함하도록 초기화됩니다. 이 문자는 「패스 리스트」로서 건네받는 파일의 순서중의 파일명을 단락짓기 위해서 사용됩니다. UNIX 시스템의 경우, 이 단락 문자는 ':' 입니다. Microsoft Windows 시스템에서는 ';' 입니다.

관련 항목:

System.getProperty(java.lang.String)

pathSeparator

public static final String  pathSeparator

시스템에 의존된 패스 단락 문자입니다. 편리하게 캐릭터 라인으로 나타내집니다. 이 캐릭터 라인은 1 문자 즉 pathSeparatorChar 입니다.

생성자 상세

File

public File(String  pathname)

지정된 패스명 문자열을 추상 패스명으로 변환해, 새로운 File 인스턴스를 생성합니다. 지정된 캐릭터 라인이 비어있는 캐릭터 라인의 경우, 결과는 비어있는 추상 패스명이 됩니다.

파라미터:

pathname - 패스명 문자열

예외:

NullPointerException - pathname인수가 null인 경우

File

public File(String  parent,
            String  child)

부모 패스명 문자열 및 자식 패스명 문자열로부터 새로운 File 인스턴스를 생성합니다.

parent이 null인 경우, 새로운 File 인스턴스는 지정된 child 패스명 문자열로 단일 인수의 File 생성자를 호출한 것처럼 생성됩니다.

그렇지 않은 경우, parent 패스명 문자열은 디렉토리를 나타내, child 패스명 문자열은 디렉토리 또는 파일을 나타냅니다. child 패스명 문자열이 절대의 경우, 그것은 시스템에 의존된 방법으로 상대 패스명에 변환됩니다. parent이 비어있는 캐릭터 라인의 경우, 새로운 File 인스턴스는 child를 추상 패스명으로 변환해, 그 결과를 시스템에 의존된 디폴트 디렉토리를 기준에 해결하는 것으로 생성됩니다. 그렇지 않은 경우, 각 패스명 문자열은 추상 패스명에 변환되어자식 추상 패스명은 부모를 기준에 해결됩니다.

파라미터:

parent - 부모 패스명 문자열

child - 자식 패스명 문자열

예외:

NullPointerException - child가 null인 경우

File

public File(File  parent,
            String  child)

부모 추상 패스명 및 자식 패스명 문자열로부터 새로운 File 인스턴스를 생성합니다.

parent이 null인 경우, 새로운 File 인스턴스는 지정된 child 패스명 문자열로 단일 인수의 File 생성자를 호출한 것처럼 생성됩니다.

그렇지 않은 경우, parent 추상 패스명은 디렉토리를 나타내, child 패스명 문자열은 디렉토리 또는 파일을 나타냅니다. child 패스명 문자열이 절대의 경우, 그것은 시스템에 의존된 방법으로 상대 패스명에 변환됩니다. parent이 비어있는 추상 패스명의 경우, 새로운 File 인스턴스는 child를 추상 패스명으로 변환해, 그 결과를 시스템에 의존된 디폴트 디렉토리를 기준에 해결하는 것으로 생성됩니다. 그렇지 않은 경우, 각 패스명 문자열은 추상 패스명에 변환되어자식 추상 패스명은 부모를 기준에 해결됩니다.

파라미터:

parent - 부모 추상 패스명

child - 자식 패스명 문자열

예외:

NullPointerException - child가 null인 경우

File

public File(URI  uri)

지정된 file: URI를 추상 패스명으로 변환해, 새로운 File 인스턴스를 생성합니다.

file: URI 형식은 시스템에 존하기 위해, 이 생성자가 실시하는 변환도 시스템에 의존합니다.

지정된 추상 패스명이 f인 경우는 다음과 같이 변환됩니다.

new File( f. toURI ()). equals( f. getAbsoluteFile ())

이 예의 경우, 원의 추상 패스명, URI 및 새로운 추상 패스명은 같은 Java 가상 머신의 복수의 호출로 작성할 필요가 있습니다. 다만, 어느 OS 의 가상 머신으로 작성한 file: URI를 다른 OS 의 가상 머신의 추상 패스명으로 변환하는 경우, 일반적으로 이와 같이 변환되지 않습니다.

파라미터:

uri - 계층형의 절대 URI. 형식은, "file", 패스, 권한, 쿼리, fragment. 패스는 반드시 지정한다. 권한, 쿼리 및 fragment는 정의하지 않는다

예외:

NullPointerException - uri가 null인 경우

IllegalArgumentException - 상기의 파라미터의 전제 조건이 채워지지 않은 경우

도입된 버전 :

1.4

관련 항목:

toURI(), URI

메서드의 상세

getName

public String  getName()

이 추상 패스명이 가리키는 파일 또는 디렉토리의 이름을 리턴합니다. 이것은 패스명의 이름 순서의 마지막 이름입니다. 패스명의 이름 순서가 비어있는 경우, 비어있는 캐릭터 라인이 리턴됩니다 .

반환값:

이 추상 패스명이 가리키는 파일 또는 디렉토리의 이름. 이 패스명의 이름 순서가 비어있는 경우는 비어있는 캐릭터 라인

getParent

public String  getParent()

이 추상 패스명의 부모 패스명 문자열을 리턴합니다. 이 패스명이 친디렉토리를 나타내지 않는 경우는 null을 리턴합니다.

추상 패스명의 「부모」는 패스명의 접두사 (존재하는 경우) 및 패스명의 이름 순서의 각 이름 (마지막 이름을 제외하다)으로 구성됩니다. 이름 순서가 비어있는 경우, 패스명은 친디렉토리를 나타내지 않습니다.

반환값:

이 추상 패스명이 가리키는 부모디렉토리의 패스명 문자열. 이 패스명이 부모를 나타내지 않는 경우는 null

getParentFile

public File  getParentFile()

이 추상 패스명의 부모의 추상 패스명을 리턴합니다. 이 패스명이 친디렉토리를 나타내지 않는 경우는 null을 리턴합니다.

추상 패스명의 「부모」는 패스명의 접두사 (존재하는 경우) 및 패스명의 이름 순서의 각 이름 (마지막 이름을 제외하다)으로 구성됩니다. 이름 순서가 비어있는 경우, 패스명은 친디렉토리를 나타내지 않습니다.

반환값:

이 추상 패스명이 가리키는 부모디렉토리의 추상 패스명. 이 패스명이 부모를 나타내지 않는 경우는 null

도입된 버전 :

1.2

getPath

public String  getPath()

이 추상 패스명을 패스명 문자열로 변환합니다. 결과의 캐릭터 라인은 default name-separator character를 사용해 이름 순서의 이름을 단락짓습니다.

반환값:

이 추상 패스명의 캐릭터 라인 형식

isAbsolute

public boolean isAbsolute()

이 추상 패스명이 절대인가 어떤가를 판정합니다. 절대 패스명의 정의는 시스템에 의존합니다. UNIX 시스템의 경우, 패스명은 접두사가 "/"인 경우에 절대입니다. Microsoft Windows 시스템의 경우, 패스명은 접두사가 드라이브 지시자의 뒤에 "\\"가 계속되는 경우, 또는 접두사가 "\\\\"인 경우에 절대입니다.

반환값:

이 추상 패스명이 절대인 경우는 true, 그렇지 않은 경우는 false

getAbsolutePath

public String  getAbsolutePath()

이 추상 패스명의 절대 패스명 문자열을 리턴합니다.

이 추상 패스명이 이미 절대인 경우, 패스명 문자열은 getPath() 메서드와 같이 간단하게 리턴됩니다 . 이 추상 패스명이 비어있는 추상 패스명의 경우, 현재의 사용자 디렉토리 (시스템 프로퍼티 user.dir로 나타난다)의 패스명 문자열이 리턴됩니다 . 그렇지 않은 경우, 이 패스명은 시스템에 의존된 방법으로 해결됩니다. UNIX 시스템의 경우, 상대 패스명은 현재의 사용자 디렉토리를 기준에 해결하는 것으로 절대로 됩니다. Microsoft Windows 시스템의 경우, 상대 패스명은 패스명으로 나타난 드라이브의 현재의 디렉토리가 있는 경우는 그것을 기준에 해결하는 것으로 절대로 됩니다. 없는 경우는 현재의 사용자 디렉토리를 기준에 해결됩니다.

반환값:

이 추상 패스명과 같은 파일 또는 디렉토리를 나타내는 절대 패스명 문자열

예외:

SecurityException - 필수의 시스템 프로퍼티의 값에 액세스 할 수 없는 경우

관련 항목:

isAbsolute()

getAbsoluteFile

public File  getAbsoluteFile()

이 추상 패스명의 절대 형식을 리턴합니다. new File(this. getAbsolutePath() ())와 동등합니다.

반환값:

이 추상 패스명과 같은 파일 또는 디렉토리를 나타내는 절대 패스명

예외:

SecurityException - 필수의 시스템 프로퍼티의 값에 액세스 할 수 없는 경우

도입된 버전 :

1.2

getCanonicalPath

public String  getCanonicalPath()
                        throws IOException 

이 추상 패스명의 정규의 패스명 문자열을 리턴합니다.

정규의 패스명은 일의의 절대 패스입니다. 정규의 패스명의 정확한 정의는 시스템에 의존합니다. 이 메서드는 우선, 필요에 따라서 패스명을 절대 형식으로 변환합니다. 결과는 getAbsolutePath() 메서드를 호출했을 경우와 같게 됩니다. 다음에 시스템에 의존된 일의의 형식에 그 패스명을 맵 합니다. 이 때, 일반적으로 패스명으로부터 ". " (이)나 ".." 등의 장황명을 삭제해, 기호 연결을 해결해 (UNIX 플랫폼의 경우), 드라이브 네임의 대문자와 소문자를 적절히 변환합니다 (Microsoft Windows 플랫폼의 경우) .

기존의 파일 또는 디렉토리를 나타내는 각 패스명에는 각각 고유의 정규의 형식이 있습니다. 존재하지 않는 파일 또는 디렉토리를 나타내는 각 패스명에도 고유의 정규의 형식이 있습니다. 존재하지 않는 파일 또는 디렉토리의 패스명의 정규의 형식은 그 파일 또는 디렉토리가 작성된 뒤의 같은 패스명의 정규의 형식과는 다른 경우가 있습니다. 똑같이, 기존의 파일 또는 디렉토리의 패스명의 정규의 형식은 그 파일 또는 디렉토리가 삭제된 뒤의 같은 패스명의 정규의 형식과는 다른 경우가 있습니다.

반환값:

이 추상 패스명과 같은 파일 또는 디렉토리를 나타내는 정규 패스명 문자열

예외:

IOException - 입출력 에러가 발생했을 경우. 정규의 패스명을 구축하는 것으로 파일 시스템의 쿼리를 요구하면 발생한다

SecurityException - 필수의 시스템 프로퍼티의 값에 액세스 할 수 없는 경우, 또는 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.io.FileDescriptor) 메서드가 파일의 read 액세스를 허가하지 않는 경우

도입된 버전 :

JDK1. 1

getCanonicalFile

public File  getCanonicalFile()
                      throws IOException 

이 추상 패스명의 정규의 형식을 리턴합니다. new File(this. getCanonicalPath() ())와 동등합니다.

반환값:

이 추상 패스명과 같은 파일 또는 디렉토리를 나타내는 정규 패스명 문자열

예외:

IOException - 입출력 에러가 발생했을 경우. 정규의 패스명을 구축하는 것으로 파일 시스템의 쿼리를 요구하면 발생한다

SecurityException - 필수의 시스템 프로퍼티의 값에 액세스 할 수 없는 경우, 또는 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.io.FileDescriptor) 메서드가 파일의 read 액세스를 허가하지 않는 경우

도입된 버전 :

1.2

toURL

public URL  toURL()
          throws MalformedURLException 

이 추상 패스명을 file: URL 로 변환합니다. URL 정확한 형식은 시스템에 의존합니다. 이 추상 패스명이 가리키는 파일이 디렉토리이라고 판별할 수 있었을 경우, 변환 후의 URL는 slash로 끝납니다.

사용상의 주의: 이 메서드에서는 URL 내에서 사용할 수 없는 이스케이프 문자는 자동적으로 변환할 수 없습니다. 새로운 코드의 추상 패스명을 URL 로 변환하려면, 우선 toURI 메서드를 사용해 URI 로 변환하고 나서, URI.toURL 메서드를 사용해 URL 로 변환하는 것을 추천합니다.

반환값:

파일 URL를 나타내는 URL 객체

예외:

MalformedURLException - 패스를 URL 로서 구문 분석 할 수 없는 경우

도입된 버전 :

1.2

관련 항목:

toURI(), URI, URI.toURL(), URL

toURI

public URI  toURI()

이 추상 패스명을 나타내는 file: URI를 구축합니다.

URI 정확한 형식은 시스템에 의존합니다. 이 추상 패스명이 가리키는 파일이 디렉토리이라고 판별할 수 있었을 경우, 변환 후의 URI는 slash로 끝납니다.

지정된 추상 패스명이 f인 경우는 다음과 같이 변환됩니다.

new File ( f. toURI()). equals( f. getAbsoluteFile ())

이 예의 경우, 원의 추상 패스명, URI 및 새로운 추상 패스명은 같은 Java 가상 머신의 복수의 호출로 작성할 필요가 있습니다. 다만, 어느 OS 의 가상 머신으로 작성한 file: URI를 다른 OS 의 가상 머신의 추상 패스명으로 변환하는 경우, 추상 패스명은 시스템에 존하기 위해, 일반적으로 이와 같이 변환되지 않습니다.

반환값:

계층형의 절대 URI. 형식은, "file", 패스, 권한, 쿼리, fragment. 패스는 이 추상 패스명. 권한, 쿼리 및 fragment는 정의하지 않는

도입된 버전 :

1.4

관련 항목:

File(java.net.URI), URI, URI.toURL()

canRead

public boolean canRead()

이 추상 패스명이 가리키는 파일을읽어들일 수 있을지 어떨지를 판정합니다.

반환값:

이 추상 패스명이 가리키는 파일이 존재해, 또한 어플리케이션을 그것을 읽어들일 수 있는 경우만 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 파일에의 읽기 액세스를 허가하지 않는 경우

canWrite

public boolean canWrite()

이 추상 패스명이 가리키는 파일을수정할 수 있을지 어떨지를 판정합니다.

반환값:

파일 시스템에 이 추상 패스명이 가리키는 파일이 실제로 있어, 또한 어플리케이션이 그 파일에 출력할 수 있는 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 파일에의 쓰기 권한을 허가하지 않는 경우

exists

public boolean exists()

이 추상 패스명이 가리키는 파일 또는 디렉토리가 존재할지 어떨지를 판정합니다.

반환값:

이 추상 패스명이 가리키는 파일 또는 디렉토리가 존재하는 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 파일 또는 디렉토리에의 읽기 액세스를 허가하지 않는 경우

isDirectory

public boolean isDirectory()

이 추상 패스명이 가리키는 파일이 디렉토리일지 어떨지를 판정합니다.

반환값:

이 추상 패스명이 가리키는 파일이 존재해, 또한 그것이 디렉토리인 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 파일에의 읽기 액세스를 허가하지 않는 경우

isFile

public boolean isFile()

이 추상 패스명이 가리키는 파일이 보통 파일인가 어떤가를 판정합니다. 파일은 그것이 디렉토리가 아니고, 시스템에 의존된 것 외의 기준을 채우는 경우에 「보통」의 파일이라고 보여집니다. Java 어플리케이션이 생성한 디렉토리 이외의 파일은 반드시 보통 파일입니다.

반환값:

이 추상 패스명이 가리키는 파일이 존재해, 또한 그것이 보통 파일인 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 파일에의 읽기 액세스를 허가하지 않는 경우

isHidden

public boolean isHidden()

이 추상 패스명이 가리키는 파일이 숨겨진 파일인가 어떤가를 판정합니다. 「은폐」의 정확한 정의는 시스템에 의존합니다. UNIX 시스템의 경우, 파일은 그 이름이 피리어드 ('. ')로 시작되는 경우에 숨겨진 파일이라고 보여집니다. Microsoft Windows 시스템의 경우, 파일은 파일 시스템으로 그처럼 마크가 설정되어 있는 경우에 숨겨진 파일이라고 보여집니다.

반환값:

이 추상 패스명이 가리키는 파일이 기본이 되는 플랫폼의 규약에 따라 은폐 파일이라고 보여지는 경우만 true

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 파일에의 읽기 액세스를 허가하지 않는 경우

도입된 버전 :

1.2

lastModified

public long lastModified()

이 추상 패스명이 가리키는 파일이 마지막에 변경되었을 때의 시간을 리턴합니다.

반환값:

파일이 마지막에 변경되었을 때의 시간을 나타내는 long값. 신기원 (1970 년 1 월 1 일 0 시 0 분 0 초, 그리니지 표준시)으로부터 밀리 세컨드 단위로 측정. 파일이 존재하지 않는지, 입출력 에러가 발생했을 경우는 0L

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 파일에의 읽기 액세스를 허가하지 않는 경우

length

public long length()

이 추상 패스명으로 가리키는 파일의 길이를 리턴합니다. 패스명에 디렉토리가 가리키는 경우, 반환값은 지정되지 않습니다.

반환값:

이 추상 패스명이 가리키는 파일의 길이 (바이트 단위). 파일이 존재하지 않는 경우는 0L

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 파일에의 읽기 액세스를 허가하지 않는 경우

createNewFile

public boolean createNewFile()
                      throws IOException 

이 추상 패스명이 가리키는 비어있는 새로운 파일을 불가분 (atomic)에 생성합니다 (그 파일이 아직 존재하지 않는 경우만). 파일이 있을지 어떨지의 체크나, 없는 경우의 파일의 생성은 그 파일에 영향을 줄 가능성이 있는 것 외의 모든 파일 시스템의 처리에 대해서 불가분인 단일의 오퍼레이션입니다.

주: 이 메서드의 결과로서 얻을 수 있는 프로토콜은 신뢰해 동작 시킬 수 없기 때문에 이 메서드를 파일 락에 사용해 되지 않습니다. 대신에 FileLock 기능을 사용할 필요가 있습니다.

반환값:

지정된 파일이 존재하지 않고, 파일의 생성에 성공했을 경우는 true, 나타난 파일이 이미 존재하는 경우는 false

예외:

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

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 파일에의 쓰기 권한을 허가하지 않는 경우

도입된 버전 :

1.2

delete

public boolean delete()

이 추상 패스명이 가리키는 파일 또는 디렉토리를 삭제합니다. 이 패스명이 디렉토리를 나타내는 경우, 그 디렉토리가 삭제되기 위해서는 비어있을 필요가 있습니다.

반환값:

파일 또는 디렉토리가 정상적으로 삭제되었을 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkDelete(java.lang.String) 메서드가 파일에의 삭제 액세스를 허가하지 않는 경우

deleteOnExit

public void deleteOnExit()

이 추상 패스명이 가리키는 파일 또는 디렉토리가 가상 머신이 종료했을 때에 삭제되도록 요구합니다. 삭제는 Java 언어 사양으로 정의되고 있도록, 가상 머신이 정상 종료하는 경우에만 시행됩니다.

삭제가 일단 요구되면, 그 요구는 취소할 수 없습니다. 그 때문에 이 메서드의 사용에는 주의가 필요합니다.

주: 이 메서드의 결과로서 얻을 수 있는 프로토콜은 신뢰해 동작 시킬 수 없기 때문에 이 메서드를 파일 락에 사용해 되지 않습니다. 대신에 FileLock 기능을 사용할 필요가 있습니다.

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkDelete(java.lang.String) 메서드가 파일에의 삭제 액세스를 허가하지 않는 경우

도입된 버전 :

1.2

관련 항목:

delete()

list

public String [] list()

이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리를 나타내는 캐릭터 라인의 배열을 리턴합니다.

이 추상 패스명이 디렉토리를 나타내지 않는 경우, 이 메서드는 null을 리턴합니다. 디렉토리를 나타내는 경우는 캐릭터 라인의 배열이 리턴됩니다 . 캐릭터 라인은 디렉토리내의 각 파일 또는 디렉토리 마다 1개 입니다. 그 디렉토리 자체 및 그 부모의 디렉토리를 나타내는 이름은 결과에 포함되지 않습니다. 각 캐릭터 라인은 절대 패스가 아니고 파일명입니다.

결과의 배열의 이름 캐릭터 라인은 특정의 순서로는 되지 않습니다. 알파벳순서가 되는 것은 아닙니다.

반환값:

이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리를 나타내는 캐릭터 라인의 배열. 디렉토리가 비어있는 경우, 배열은 비운다. 이 추상 패스명이 디렉토리를 나타내지 않는 경우, 또는 입출력 에러가 발생했을 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 디렉토리에의 읽기 액세스를 허가하지 않는 경우

list

public String [] list(FilenameFilter  filter)

이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리 안에서 지정된 필터의 기준을 채우는 것의 캐릭터 라인의 배열을 리턴합니다. 이 메서드의 동작은, list() 메서드와 같습니다만, 리턴된 배열의 캐릭터 라인은 필터의 기준을 채울 필요가 있습니다. 지정된 filter가 null인 경우, 모든 이름이 받아들여집니다. 그렇지 않은 경우, 이름이 필터의 기준을 채우는 것은 필터의 FilenameFilter.accept(java.io.File, java.lang.String) 메서드가 이 추상 패스명 및 그것이 가리키는 디렉토리내의 파일 또는 디렉토리의 이름으로 불려 갔을 때에 true가 리턴된인 경우만입니다.

파라미터:

filter - 파일명 필터

반환값:

지정된 filter에 의해 받아들여진, 이 추상 패스명이 가리키는 디렉토리내의 파일 및 디렉토리를 나타내는 캐릭터 라인의 배열. 배열은 디렉토리가 비어있는 경우 또는 필터가 어느 이름도 받아들이지 않는 경우는 비운다. 이 추상 패스명이 디렉토리를 나타내지 않는 경우, 또는 입출력 에러가 발생했을 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 디렉토리에의 읽기 액세스를 허가하지 않는 경우

listFiles

public File [] listFiles()

이 추상 패스명이 가리키는 디렉토리내의 파일을 나타내는 추상 패스명의 배열을 리턴합니다.

이 추상 패스명이 디렉토리를 나타내지 않는 경우, 이 메서드는 null을 리턴합니다. 디렉토리를 나타내는 경우, File 객체의 배열이 리턴됩니다 . File 객체는 디렉토리내의 각 파일 또는 디렉토리 마다 1개 입니다. 디렉토리 자체 및 그 부모의 디렉토리를 나타내는 패스명은 결과에 포함되지 않습니다. 결과의 각 추상 패스명은, File(File, String) 생성자를 사용하는 것으로써, 이 추상 패스명으로부터 생성됩니다. 그 때문에 이 패스명이 절대의 경우, 결과의 각 패스명은 절대입니다. 이 패스명이 상대의 경우, 결과의 각 패스명은 같은 디렉토리에 대해서 상대입니다.

결과의 배열의 이름 캐릭터 라인은 특정의 순서로는 되지 않습니다. 알파벳순서가 되는 것은 아닙니다.

반환값:

이 추상 패스명이 가리키는 디렉토리내의 파일 및 디렉토리를 나타내는 추상 패스명의 배열. 배열은 디렉토리가 비어있는 경우는 비운다. 이 추상 패스명이 디렉토리를 나타내지 않는 경우, 또는 입출력 에러가 발생했을 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 디렉토리에의 읽기 액세스를 허가하지 않는 경우

도입된 버전 :

1.2

listFiles

public File [] listFiles(FilenameFilter  filter)

이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리 안에서 지정된 필터의 기준을 채우는 것의 추상 패스명의 배열을 리턴합니다. 이 메서드의 동작은 listFiles() 메서드와 같습니다만, 리턴된 배열내의 패스명은 필터의 기준을 채울 필요가 있습니다. 지정된 filter가 null인 경우, 모든 패스명이 받아들여집니다. 그렇지 않은 경우, 패스명이 필터의 기준을 채우는 것은 이 추상 패스명 및 그것이 가리키는 디렉토리내의 파일 또는 디렉토리의 이름으로 필터의 FilenameFilter.accept(java.io.File, java.lang.String) 메서드가 불려 갔을 때에 true가 리턴된인 경우만입니다.

파라미터:

filter - 파일명 필터

반환값:

이 추상 패스명이 가리키는 디렉토리내의 파일 및 디렉토리를 나타내는 추상 패스명의 배열. 배열은 디렉토리가 비어있는 경우는 비운다. 이 추상 패스명이 디렉토리를 나타내지 않는 경우, 또는 입출력 에러가 발생했을 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 디렉토리에의 읽기 액세스를 허가하지 않는 경우

도입된 버전 :

1.2

listFiles

public File [] listFiles(FileFilter  filter)

이 추상 패스명이 가리키는 디렉토리에 있는 파일 및 디렉토리 안에서 지정된 필터의 기준을 채우는 것의 추상 패스명의 배열을 리턴합니다. 이 메서드의 동작은 listFiles() 메서드와 같습니다만, 리턴된 배열내의 패스명은 필터의 기준을 채울 필요가 있습니다. 지정된 filter가 null인 경우, 모든 패스명이 받아들여집니다. 그렇지 않은 경우, 패스명이 필터의 기준을 채우는 것은 이 필터의 FileFilter.accept(java.io.File) 메서드가 패스명으로 불려 갔을 때에 true값이 리턴된인 경우만입니다.

파라미터:

filter - 파일 필터

반환값:

이 추상 패스명이 가리키는 디렉토리내의 파일 및 디렉토리를 나타내는 추상 패스명의 배열. 배열은 디렉토리가 비어있는 경우는 비운다. 이 추상 패스명이 디렉토리를 나타내지 않는 경우, 또는 입출력 에러가 발생했을 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 디렉토리에의 읽기 액세스를 허가하지 않는 경우

도입된 버전 :

1.2

mkdir

public boolean mkdir()

이 추상 패스명이 가리키는 디렉토리를 생성합니다.

반환값:

디렉토리가 생성되었을 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 지정된 디렉토리의 생성을 허가하지 않는 경우

mkdirs

public boolean mkdirs()

이 추상 패스명이 가리키는 디렉토리를 생성합니다. 존재하고 있지 않지만 필요한 친디렉토리도 함께 작성됩니다. 이 오퍼레이션이 실패했을 경우에서도, 몇개의 필요한 부모디렉토리의 생성에는 성공하고 있는 경우가 있습니다.

반환값:

필요한 모든 친디렉토리를 포함해 디렉토리가 생성되었을 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkRead(java.lang.String) 메서드가 지정된 디렉토리와 필요한 모든 부모디렉토리의 존재 확인을 허가하지 않는 경우. 또는 SecurityManager.checkWrite(java.lang.String) 메서드가 지정된 디렉토리와 필요한 모든 부모디렉토리의 생성을 허가하지 않는 경우

renameTo

public boolean renameTo(File  dest)

이 추상 패스명이 가리키는 파일의 이름을 변경합니다.

이 메서드의 동작의 측면의 상당수는 본질적으로 플랫폼에 의존합니다. 즉, 이름 변경 조작에의해 1개의 파일 시스템으로부터 다른 파일 시스템에 파일이 이동되지 않는 이름 변경 조작이 불가분은 아닌, 이동처의 추상 패스명을 가지는 파일이 이미 존재하면 이름 변경 조작이 성공하지 않는등의 현상이 일어날 가능성이 있습니다. 리턴된 값은 이름 변경 조작이 성공했는지 어떠했는지를 확인하기 위해, 반드시 체크하지 않으면 안됩니다.

파라미터:

dest - 지정된 파일의 새로운 추상 패스명

반환값:

이름의 변경이 성공했을 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 낡은 패스명으로 새로운 패스명의 어느 쪽인지에의 출력 액세스를 허가하지 않는 경우

NullPointerException - 파라미터 dest이 null인 경우

setLastModified

public boolean setLastModified(long time)

이 추상 패스명이 가리키는 파일 또는 디렉토리가 변경되었을 때의 시간을 설정합니다.

모든 플랫폼은 초단위에 말 수 있었던 파일 변경 시각을 지원합니다만, 안에는 좀 더 높은 정밀도를 지원하는 것도 있습니다. 인수는 지원되고 있는 정밀도에 맞추어 절약할 수 있습니다. 오퍼레이션이 성공해, 끼어드는 오퍼레이션이 파일상에서 일어나지 않는 경우, lastModified() 메서드의 다음의 호출은 이 메서드에게 건네진 time인수 (절약할 수 있었을 경우가 있다)를 리턴합니다.

파라미터:

time - 최신으로 변경되었을 때 각. 신기원 (1970 년 1 월 1 일 0 시 0 분 0 초, 그리니지 표준시)으로부터 밀리 세컨드 단위로 측정

반환값:

오퍼레이션이 성공했을 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalArgumentException - 인수가 잘못된 값 의 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 지정된 파일에의 쓰기 권한을 허가하지 않는 경우

도입된 버전 :

1.2

setReadOnly

public boolean setReadOnly()

이 추상 패스명이 가리키는 파일 또는 디렉토리에 마크를 설정해, read 오퍼레이션만이 허가되도록 합니다. 이 메서드를 호출하면, 파일 또는 디렉토리는 그것이 삭제되는지, 출력 액세스를 허가하도록 마크를 설정할 때까지 변경되지 않습니다. 읽기 전용 파일 또는 디렉토리를 삭제할 수 있을지 어떨지는 배후의 시스템에 의존합니다.

반환값:

오퍼레이션이 성공했을 경우는 true, 그렇지 않은 경우는 false

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 지정된 파일에의 쓰기 권한을 허가하지 않는 경우

도입된 버전 :

1.2

listRoots

public static File [] listRoots()

유효한 파일 시스템의 루트를 리스트 표시합니다.

특정의 Java 플랫폼은 제로 또는 1개 이상의 계층적으로 편성된 파일 시스템을 지원합니다. 각 파일 시스템에는 그 파일 시스템외의 모든 파일에 도달할 수 있는 root 디렉토리가 있습니다. 예를 들어 Windows 플랫폼에는 활성화된 드라이브 마다 루트 디렉토리가 있습니다. UNIX 플랫폼의 루트 디렉토리는 "/" 1개 뿐입니다. 일련의 유효한 파일 시스템의 루트는 리모트 미디어의 삽입과 꺼내 및 물리 디스크 드라이버 또는 가상 디스크 드라이버의 절단 또는 언마운트등의, 다양한 시스템 레벨의 오퍼레이션에 영향을 받습니다.

이 메서드는 유효한 파일 시스템의 루트의 루트 디렉토리를 나타내는 File 객체의 배열을 리턴합니다. 로컬 머신에 물리적으로 존재하는 파일의 정규의 패스명은 반드시 이 메서드로 리턴된 루트로부터 시작됩니다.

다른 머신에 존재해, 리모트 파일 시스템 프로토콜 (SMB 또는 NFS 등)을 개입시켜 액세스 할 수 있는 파일의 정규의 패스명은 이 메서드로 리턴된 루트로부터 시작되어도, 시작되지 않아도 괜찮습니다. 리모트 파일의 패스명이 로컬 파일의 패스명과 구문상 구별할 수 없는 경우, 그것은 이 메서드로 리턴된 루트로부터 시작됩니다. 이 때문에 예를 들어 Windows 플랫폼의 매핑 된 네트워크 드라이브의 루트 디렉토리를 나타내는 File객체는 이 메서드로 리턴됩니다 만, UNC 패스명을 포함한 File객체는 이 메서드로 돌려주고지지 않습니다.

이 클래스의 대부분의 메서드와 달라, 이 메서드는 시큐러티 예외를 Throw 하지 않습니다. 시큐러티 매니저가 존재해, SecurityManager.checkRead(java.lang.String) 메서드가 특정의 루트 디렉토리에의 읽기 액세스를 거부하는 경우, 그 디렉토리는 결과에 나타나지 않습니다.

반환값:

유효한 파일 시스템의 루트를 나타내는 File 객체의 배열. 일련의 루트를 판별할 수 없는 경우는 null. 배열은 파일 시스템의 루트가 없는 경우는 비우는

도입된 버전 :

1.2

createTempFile

public static File  createTempFile(String  prefix,
                                  String  suffix,
                                  File  directory)
                           throws IOException 

지정된 디렉토리에서 새로운 비어있는 파일을 생성해, 그 이름에는 지정된 접두사 및 접미말의 캐릭터 라인이 사용됩니다. 이 메서드가 정상적으로 복귀하는 경우, 다음 일이 보증됩니다.

1. 리턴된 추상 패스명이 가리키는 파일이 존재하는 것은 이 메서드가 불려 간 후에 있다
2. 이 메서드 또는 그 파생 메서드의 어느 것도 가상 머신의 현재의 호출로 다시 같은 추상 패스명을 돌려주지 않는다

이 메서드는 일부의 임시 파일 기능만을 제공합니다. 이 메서드로 생성된 파일이 자동적으로 삭제되도록 하려면, deleteOnExit() 메서드를 사용합니다.

prefix인수의 길이는 3 문자 이상 필요합니다. 접두사는 "hjb" 또는 "mail" 등이 짧아서 미가 있는 캐릭터 라인으로의해 주세요. suffix인수는 null도 지정할 수 있어 그 경우, 접미말 ". tmp"가 사용됩니다.

새로운 파일을 생성하기 위해서 우선 접두사 및 접미말이 기본이 되는 플랫폼의 제한에 맞추어 조정됩니다. 접두사가 너무 긴 경우는 절약할 수 있습니다만, 최초의 3 문자는 항상 보존됩니다. 접미말이 너무 긴 경우는 절약할 수 있습니다만, 그것이 피리어드 ('. ')로 시작되는 경우, 피리어드 및 그 후의 최초의 3 문자는 항상 보존됩니다. 이러한 조정이 끝나면, 접두사, 5 개 이상의 내부에서 생성된 문자 및 접미말을 연결해 새로운 파일명이 생성됩니다.

directory인수가 null인 경우, 시스템에 의존된 디폴트의 임시 파일 디렉토리가 사용됩니다. 디폴트의 임시 파일 디렉토리는 시스템 프로퍼티 java.io.tmpdir로 지정됩니다. UNIX 시스템의 경우, 이 프로퍼티의 디폴트의 값은 보통 "/tmp" 또는 "/var/tmp" 입니다. Microsoft Windows 시스템의 경우는 보통, "C:\\WINNT\\TEMP" 입니다. 다만, Java 가상 머신을 시작했을 때에 이 시스템 프로퍼티에 다른 값이 지정되는 일이 있습니다. 프로그램을 사용해 이 프로퍼티를 변경해도, 이 메서드가 사용하는 일시 디렉토리를 변경할 수 있다고는 할 수 없습니다.

파라미터:

prefix - 파일명을 생성하기 위해서 사용되는 접두사 캐릭터 라인. 3 문자 이상의 길이가 필요한

suffix - 파일명을 생성하기 위해서 사용되는 접미말캐릭터 라인. null도 지정할 수 있어 그 경우는 접미말 ". tmp"가 사용되는

directory - 파일이 생성되는 디렉토리. 디폴트의 임시 파일 디렉토리가 사용되는 경우는 null

반환값:

새로운 작성된 비어있는 파일을 나타내는 추상 패스명

예외:

IllegalArgumentException - prefix인수가 3 문자에 못 미친 경우

IOException - 파일을 생성할 수 없었던 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 파일의 생성을 허가하지 않는 경우

도입된 버전 :

1.2

createTempFile

public static File  createTempFile(String  prefix,
                                  String  suffix)
                           throws IOException 

지정된 접두사와 접미말을 파일명의 생성에 사용해, 디폴트의 임시 파일 디렉토리에 비어있는 파일을 생성합니다. 이 메서드를 호출하는 것은, createTempFile(prefix, suffix, null) 를 호출하는 것과 같습니다.

파라미터:

prefix - 파일명을 생성하기 위해서 사용되는 접두사 캐릭터 라인. 3 문자 이상의 길이가 필요한

suffix - 파일명을 생성하기 위해서 사용되는 접미말캐릭터 라인. null도 지정할 수 있어 그 경우는 접미말 ". tmp"가 사용된다

반환값:

새로운 작성된 비어있는 파일을 나타내는 추상 패스명

예외:

IllegalArgumentException - prefix인수가 3 문자에 못 미친 경우

IOException - 파일을 생성할 수 없었던 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 SecurityManager.checkWrite(java.lang.String) 메서드가 파일의 생성을 허가하지 않는 경우

도입된 버전 :

1.2

compareTo

public int compareTo(File  pathname)

2개의 추상 패스명을 어휘적으로 비교합니다. 이 메서드가 정의하는 순서는 배후의 시스템에 의존합니다. UNIX 시스템의 경우, 패스명의 비교로 알파벳의 대문자와 소문자가 미를 가집니다. Microsoft Windows 시스템의 경우는 미를 가지지 않습니다.

정의:

인터페이스 Comparable <File > 내의 compareTo

파라미터:

pathname - 이 추상 패스명으로 비교되는 추상 패스명

반환값:

인수가 이 추상 패스명으로 동일한 경우는 0. 이 추상 패스명이 인수보다 어휘적으로 작은 경우는 잘못된 값. 이 추상 패스명이 인수보다 어휘적으로 큰 경우는 정의 값

도입된 버전 :

1.2

equals

public boolean equals(Object  obj)

이 추상 패스명이 지정된 객체와 동일한지 어떤지를 판정합니다. 인수가 null은 아니고, 이 추상 패스명과 같은 파일 또는 디렉토리를 나타내는 추상 패스명인 경우만 true를 리턴합니다. 2개의 추상 패스명이 동일한지 어떤지는 배후의 시스템에 의존합니다. UNIX 시스템의 경우, 알파벳의 대문자와 소문자가 패스명의 비교로 미를 가집니다. Microsoft Windows 시스템에서는 미를 가지지 않습니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 이 추상 패스명으로 비교되는 객체

반환값:

2개의 객체가 같은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 추상 패스명의 해시 코드를 계산합니다. 추상 패스명이 동일한지 어떤지는 본질적으로 시스템에 존하므로 그러한 해시 코드의 계산도 같습니다. UNIX 시스템의 경우, 추상 패스명의 해시 코드는 그 패스명 문자열과 10 진수치 1234321 배타적 논리합과 동일해집니다. Microsoft Windows 시스템의 경우, 해시 코드는 그 패스명 문자열 (소문자에 변환된 것)과 10 진수치 1234321 배타적 논리합과 동일해집니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 추상 패스명의 해시 코드

관련 항목:

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

toString

public String  toString()

이 추상 패스명의 패스명 문자열을 리턴합니다. 이것은, getPath() 메서드로 리턴된 캐릭터 라인입니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 추상 패스명의 캐릭터 라인 형식