クラスFileOutputStream

java.lang.Object
java.io.OutputStream
java.io.FileOutputStream
すべての実装されたインタフェース:
Closeable, Flushable, AutoCloseable
public class FileOutputStream extends OutputStream
ファイル出力ストリー は、FileまたはFileDescriptorにデータを書き込むための出力ストリー です。 ファイルが使用可能であるかどうか、またはファイルを作成できるかどうかは、ベースとなるプラットフォー によって決まります。 特に一部のプラットフォー では、一度にFileOutputStream (またはその他のファイル書き込みオブジェクト)を1つ け書き込むためにファイルを開くことができます。 このような 合、該当のファイルがすでに開かれていると、このクラスのコンストラクタは失敗します。

FileOutputStreamは、イメージ・データなどのrawバイトのストリー を書き込むときに使用します。 文字のストリー を書き込むときは、FileWriterを使用してく さい。

APIのノート:
close()メソッドをコールして、このストリー で使用されるリソースを、直接またはtry-with-resources文を使用して解放する必要があります。
実装要件:
サブクラスは、サブクラスによって獲得されたリソースのクリーンアップを担当します。 ストリー にアクセスできなくなった後に、そのリソース・クリーンアップが必要なサブクラスでは、Cleanerまたはその他のメカニズ を使用する必要があります。
導入されたバージョン:
1.0
関連 目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    FileOutputStream(File file)
    指定されたFileオブジェクトによって表されるファイルに書き込むためのファイル出力ストリー を作成します。
    FileOutputStream(FileDescriptor fdObj)
    ファイル・システ の実際のファイルへの既存の接続を表す、指定されたファイル記述子に書き込むためのファイル出力ストリー を作成します。
    FileOutputStream(File file, boolean append)
    指定されたFileオブジェクトによって表されるファイルに書き込むためのファイル出力ストリー を作成します。
    FileOutputStream(String name)
    指定された名前のファイルに書き込むためのファイル出力ストリー を作成します。
    FileOutputStream(String name, boolean append)
    指定された名前のファイルに書き込むためのファイル出力ストリー を作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    close()
    ファイル出力ストリー を閉じ、このストリー に関連するすべてのシステ ・リソースを解放します。
    FileChannel
    getChannel()
    このファイル出力ストリー に関連付けられた一意のFileChannelオブジェクトを返します。
    final FileDescriptor
    getFD()
    ストリー に関連したファイル記述子を返します。
    void
    write(byte[] b)
    指定されたバイト配列のb.lengthバイトをこのファイル出力ストリー に書き込みます。
    void
    write(byte[] b, int off, int len)
    指定されたバイト配列のオフセット位置offから始まるlenバイトをこのファイル出力ストリー に書き込みます。
    void
    write(int b)
    指定されたバイトをこのファイル出力ストリー に書き込みます。

    クラスjava.io.OutputStreamで宣言されたメソッド

    flush, nullOutputStream

    クラスjava.lang.Objectで宣言されたメソッド

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

  • コンストラクタの詳細

    • FileOutputStream

      public FileOutputStream(String name) throws FileNotFoundException
      指定された名前のファイルに書き込むためのファイル出力ストリー を作成します。 ファイルが存在する 合は切り捨てられ、存在しない 合は新しいファイルが作成されます。 「シンボル・リンク」は、リンクのtargetに自動的にリダイレクトされます。 このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。

      ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合は、FileNotFoundExceptionがスローされます。

      実装要件:
      このコンストラクタをパラメータnameで呼び出すことは、new FileOutputStream(name, false)を呼び出すことと同じです。
      パラメータ:
      name - システ に依存するファイル名
      スロー:
      FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合

    • FileOutputStream

      public FileOutputStream(String name, boolean append) throws FileNotFoundException
      指定された名前のファイルに書き込むためのファイル出力ストリー を作成します。 ファイルが存在する 合は、2番目の引数がtrueでなければ切り捨てられます。この 合、バイトは先 ではなくファイルの末尾に書き込まれます。 このファイルが存在しない 合は作成されます。 「シンボル・リンク」は、リンクのtargetに自動的にリダイレクトされます。 このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。

      ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合は、FileNotFoundExceptionがスローされます。

      パラメータ:
      name - システ 依存のファイル名
      append - trueの 合、バイトはファイルの先 ではなく最後に書き込まれる
      スロー:
      FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合。
      導入されたバージョン:
      1.1

    • FileOutputStream

      public FileOutputStream(File file) throws FileNotFoundException
      指定されたFileオブジェクトによって表されるファイルに書き込むためのファイル出力ストリー を作成します。 ファイルが存在する 合は切り捨てられ、存在しない 合は新しいファイルが作成されます。 「シンボル・リンク」は、リンクのtargetに自動的にリダイレクトされます。 このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。

      ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合は、FileNotFoundExceptionがスローされます。

      パラメータ:
      file - 書込み用に開かれるファイル。
      スロー:
      FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合
      関連 目:

    • FileOutputStream

      public FileOutputStream(File file, boolean append) throws FileNotFoundException
      指定されたFileオブジェクトによって表されるファイルに書き込むためのファイル出力ストリー を作成します。 ファイルが存在する 合は、2番目の引数がtrueでなければ切り捨てられます。この 合、バイトは先 ではなくファイルの末尾に書き込まれます。 このファイルが存在しない 合は作成されます。 「シンボル・リンク」は、リンクのtargetに自動的にリダイレクトされます。 このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。

      ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合は、FileNotFoundExceptionがスローされます。

      パラメータ:
      file - 書込み用に開かれるファイル。
      append - trueの 合、バイトはファイルの先 ではなく最後に書き込まれる
      スロー:
      FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである 合、存在せず作成もできない 合、またはなんらかの理由で開くことができない 合
      導入されたバージョン:
      1.4
      関連 目:

    • FileOutputStream

      public FileOutputStream(FileDescriptor fdObj)
      ファイル・システ の実際のファイルへの既存の接続を表す、指定されたファイル記述子に書き込むためのファイル出力ストリー を作成します。

      fdObjがnullの 合、NullPointerExceptionがスローされます。

      fdObjがinvalidの 合、このコンストラクタは例外をスローしません。 た し、結果となるストリー に対してそのストリー への入出力を試みるメソッドが呼び出された 合は、IOExceptionがスローされます。

      パラメータ:
      fdObj - 書込みのために開かれるファイル記述子

  • メソッドの詳細

    • write

      public void write(int b) throws IOException
      指定されたバイトをこのファイル出力ストリー に書き込みます。 OutputStreamのwriteメソッドを実装します。
      定義:
      write、クラスOutputStream
      パラメータ:
      b - 書き込まれるバイト。
      スロー:
      IOException - 入出力エラーが発生した 合。

    • write

      public void write(byte[] b) throws IOException
      指定されたバイト配列のb.lengthバイトをこのファイル出力ストリー に書き込みます。
      オーバーライド:
      write、クラスOutputStream
      パラメータ:
      b - データ。
      スロー:
      IOException - 入出力エラーが発生した 合。
      関連 目:

    • write

      public void write(byte[] b, int off, int len) throws IOException
      指定されたバイト配列のオフセット位置offから始まるlenバイトをこのファイル出力ストリー に書き込みます。
      オーバーライド:
      write、クラスOutputStream
      パラメータ:
      b - データ。
      off - データの開始オフセット。
      len - 書き込むバイト数。
      スロー:
      IOException - 入出力エラーが発生した 合。
      IndexOutOfBoundsException - offが の値の 合、lenが の値の 合、あるいはlenがb.length - offより大きい 合

    • close

      public void close() throws IOException
      ファイル出力ストリー を閉じ、このストリー に関連するすべてのシステ ・リソースを解放します。 以降は、このファイル出力ストリー をバイトの書込みに使用することはできません。

      このストリー にチャネルが関連付けられている 合は、そのチャネルも閉じます。

      定義:
      close、インタフェースAutoCloseable
      定義:
      close、インタフェースCloseable
      オーバーライド:
      close、クラスOutputStream
      APIのノート:
      クリーンアップ・アクションを実行するためのclose()のオーバーライドは、直接呼び出されたとき、またはtry-with-resourcesによって呼び出されたときにのみ信 できます。
      実装要件:
      ストリー にアクセスできなくなった後に、そのリソース・クリーンアップが必要なサブクラスでは、Cleanerメカニズ を使用する必要があります。

      このストリー にチャネルが関連付けられている 合、このメソッドはチャネルを閉じ、チャネルがこのストリー を閉じます。 このメソッドをオーバーライドするサブクラスは、再入可能起動を処理できるように準備する必要があります。

      スロー:
      IOException - 入出力エラーが発生した 合。

    • getFD

      public final FileDescriptor getFD() throws IOException
      ストリー に関連したファイル記述子を返します。
      戻り値:
      このFileOutputStreamオブジェクトによって使用されているファイル・システ のファイルへの接続を表すFileDescriptorオブジェクト。
      スロー:
      IOException - 入出力エラーが発生した 合。
      関連 目:

    • getChannel

      public FileChannel getChannel()
      このファイル出力ストリー に関連付けられた一意のFileChannelオブジェクトを返します。

      返されるチャネルの初期positionは、それまでにファイルに書き込まれたバイト数と等しくなります。このストリー が追 モードの 合は、ファイルのサイズと等しくなります。 このストリー にバイトを書き込むたびにチャネルの位置が増分されます。 チャネルの位置が明示的に変更された 合、または書き込みよって変更された 合は、このストリー のファイル位置が変更されます。

      戻り値:
      このファイル出力ストリー に関連付けられているファイル・チャネル
      導入されたバージョン:
      1.4