개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM 2
Platform
Std.  Ed.  v1. 4.0
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음     모든 클래스
개요:  상자 | 필드  | constructor  | 메소드 상세:  필드  | constructor  | 메소드

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()
개요   패키지    클래스  사용   계층 트리   비추천 API   색인   헬프  
JavaTM 2
Platform
Std.  Ed.  v1. 4.0
 전의 클래스    다음의 클래스 프레임 있어    프레임 없음     모든 클래스
개요:  상자 | 필드  | constructor  | 메소드 상세:  필드  | constructor  | 메소드
버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.