FileOutputStream (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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()`

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.