클래스 java.io.File

클래스 java.io.File

java.lang.Object
   |
   +----java.io.File

---

public class File

extends Object

implements Serializable

이 클래스의 인스턴스는 호스트 파일 시스템의 파일명 또는 디렉토리를 나타냅니다. 파일은 경로명으로 지정되며, 경로명은 절대 경로명 또는 현재 작업 디렉토리에 상대적인 경로명일 수 있습니다. 경로명은 호스트 플랫폼의 명명 규칙을 따라야 합니다.

File 클래스는 기계와 무관한 방식의 파일 및 경로명에 대한 대부분의 기계 종속적인 복잡성을 처리하는 추상 개념을 제공합니다.

파일명 또는 경로가 사용될 때마다, 호스트의 파일 명명 규칙이 사용된다고 가정합니다.

---

변수 색인

pathSeparator

시스템 종속 경로 분리자 문자열

pathSeparatorChar

시스템 종속 경로 분리자

separator

시스템 종속 경로 분리자

separatorChar

시스템 종속 경로 분리자 문자열

---

생성자 색인

File(File, String)

지정된 디렉토리에 지정된 이름으로 파일을 나타내는 File 인스턴스를 작성합니다.

File(String)

파일명이 주어진 경로 인수인 파일을 나타내는 File 인스턴스를 작성합니다.

File(String, String)

경로명이 지정된 디렉토리, 분리자 및 name 인수로 구성된 File 인스턴스를 작성합니다.

---

메소드 색인

canRead()

응용프로그램이 지정된 파일에서 읽을 수 있는지 여부를 테스트합니다.

canWrite()

응용프로그램이 파일에 기록할 수 있는지 여부를 테스트합니다.

delete()

객체가 지정하는 파일을 삭제합니다.

equals(Object)

객체를 지정된 객체와 비교합니다.

exists()

File이 있는지 여부를 테스트합니다.

getAbsolutePath()

객체가 나타내는 파일의 절대 경로명을 리턴합니다.

getCanonicalPath()

File 객체의 경로명에 대한 표준 양식을 리턴합니다.

getName()

객체가 나타내는 파일의 이름을 리턴합니다.

getParent()

File 객체 경로명의 상위 파트를 리턴하거나, 이름에 상위 파트가 없는 경우 null을 리턴합니다.

getPath()

객체가 나타내는 파일의 경로명을 리턴합니다.

hashCode()

파일에 대한 해시 코드를 계산합니다.

isAbsolute()

File 객체가 나타내는 파일이 절대 경로명인지 여부를 테스트합니다.

isDirectory()

File 객체가 나타내는 파일이 디렉토리인지 여부를 테스트합니다.

isFile()

File 객체가 나타내는 파일이 "보통" 파일인지 여부를 테스트합니다.

lastModified()

File 객체가 나타내는 파일이 마지막으로 수정된 시간을 리턴합니다.

length()

File 객체가 나타내는 파일의 길이를 리턴합니다.

list()

File 객체가 지정하는 디렉토리 내의 파일의 목록을 리턴합니다.

list(FilenameFilter)

지정된 필터를 만족시키는 File이 지정하는 디렉토리 내의 파일의 목록을 리턴합니다.

mkdir()

File 객체가 경로명을 지정하는 디렉토리를 작성합니다.

mkdirs()

필요한 상위 디렉토리를 포함하여 File 객체가 경로명을 지정하는 디렉토리를 작성합니다.

renameTo(File)

File 인수가 제공하는 경로명을 갖도록 File 객체가 지정한 파일을 다른 이름으로 변경합니다.

toString()

객체의 문자열 표현을 리턴합니다.

---

변수

separator

 public static final String separator

시스템 종속 경로 분리자. 이 필드는 시스템 특성 file.separator의 값을 포함하도록 초기화됩니다.

참조:

getProperty

separatorChar

 public static final char separatorChar

시스템 종속 경로 분리자 문자열. 이 필드는 시스템 특성 file.separator값의 첫번째 문자를 포함하도록 초기화됩니다. 이 문자는 디렉토리와 파일명의 파일 컴포넌트를 분리합니다.

참조:

getProperty

pathSeparator

 public static final String pathSeparator

시스템 종속 경로 분리자 문자열. 이 필드는 시스템 특성 file.separator값을 포함하도록 초기화됩니다.

참조:

getProperty

pathSeparatorChar

 public static final char pathSeparatorChar

시스템 종속 경로 분리자. 이 필드는 시스템 특성 file.separator값의 첫번째 문자를 포함하도록 초기화됩니다. 이 문자는 자주 "경로 목록"으로 제공되는 파일 순서에서 파일명을 분리하는 데 사용됩니다.

참조:

getProperty

---

생성자

File

 public File(String path)

파일명이 주어진 경로 인수인 파일을 나타내는 File 인스턴스를 작성합니다.

매개변수:

path - 파일 경로명

오류: NullPointerException

파일 경로가 null인 경우

참조:

getPath

File

 public File(String path,
             String name)

경로명이 지정된 디렉토리, 분리자 및 name 인수로 구성된 File 인스턴스를 작성합니다.

매개변수:

path - 디렉토리 경로명

name - 파일 경로명

참조:

getPath, separator

File

 public File(File dir,
             String name)

지정된 디렉토리에 지정된 이름으로 파일을 나타내는 File 인스턴스를 작성합니다.

디렉토리 인수가 null인 경우, 결과 File 인스턴스는 경로명이 name 인수인 (시스템 종속) 현재 디렉토리 내의 파일을 나타냅니다. 그렇지 않으면 File 인스턴스는 경로명이 디렉토리의 경로명, 분리자, name 인수인 파일을 나타냅니다.

매개변수:

dir - 디렉토리

name - 파일 경로명

참조:

getPath, separator

---

메소드

getName

 public String getName()

객체가 나타내는 파일의 이름을 리턴합니다. 이 이름은 마지막 분리자 발생 후의 경로명입니다.

결과:

File 객체로 표현되는 파일의 이름(디렉토리 컴포넌트 없음)

참조:

getPath, separator

getPath

 public String getPath()

객체가 나타내는 파일의 경로명을 리턴합니다.

결과:

File 객체가 나타내는 경로명

getAbsolutePath

 public String getAbsolutePath()

객체가 나타내는 파일의 절대 경로명을 리턴합니다. 이 객체가 절대 경로명을 나타내는 경우, 절대 경로명을 리턴합니다. 그렇지 않으면 현재 사용자 디렉토리, 분리자 및 파일 객체의 경로명을 결합한 경로명을 리턴합니다.

시스템 특성 user.dir에는 현재 사용자 디렉토리가 포함됩니다.

결과:

File에 대한 시스템 종속 절대 경로명

참조:

getPath, isAbsolute, getProperty

getCanonicalPath

 public String getCanonicalPath() throws IOException

File 객체의 경로명에 대한 표준 양식을 리턴합니다. 표준 양식의 정확한 정의는 시스템 종속적이나, 보통 현재 사용자 디렉토리에 대한 모든 상대적 참조가 완전하게 분석되는 절대 경로명을 지정합니다. 없는 파일 경로명의 표준 양식은 정의할 수 없는 경우도 있습니다.

오류: IOException

표준 경로의 구성시 파일 시스템 조회가 필요할 수 있기 때문에 I/O 오류가 발생하는 경우

getParent

 public String getParent()

File 객체 경로명의 상위 파트를 리턴하거나, 이름에 상위 파트가 없는 경우 null을 리턴합니다. 상위 파트는 일반적으로 정확한 정의가 시스템 종속적인 경우에도 분리자의 최종 발생을 가져오는 모든 것입니다. UNIX의 경우, 예를 들어 "/usr/lib"의 상위 파트는 "/usr"이고, 해당 상위 파트는 상위가 없는"/"입니다. Windows 플랫폼의 경우, "c:\java"의 상위 파트는 상위가 없는 "c:\"입니다.

참조:

getPath, getCanonicalPath, separator

exists

 public boolean exists()

File이 있는지 여부를 테스트합니다.

결과:

객체가 지정하는 파일이 있는 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, checkRead

canWrite

 public boolean canWrite()

응용프로그램이 파일에 기록할 수 있는지 여부를 테스트합니다.

결과:

응용프로그램이 객체에 의해 이름이 지정된 파일에 기록할 수 있는 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 쓰기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkWrite 메소드가 호출됨

참조:

getPath, checkWrite

canRead

 public boolean canRead()

응용프로그램이 지정된 파일에서 읽을 수 있는지 여부를 테스트합니다.

결과:

객체가 지정하는 파일이 있고 응용프로그램이 파일을 읽을 수 있는 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, checkRead

isFile

 public boolean isFile()

File 객체가 나타내는 파일이 "보통" 파일인지 여부를 테스트합니다.

파일은 디렉토리가 아니고 다른 시스템 종속 기준을 만족시키는 경우 "보통" 파일입니다. Java 응용프로그램이 작성한 디렉토리가 아닌 파일은 보통 파일입니다.

결과:

객체가 지정하는 파일이 있고 파일이 "보통" 파일인 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, checkRead

isDirectory

 public boolean isDirectory()

File 객체가 나타내는 파일이 디렉토리인지 여부를 테스트합니다.

결과:

File이 있고 디렉토리인 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, checkRead

isAbsolute

 public native boolean isAbsolute()

File 객체가 나타내는 파일이 절대 경로명인지 여부를 테스트합니다. 절대 경로명의 정의는 시스템 종속적입니다. 예를 들어, UNIX에서 첫번째 문자가 분리자인 경우 절대 경로명입니다. Windows 플랫폼에서는 첫번째 문자가 ASCII '\' 또는 '/'이거나 콜론이 뒤에 오는 문자로 시작되는 경우 절대 경로명입니다.

결과:

File 객체가 나타내는 경로명이 절대 경로명인 경우 true, 그렇지 않으면 false

참조:

getPath, separator

lastModified

 public long lastModified()

File 객체가 나타내는 파일이 마지막으로 수정된 시간을 리턴합니다.

리턴값은 시스템 종속적이며 최종 수정으로 리턴된 다른 값과 비교하는 데에만 사용되어야 합니다. 절대 시간으로 해석되어서는 안 됩니다.

결과:

객체가 지정한 파일이 최종 수정된 시간, 또는 지정된 파일이 없는 경우 0L

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, checkRead

length

 public long length()

File 객체가 나타내는 파일의 길이를 리턴합니다.

결과:

객체가 지정한 파일의 길이(바이트 단위), 또는 지정된 파일이 없는 경우 0L

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, checkRead

mkdir

 public boolean mkdir()

File 객체가 경로명을 지정하는 디렉토리를 작성합니다.

결과:

디렉토리를 작성할 수 있는 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 쓰기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkWrite 메소드가 호출됨

참조:

getPath, checkWrite

renameTo

 public boolean renameTo(File dest)

File 인수가 제공하는 경로명을 갖도록 File 객체가 지정한 파일을 다른 이름으로 변경합니다.

매개변수:

dest - 새로운 파일명

결과:

다른 이름으로 변경한 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, checkWrite 메소드를 파일 객체의 경로명과 목적지 목표 객체의 경로명으로 호출하여 응용프로그램이 두 파일 모두에 기록할 수 있는지를 알아봄

참조:

getPath, checkWrite

mkdirs

 public boolean mkdirs()

필요한 상위 디렉토리를 포함하여 File 객체가 경로명을 지정하는 디렉토리를 작성합니다.

결과:

디렉토리(들)를 작성할 수 있는 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 디렉토리를 작성하기 전에 작성될 디렉토리 각각의 경로명으로 checkWrite 메소드가 호출됨

참조:

getPath, checkWrite

list

 public String[] list()

File 객체가 지정하는 디렉토리 내의 파일의 목록을 리턴합니다.

결과:

지정된 디렉토리 내의 파일명 배열. 이 목록에는 현재 디렉토리 또는 상위 디렉토리(Unix 시스템에서 "." 및 "..")가 포함되지 않습니다.

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, checkRead

list

 public String[] list(FilenameFilter filter)

지정된 필터를 만족시키는 File이 지정하는 디렉토리 내의 파일의 목록을 리턴합니다.

매개변수:

filter - 필터 파일명

결과:

지정된 디렉토리 내의 파일명 배열. 이 목록에는 현재 디렉토리 또는 상위 디렉토리(Unix 시스템에서 "." 및 "..")가 포함되지 않습니다.

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일에 읽기 액세스할 수 있는지를 보기 위해 File의 경로명으로 checkRead 메소드가 호출됨

참조:

getPath, FilenameFilter, checkRead

delete

 public boolean delete()

객체가 지정하는 파일을 삭제합니다. 삭제될 목표 파일이 디렉토리인 경우, 삭제를 위해 비워야 합니다.

결과:

파일이 삭제되는 경우 true, 그렇지 않으면 false

오류: SecurityException

보안 관리 프로그램이 있는 경우, 응용프로그램이 해당 파일을 삭제할 수 있는지를 보기 위해 File의 경로명으로 checkDelete 메소드가 호출됨

참조:

getPath, checkDelete

hashCode

 public int hashCode()

파일에 대한 해시 코드를 계산합니다.

결과:

File 객체에 대한 해시 코드값

대체:

Object 클래스에 있는 hashCode

equals

 public boolean equals(Object obj)

객체를 지정된 객체와 비교합니다. 인수가 null이 아니고 경로명이 객체의 경로명인 경우 File이라면, true를 리턴합니다.

매개변수:

obj - 비교할 객체

결과:

객체가 동일한 경우 true, 그렇지 않으면 false

대체:

Object 클래스에 있는 equals

toString

 public String toString()

객체의 문자열 표현을 리턴합니다.

결과:

객체의 경로명을 제공하는 문자열

대체:

Object 클래스에 있는 toString

참조:

getPath