Class File

package org.kwis.msp.io

java.lang.Object
  |
  +--org.kwis.msp.io.File

설명

extends Object:

파일에 대한 읽기/쓰기와 같은 기본적인 기능과 Stream 기능 지원을 위한 클래스입니다.

파일이름은 모두 절대경로로 되어 있습니다. 실제로는 플랫폼에서 허용하는 디렉토리안에서 모든 파일을 만들고 지울 수 있게 되어있습니다. 사용자입장에서는 플랫폼에서 어떤 식으로 지원하든 상관없이 절대경로로 사용하면 됩니다.

구분자(separator)의 경우 유닉스 시스템의 관행을 따랐습니다. 그러므로 "/"를 사용하면 됩니다.

FileSystem 클래스와 마찬가지로 경로를 지정하는 메소드의 경우 접근 방법에 대한 제한이 있습니다. 접근방법은 아래와 같은 3가지가 있습니다.

FileSystem.PRIVATE_ACCESS, FileSystem.SHARED_ACCESS, FileSystem.SYSTEM_ACCESS

아래와 같은 메소드를 호출하기 위해서는 반드시 접근 수준을 명시해야 합니다.

• open(String, int, int)

어떤 모드로 open하느냐에 따라 열 수 있는 stream의 갯수가 제한되어 있습니다.

• Read Only모드로 open할 경우 input stream을 하나만 열 수 있고 output stream은 열 수 없습니다.
• Write Only모드로 open할 경우 output stream은 하나만 열 수 있고, input stream은 열 수 없습니다.
• Read/Write모드로 open할 경우 output stream은 모두 하나씩 열 수 있습니다.

File 메소드 중에서는 low level로 보다 빠른 접근을 가능하게 하는 API가 있습니다.

• read(byte[])
• read(byte[], int, int)
• write(byte[])
• write(byte[], int, int)
• write(int)
• seek(int)
• sizeOf()

등이 바로 그런 API입니다.

openInputStream(), openOutputStream(), openDataInputStream(), openDataOutputStream() 을 이용해서 파일에서 읽고 파일에 쓰는 것 보다 빠르게 접근할 수 있습니다.

필드 요약

• protected  int maxInputStream — 열 수 있는 최대 InputStream 갯수
• protected  int maxOutputStream — 열 수 있는 최대 OutputStream 갯수
• static int READ_ONLY — 읽기만 할 때 쓰는 옵션
• static int READ_WRITE — 읽기와 쓰기를 동시에 하기 위한 옵션
• static int WRITE — 기존의 파일이 있으면 파일의 제일 끝부터 쓰기 시작하기 위한 옵션
• static int WRITE_TRUNC — 기존의 파일이 있으면 크기를 0으로 만들고 열기위한 옵션

생성자 요약

• File ( String filename, int mode) 응용프로그램 자신만의 디렉토리에 지정된 파일을 생성합니다.
• File ( String filename, int mode, int flag) 파일을 생성합니다.

메서드 요약

• void close () — 파일을 닫습니다.
• DataInputStream openDataInputStream () — DataInputStream 을 가져옵니다.
• DataOutputStream openDataOutputStream () — DataOutputStream 을 가져옵니다.
• InputStream openInputStream () — InputStream 을 가져옵니다.
• OutputStream openOutputStream () — OutputStream 을 가져옵니다.
• int read (byte[] buf) — input stream으로 부터 데이타를 읽어 들입니다.
• int read (byte[] buf, int off, int len) — input stream으로 부터 데이타를 len 바이트수만큼 읽어 들입니다.
• void seek (int pos) — 파일 포인터를 특정 위치로 옮깁니다.
• int sizeOf () — 파일의 크기를 알려줍니다.
• int write (byte[] buf) — 파일에 buf 에 들어 있는 데이타를 buf 의 길이만큼 씁니다.
• int write (byte[] buf, int off, int len) — 파일에 buf 에 들어 있는 데이타를 off 부터 시작해서 len 만큼 씁니다.
• int write (int b) — 파일에 한 바이트만 쓸 때 사용합니다.

필드 상세

maxInputStream

protected int maxInputStream

• 열 수 있는 최대 InputStream 갯수

maxOutputStream

protected int maxOutputStream

• 열 수 있는 최대 OutputStream 갯수

READ_ONLY

public static final int READ_ONLY

• 읽기만 할 때 쓰는 옵션

WRITE

public static final int WRITE

• 기존의 파일이 있으면 파일의 제일 끝부터 쓰기 시작하기 위한 옵션

WRITE_TRUNC

public static final int WRITE_TRUNC

• 기존의 파일이 있으면 크기를 0으로 만들고 열기위한 옵션

READ_WRITE

public static final int READ_WRITE

• 읽기와 쓰기를 동시에 하기 위한 옵션

File

public File(String filename,
            int mode)
     throws IOException

Parameters:

• mode - READ_ONLY, WRITE,WRITE_TRUNC, READ_WRITE중 하나

Throws:

• IOException - 파일을 열 수 없을 경우

See Also:

• FileSystem

File

public File(String filename,
            int mode,
            int flag)
     throws IOException,
            SecurityException

Parameters:

• flag - FileSystem.PRIVATE_ACCESS, FileSystem.SHARED_ACCESS, FileSystem.SYSTEM_ACCESS중 하나

Throws:

• SecurityException - 접근할 수 없는 디렉토리를 접근할려고 할려고할 경우

See Also:

• FileSystem

openInputStream

public InputStream openInputStream()
                            throws IOException

Returns:

• 파일에 대한 InputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 InputStream이 열려 있을 경우

See Also:

• InputStream

openDataInputStream

public DataInputStream openDataInputStream()
                                    throws IOException

Returns:

• 파일에 대한 DataInputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 InputStream이 열려 있을 경우

See Also:

• DataInputStream

openOutputStream

public OutputStream openOutputStream()
                              throws IOException

Returns:

• 파일에 대한 OutputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 OutputStream이 열려 있을 경우

See Also:

• OutputStream

openDataOutputStream

public DataOutputStream openDataOutputStream()
                                      throws IOException

Returns:

• 파일에 대한 DataOutputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 OutputStream이 열려 있을 경우

See Also:

• DataOutputStream

close

public void close()
           throws IOException

Throws:

• IOException - 파일을 제대로 닫을 수 없을 경우

write

public int write(int b)
          throws IOException

Parameters:

• b - 쓸 한 바이트

Throws:

• IOException - close함수로 닫혀진 File에서 write하는 경우이거나, 제대로 쓸 수 없을 경우

write

public int write(byte[] buf)
          throws IOException,
                 NullPointerException

Parameters:

• buf - 실제 데이타가 들어있는 byte array

Throws:

• NullPointerException - buf가 null인 경우

write

public int write(byte[] buf,
                 int off,
                 int len)
          throws IOException,
                 NullPointerException

Parameters:

• len - 실제로 쓸 데이타 크기

Throws:

• IOException - buf가 null인 경우

read

public int read(byte[] buf)
         throws IOException,
                NullPointerException

Parameters:

• buf - 읽은 데이타를 담을 바이트 배열

Returns:

• 읽은 바이트수 또는 한 바이트도 읽기전에 EOF를 만나면 -1

Throws:

• NullPointerException - buf가 null인 경우

read

public int read(byte[] buf,
                int off,
                int len)
         throws IOException,
                NullPointerException

Parameters:

• len - 얼마만큼 읽을 것인가를 나타냅니다.

Returns:

• 읽은 바이트수 또는 한 바이트도 읽기전에 EOF를 만나면 -1

Throws:

• NullPointerException - buf가 null인 경우

seek

public void seek(int pos)
          throws IOException

Parameters:

• pos - 옮길 파일 포인터 위치, 반드시 파일의 처음부터의 절대 값이여야합니다.

Throws:

• IOException - 파일 handle이 제대로 세팅되지 않았거나 파일 포인터를 옮기는 도중 에러가 발생했을 경우

sizeOf

public int sizeOf()
           throws IOException

Returns:

• 파일의 크기

Throws:

• IOException - 파일 handle이 제대로 세팅되지 않았거나 크기를 읽어 오는도중 에러가 발생했을 경우

생성자 상세

File

public File(String filename,
            int mode)
     throws IOException

Parameters:

• mode - READ_ONLY, WRITE,WRITE_TRUNC, READ_WRITE중 하나

Throws:

• IOException - 파일을 열 수 없을 경우

See Also:

• FileSystem

File

public File(String filename,
            int mode,
            int flag)
     throws IOException,
            SecurityException

Parameters:

• flag - FileSystem.PRIVATE_ACCESS, FileSystem.SHARED_ACCESS, FileSystem.SYSTEM_ACCESS중 하나

Throws:

• SecurityException - 접근할 수 없는 디렉토리를 접근할려고 할려고할 경우

See Also:

• FileSystem

openInputStream

public InputStream openInputStream()
                            throws IOException

Returns:

• 파일에 대한 InputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 InputStream이 열려 있을 경우

See Also:

• InputStream

openDataInputStream

public DataInputStream openDataInputStream()
                                    throws IOException

Returns:

• 파일에 대한 DataInputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 InputStream이 열려 있을 경우

See Also:

• DataInputStream

openOutputStream

public OutputStream openOutputStream()
                              throws IOException

Returns:

• 파일에 대한 OutputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 OutputStream이 열려 있을 경우

See Also:

• OutputStream

openDataOutputStream

public DataOutputStream openDataOutputStream()
                                      throws IOException

Returns:

• 파일에 대한 DataOutputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 OutputStream이 열려 있을 경우

See Also:

• DataOutputStream

close

public void close()
           throws IOException

Throws:

• IOException - 파일을 제대로 닫을 수 없을 경우

write

public int write(int b)
          throws IOException

Parameters:

• b - 쓸 한 바이트

Throws:

• IOException - close함수로 닫혀진 File에서 write하는 경우이거나, 제대로 쓸 수 없을 경우

write

public int write(byte[] buf)
          throws IOException,
                 NullPointerException

Parameters:

• buf - 실제 데이타가 들어있는 byte array

Throws:

• NullPointerException - buf가 null인 경우

write

public int write(byte[] buf,
                 int off,
                 int len)
          throws IOException,
                 NullPointerException

Parameters:

• len - 실제로 쓸 데이타 크기

Throws:

• IOException - buf가 null인 경우

read

public int read(byte[] buf)
         throws IOException,
                NullPointerException

Parameters:

• buf - 읽은 데이타를 담을 바이트 배열

Returns:

• 읽은 바이트수 또는 한 바이트도 읽기전에 EOF를 만나면 -1

Throws:

• NullPointerException - buf가 null인 경우

read

public int read(byte[] buf,
                int off,
                int len)
         throws IOException,
                NullPointerException

Parameters:

• len - 얼마만큼 읽을 것인가를 나타냅니다.

Returns:

• 읽은 바이트수 또는 한 바이트도 읽기전에 EOF를 만나면 -1

Throws:

• NullPointerException - buf가 null인 경우

seek

public void seek(int pos)
          throws IOException

Parameters:

• pos - 옮길 파일 포인터 위치, 반드시 파일의 처음부터의 절대 값이여야합니다.

Throws:

• IOException - 파일 handle이 제대로 세팅되지 않았거나 파일 포인터를 옮기는 도중 에러가 발생했을 경우

sizeOf

public int sizeOf()
           throws IOException

Returns:

• 파일의 크기

Throws:

• IOException - 파일 handle이 제대로 세팅되지 않았거나 크기를 읽어 오는도중 에러가 발생했을 경우

메서드 상세

openInputStream

public InputStream openInputStream()
                            throws IOException

Returns:

• 파일에 대한 InputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 InputStream이 열려 있을 경우

See Also:

• InputStream

openDataInputStream

public DataInputStream openDataInputStream()
                                    throws IOException

Returns:

• 파일에 대한 DataInputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 InputStream이 열려 있을 경우

See Also:

• DataInputStream

openOutputStream

public OutputStream openOutputStream()
                              throws IOException

Returns:

• 파일에 대한 OutputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 OutputStream이 열려 있을 경우

See Also:

• OutputStream

openDataOutputStream

public DataOutputStream openDataOutputStream()
                                      throws IOException

Returns:

• 파일에 대한 DataOutputStream

Throws:

• IOException - 파일이 아직 열리지 않았거나 이미 OutputStream이 열려 있을 경우

See Also:

• DataOutputStream

close

public void close()
           throws IOException

Throws:

• IOException - 파일을 제대로 닫을 수 없을 경우

write

public int write(int b)
          throws IOException

Parameters:

• b - 쓸 한 바이트

Throws:

• IOException - close함수로 닫혀진 File에서 write하는 경우이거나, 제대로 쓸 수 없을 경우

write

public int write(byte[] buf)
          throws IOException,
                 NullPointerException

Parameters:

• buf - 실제 데이타가 들어있는 byte array

Throws:

• NullPointerException - buf가 null인 경우

write

public int write(byte[] buf,
                 int off,
                 int len)
          throws IOException,
                 NullPointerException

Parameters:

• len - 실제로 쓸 데이타 크기

Throws:

• IOException - buf가 null인 경우

read

public int read(byte[] buf)
         throws IOException,
                NullPointerException

Parameters:

• buf - 읽은 데이타를 담을 바이트 배열

Returns:

• 읽은 바이트수 또는 한 바이트도 읽기전에 EOF를 만나면 -1

Throws:

• NullPointerException - buf가 null인 경우

read

public int read(byte[] buf,
                int off,
                int len)
         throws IOException,
                NullPointerException

Parameters:

• len - 얼마만큼 읽을 것인가를 나타냅니다.

Returns:

• 읽은 바이트수 또는 한 바이트도 읽기전에 EOF를 만나면 -1

Throws:

• NullPointerException - buf가 null인 경우

seek

public void seek(int pos)
          throws IOException

Parameters:

• pos - 옮길 파일 포인터 위치, 반드시 파일의 처음부터의 절대 값이여야합니다.

Throws:

• IOException - 파일 handle이 제대로 세팅되지 않았거나 파일 포인터를 옮기는 도중 에러가 발생했을 경우

sizeOf

public int sizeOf()
           throws IOException

Returns:

• 파일의 크기

Throws:

• IOException - 파일 handle이 제대로 세팅되지 않았거나 크기를 읽어 오는도중 에러가 발생했을 경우