JavaTM 2 Platform
Standard Ed. 5.0

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()
          ファイル出力ストリームを閉じ、このストリームに関連するシステムリソースを解放します。
protected  void finalize()
          ファイルへの接続をクリーンアップし、このストリームへの参照がなくなったときにこのファイル出力ストリームの close メソッドが呼び出されるようにします。
 FileChannel getChannel()
          このファイル出力ストリームに関連付けられた、一意の FileChannel オブジェクトを返します。
 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
 
クラス 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
指定されたバイトデータをファイル出力ストリームに書き込みます。OutputStreamwrite メソッドを実装します。

定義:
クラス OutputStream 内の write
パラメータ:
b - 書き込むバイト
例外:
IOException - 入出力エラーが発生した場合

write

public void write(byte[] b)
           throws IOException
指定されたバイト配列の b.length バイトをこのファイル出力ストリームに書き込みます。

オーバーライド:
クラス OutputStream 内の write
パラメータ:
b - データ
例外:
IOException - 入出力エラーが発生した場合
関連項目:
OutputStream.write(byte[], int, int)

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
指定されたバイト配列からのオフセット位置 off から始まる len バイトをこのファイル出力ストリームに書き込みます。

オーバーライド:
クラス OutputStream 内の write
パラメータ:
b - データ
off - データの開始オフセット
len - 書き込むバイト数
例外:
IOException - 入出力エラーが発生した場合

close

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

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

定義:
インタフェース Closeable 内の close
オーバーライド:
クラス 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 メソッドが呼び出されるようにします。

オーバーライド:
クラス Object 内の finalize
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FileInputStream.close()

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。