java.io
클래스 FileOutputStream

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

모든 구현된 인터페이스:

Closeable, Flushable

public class FileOutputStream
extends OutputStream 

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

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 - write를 위해서 열리는 파일

예외:

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 - write를 위해서 열리는 파일

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

예외:

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

SecurityException - 시큐러티 매니저가 존재해, checkWrite 메서드가 파일에의 쓰기 권한을 거부하는 경우

도입된 버전 :

1.4

관련 항목:

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

FileOutputStream

public FileOutputStream(FileDescriptor  fdObj)

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

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

파라미터:

fdObj - write를 위해서 열리는 파일 기술자

예외:

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 객체를 리턴합니다.

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

반환값:

이 파일 출력 스트림에 관련된 파일 채널

도입된 버전 :

1.4

finalize

protected void finalize()
                 throws IOException 

파일에의 접속을 클린 업 해, 이 스트림에의 참조가 없어졌을 때에 이 파일 출력 스트림의 close 메서드가 호출되도록 합니다.

오버라이드(override):

클래스 Object 내의 finalize

예외:

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

관련 항목:

FileInputStream.close()