java.io
클래스 FileOutputStream

java.lang.Object 
  |
  +--java.io.OutputStream 
        |
        +--java.io.FileOutputStream

public class FileOutputStream

extends OutputStream

File 또는 FileDescriptor 에 데이터를 기입하기 위한 파일 출력 스트림입니다. 파일을 이용할 수 있을지 어떨지 혹은 작성할 수 있을까는 기본이 되는 플랫폼에 의존합니다. 특히,FileOutputStream 또는 파일 기입 오브젝트를 한 번에 1 kr만 사용해 기입용으로 파일을 열 수가 있는 플랫폼도 있습니다. 이러한이라고 하고 관계하는 파일이 열려 있는 경우는 이 클래스의 constructor 은 실패합니다.

FileOutputStream 는 생의 바이트 (이미지 데이터등)의 스트림을 읽어들일 때 사용합니다. 캐릭터의 스트림을 기입할 때는 FileWriter 를 사용해 주세요.

도입된 버젼:

JDK1. 0

관련 항목:

File , FileDescriptor , FileInputStream

생성자의 개요

FileOutputStream (File file)
지정된 File 오브젝트로 나타내지는 파일에 기입하기 위한 파일 출력 스트림을 작성합니다.

FileOutputStream (File file, boolean append)
지정된 File 오브젝트가 나타내는 파일에 기입하기 위한 출력 파일 스트림을 작성합니다.

FileOutputStream (FileDescriptor fdObj)
파일 시스템의 실제의 파일에의 기존의 접속을 나타내는 지정된 파일 기술자에게 기입하기 위한 출력 파일 스트림을 작성합니다.

FileOutputStream (String name)
지정된 File 오브젝트에 기입하기 위한 파일 출력 스트림을 작성합니다.

FileOutputStream (String name, boolean append)
지정된 name 의 파일에 기입하기 위한 출력 파일 스트림을 작성합니다.

메소드의 개요

void	close () 파일 출력 스트림을 닫아 이 스트림에 관련하는 system resource를 해방합니다.
protected void	finalize () 파일에의 접속을 클린 업 해, 이 스트림에의 참조가 없어졌을 때에 이 파일 출력 스트림의 close 메소드가 불려 가도록(듯이) 합니다.
FileChannel	getChannel () 이 파일 출력 스트림에 관련지을 수 있던, 일의의 FileChannel 오브젝트를 돌려줍니다.
FileDescriptor	getFD () 스트림에 관련한 파일 기술자를 돌려줍니다.
void	write (byte[] b) 지정된 바이트 배열의 b.length 바이트를 이 파일 출력 스트림에 기입합니다.
void	write (byte[] b, int off, int len) 지정된 바이트 배열로부터의 오프셋(offset) 위치 off 로부터 시작되는 len 바이트를 이 파일 출력 스트림에 기입합니다.
void	write (int b) 지정된 바이트 데이터를 파일 출력 스트림에 기입합니다.

클래스 java.io. OutputStream 에서 상속받은 메소드

flush

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자의 상세

FileOutputStream

public FileOutputStream(String  name)
                 throws FileNotFoundException 

지정된 File 오브젝트에 기입하기 위한 파일 출력 스트림을 작성합니다. 이 파일 접속을 나타내기 위해서(때문에), 새로운 FileDescriptor 오브젝트가 생성됩니다.

우선, 시큐러티 매니저가 존재하는 경우,checkWrite 메소드가 name 를 인수로서 불려 갑니다.

파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우는 FileNotFoundException 가 슬로우 됩니다.

파라미터:

name - 시스템에 의존하는 파일명

예외:

FileNotFoundException - 파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우

SecurityException - 시큐러티 매니저가 존재해,checkWrite 메소드가 파일에의 기입해 액세스를 거부하는 경우

관련 항목:

SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(String  name,
                        boolean append)
                 throws FileNotFoundException 

지정된 name 의 파일에 기입하기 위한 출력 파일 스트림을 작성합니다. 2 번째의 인수가 true 의 경우, 바이트는 파일의 선두는 아니고 마지막에 기입해집니다. 이 파일 접속을 나타내기 위해서(때문에), 새로운 FileDescriptor 오브젝트가 생성됩니다.

우선, 시큐러티 매니저가 존재하는 경우,checkWrite 메소드가 name 를 인수로서 불려 갑니다.

파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우는 FileNotFoundException 가 슬로우 됩니다.

파라미터:

name - 시스템 의존의 파일명

append - true 의 경우, 바이트는 파일의 선두는 아니고 마지막에 기입해진다

예외:

FileNotFoundException - 파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우

SecurityException - 시큐러티 매니저가 존재해,checkWrite 메소드가 파일에의 기입해 액세스를 거부하는 경우

도입된 버젼:

JDK1. 1

관련 항목:

SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(File  file)
                 throws FileNotFoundException 

지정된 File 오브젝트로 나타내지는 파일에 기입하기 위한 파일 출력 스트림을 작성합니다. 이 파일 접속을 나타내기 위해서(때문에), 새로운 FileDescriptor 오브젝트가 생성됩니다.

우선, 시큐러티 매니저가 존재하는 경우,checkWrite 메소드가 file 인수에 의해 나타내지는 패스를 인수로서 불려 갑니다.

파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우는 FileNotFoundException 가 슬로우 됩니다.

파라미터:

file - 기입을 위해서(때문에) 열리는 파일

예외:

FileNotFoundException - 파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우

SecurityException - 시큐러티 매니저가 존재해,checkWrite 메소드가 파일에의 기입해 액세스를 거부하는 경우

관련 항목:

File.getPath() , SecurityException , SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(File  file,
                        boolean append)
                 throws FileNotFoundException 

지정된 File 오브젝트가 나타내는 파일에 기입하기 위한 출력 파일 스트림을 작성합니다. 2 번째의 인수가 true 의 경우, 바이트는 파일의 선두는 아니고 마지막에 기입해집니다. 이 파일 접속을 나타내기 위해서(때문에), 새로운 FileDescriptor 오브젝트가 생성됩니다.

우선, 시큐러티 매니저가 존재하는 경우,checkWrite 메소드가 file 인수에 의해 나타내지는 패스를 인수로서 불려 갑니다.

파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우는 FileNotFoundException 가 슬로우 됩니다.

파라미터:

file - 기입을 위해서(때문에) 열리는 파일

append - true 의 경우, 바이트는 파일의 선두는 아니고 마지막에 기입해진다

예외:

FileNotFoundException - 파일은 존재하지만, 보통 파일은 아니고 디렉토리인 경우, 파일은 존재하지 않고 작성도 할 수 없는 경우, 또는 하등의 이유로써 열릴 수가 없는 경우

SecurityException - 시큐러티 매니저가 존재해,checkWrite 메소드가 파일에의 기입해 액세스를 거부하는 경우

도입된 버젼:

1.4

관련 항목:

File.getPath() , SecurityException , SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(FileDescriptor  fdObj)

파일 시스템의 실제의 파일에의 기존의 접속을 나타내는 지정된 파일 기술자에게 기입하기 위한 출력 파일 스트림을 작성합니다.

우선, 시큐러티 매니저가 존재하는 경우,checkWrite 메소드가, 파일 기술자 fdObj 인수를 인수로서 불려 갑니다.

파라미터:

fdObj - 기입을 위해서(때문에) 열리는 파일 기술자

예외:

SecurityException - 시큐러티 매니저가 존재해,checkWrite 메소드가 파일 기술자에게로의 기입해 액세스를 거부하는 경우

관련 항목:

SecurityManager.checkWrite(java.io.FileDescriptor)

메소드의 상세

write

public void write(int b)
           throws IOException 

지정된 바이트 데이터를 파일 출력 스트림에 기입합니다. OutputStream 의 write 메소드를 구현합니다.

정의:

클래스 OutputStream 내의 write

파라미터:

b - 기입하는 바이트

예외:

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

write

public void write(byte[] b)
           throws IOException 

지정된 바이트 배열의 b.length 바이트를 이 파일 출력 스트림에 기입합니다.

오버라이드(override):

클래스 OutputStream 내의 write

파라미터:

b - 데이터

예외:

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

관련 항목:

OutputStream.write(byte[], int, int)

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException 

지정된 바이트 배열로부터의 오프셋(offset) 위치 off 로부터 시작되는 len 바이트를 이 파일 출력 스트림에 기입합니다.

오버라이드(override):

클래스 OutputStream 내의 write

파라미터:

b - 데이터

off - 데이터의 개시 오프셋(offset)

len - 기입하는 바이트수

예외:

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

close

public void close()
           throws IOException 

파일 출력 스트림을 닫아 이 스트림에 관련하는 system resource를 해방합니다. 이후는 이 파일 출력 스트림을 바이트의 기입해에 사용할 수 없습니다.

이 스트림에 채널을 관련지을 수 있고 있는 경우는 그 채널도 닫습니다.

오버라이드(override):

클래스 OutputStream 내의 close

예외:

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

getFD

public final FileDescriptor  getFD()
                           throws IOException 

스트림에 관련한 파일 기술자를 돌려줍니다.

반환값:

이 FileOutputStream 오브젝트에 의해 사용되고 있는 파일 시스템의 파일에의 접속을 나타내는 FileDescriptor 오브젝트

예외:

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

관련 항목:

FileDescriptor

getChannel

public FileChannel  getChannel()

이 파일 출력 스트림에 관련지을 수 있던, 일의의 FileChannel 오브젝트를 돌려줍니다.

돌려주어진 채널의 position 의 초기치는 그때까지 파일에 기입해진 바이트수로 설정됩니다. 다만, 이 스트림이 추가 모드의 경우는 파일의 크기로 설정됩니다. 이 스트림에 바이트를 기입할 때마다, 채널의 위치가 증분 됩니다. 채널의 위치를 명시적으로 변경했을 경우 또는 바이트의 기입에 의해 변경되었을 경우는 이 스트림의 파일 위치도 변경됩니다.

반환값:

이 파일 출력 스트림에 관련지을 수 있었던 파일 채널

도입된 버젼:

1.4

finalize

protected void finalize()
                 throws IOException 

파일에의 접속을 클린 업 해, 이 스트림에의 참조가 없어졌을 때에 이 파일 출력 스트림의 close 메소드가 불려 가도록(듯이) 합니다.

오버라이드(override):

클래스 Object 내의 finalize

예외:

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

관련 항목:

FileInputStream.close()