java.io
클래스 FileOutputStream

java.lang.Object 
  java.io.OutputStream 
      java.io.FileOutputStream

모든 구현된 인터페이스:

Closeable , Flushable

public class FileOutputStream
extends OutputStream 

파일 출력 스트림은,File 또는 FileDescriptor 에 데이터를 기입하기 위한 출력 스트림입니다. 파일이 사용 가능한지 어떤지, 또는 파일을 작성할 수 있을지 어떨지는, 기본이 되는 플랫폼에 의해 정해집니다. 특히, 일부의 플랫폼에서는, 1 개의 파일은 동시에 1 개의 FileOutputStream (또는 그 외의 파일 기입 객체)인 만큼 따라 기입을 위해서(때문에) 열 수가 있습니다. 이러한 경우, 해당의 파일이 벌써 열리고 있으면(자), 이 클래스의 생성자 은 실패합니다.

FileOutputStream 는, 이미지 데이터등의 생의 바이트의 스트림을 기입할 때 사용합니다. 문자의 스트림을 기입할 때는,FileWriter 를 사용해 주세요.

도입된 버젼:

JDK1. 0

관련 항목:

File , FileDescriptor , FileInputStream

생성자 의 개요

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

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

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

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

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 

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

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

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

파라미터:

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 가 throw 됩니다.

파라미터:

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 가 throw 됩니다.

파라미터:

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 가 throw 됩니다.

파라미터:

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를 해제합니다. 이후는, 이 파일 출력 스트림을 바이트의 기입해에 사용할 수 없습니다.

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

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 OutputStream 내의 close

예외:

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

getFD

public final FileDescriptor  getFD()
                           throws IOException 

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

반환값:

이 FileOutputStream 객체에 의해 사용되고 있는 파일 시스템의 파일에의 접속을 나타내는 FileDescriptor 객체

예외:

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

관련 항목:

FileDescriptor

getChannel

public FileChannel  getChannel()

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

반환된 채널의 java.nio.channels.FileChannel#position()position 의 초기치는, 그때까지 파일에 기입해진 바이트수로 설정됩니다. 다만, 이 스트림이 추가 모드의 경우는, 파일의 크기로 설정됩니다. 이 스트림에 바이트를 기입할 때마다 채널의 위치가 증분 됩니다. 채널의 위치가 명시적으로 변경되었을 경우, 또는 기입이야는 변경되었을 경우는, 이 스트림의 파일 위치가 변경됩니다.

반환값:

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

도입된 버젼:

1.4

finalize

protected void finalize()
                 throws IOException 

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

오버라이드(override):

클래스 Object 내의 finalize

예외:

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

관련 항목:

FileInputStream.close()