jp.morpho.io
クラス OutputStreamFactory

java.lang.Object
  |
  +--jp.morpho.io.OutputStreamFactory

public class OutputStreamFactory
extends java.lang.Object

出力ストリームファクトリの機能を定義します。 出力ストリームファクトリは、出力ストリームをファイル、パス文字列、バイト配列のサイズ、URL などのオブジェクトから生成するために使用します。

作成者:
Kumiko Hiroi

コンストラクタの概要
OutputStreamFactory()
           OutputStreamFactory オブジェクトを作成します。
 
メソッドの概要
 java.io.OutputStream getOutputStream(java.io.File file)
           指定された File オブジェクトで表されるファイルに書き込むためのファイル出力ストリームを作成します。
 java.io.OutputStream getOutputStream(java.io.File file, boolean append)
           指定された File オブジェクトが表すファイルに書き込むための出力ファイルストリームを作成します。
 java.io.OutputStream getOutputStream(int size)
           バイト数で指定されたサイズのバッファを持つ、バイト配列出力ストリームを新しく作成します。
 java.io.OutputStream getOutputStream(java.lang.String path)
           指定された path のファイルに書き込むための出力ファイルストリームを作成します。
 java.io.OutputStream getOutputStream(java.lang.String path, boolean append)
           指定された path のファイルに書き込むための出力ファイルストリームを作成します。
 java.io.OutputStream getOutputStream(java.net.URL url)
           url への接続を確立し、その接続に書き込みを行う出力ストリームを作成します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

OutputStreamFactory

public OutputStreamFactory()

OutputStreamFactory オブジェクトを作成します。

メソッドの詳細

getOutputStream

public java.io.OutputStream getOutputStream(java.io.File file)
                                     throws java.io.FileNotFoundException

指定された File オブジェクトで表されるファイルに書き込むためのファイル出力ストリームを作成します。 このファイル接続を表すために、新しい FileDescriptor オブジェクトが生成されます。

まず、セキュリティマネージャが存在する場合、checkWrite メソッドが file 引数によって表されるパスを引数として呼び出されます。

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

パラメータ:
file - 書き込みのために開かれるファイル
戻り値:
ファイルに書き込むためのファイル出力ストリーム (BufferedOutputStream)
例外:
java.io.FileNotFoundException - ファイルは存在するが、普通のファイルではなくディレクトリである場合、ファイルは存在せず作成もできない場合、またはなんらかの理由で開くことができない場合
java.lang.SecurityException - セキュリティマネージャが存在し、checkWrite メソッドがファイルへの書き込みアクセスを拒否する場合

getOutputStream

public java.io.OutputStream getOutputStream(java.io.File file,
                                            boolean append)
                                     throws java.io.FileNotFoundException

指定された File オブジェクトが表すファイルに書き込むための出力ファイルストリームを作成します。 2 番目の引数が true の場合、バイトはファイルの先頭ではなく最後に書き込まれます。 このファイル接続を表すために、新しい FileDescriptor オブジェクトが生成されます。

まず、セキュリティマネージャが存在する場合、checkWrite メソッドが file 引数によって表されるパスを引数として呼び出されます。

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

パラメータ:
file - 書き込みのために開かれるファイル
append - true の場合、バイトはファイルの先頭ではなく最後に書き込まれる
戻り値:
ファイルに書き込むためのファイル出力ストリーム (BufferedOutputStream)
例外:
java.io.FileNotFoundException - ファイルは存在するが、普通のファイルではなくディレクトリである場合、ファイルは存在せず作成もできない場合、またはなんらかの理由で開くことができない場合
java.lang.SecurityException - セキュリティマネージャが存在し、checkWrite メソッドがファイルへの書き込みアクセスを拒否する場合

getOutputStream

public java.io.OutputStream getOutputStream(java.lang.String path)
                                     throws java.io.FileNotFoundException

指定された path のファイルに書き込むための出力ファイルストリームを作成します。 このファイル接続を表すために、新しい FileDescriptor オブジェクトが生成されます。

まず、セキュリティマネージャが存在する場合、checkWrite メソッドが name を引数として呼び出されます。

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

戻り値:
ファイルに書き込むためのファイル出力ストリーム (BufferedOutputStream)
例外:
java.io.FileNotFoundException - ファイルは存在するが、普通のファイルではなくディレクトリである場合、ファイルは存在せず作成もできない場合、またはなんらかの理由で開くことができない場合
java.lang.SecurityException - セキュリティマネージャが存在し、checkWrite メソッドがファイルへの書き込みアクセスを拒否する場合

getOutputStream

public java.io.OutputStream getOutputStream(java.lang.String path,
                                            boolean append)
                                     throws java.io.FileNotFoundException

指定された path のファイルに書き込むための出力ファイルストリームを作成します。 2 番目の引数が true の場合、バイトはファイルの先頭ではなく最後に書き込まれます。 このファイル接続を表すために、新しい FileDescriptor オブジェクトが生成されます。

まず、セキュリティマネージャが存在する場合、checkWrite メソッドが name を引数として呼び出されます。

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

パラメータ:
append - true の場合、バイトはファイルの先頭ではなく最後に書き込まれる
戻り値:
ファイルに書き込むためのファイル出力ストリーム (BufferedOutputStream)
例外:
java.io.FileNotFoundException - ファイルは存在するが、普通のファイルではなくディレクトリである場合、ファイルは存在せず作成もできない場合、またはなんらかの理由で開くことができない場合
java.lang.SecurityException - セキュリティマネージャが存在し、checkWrite メソッドがファイルへの書き込みアクセスを拒否する場合

getOutputStream

public java.io.OutputStream getOutputStream(int size)

バイト数で指定されたサイズのバッファを持つ、バイト配列出力ストリームを新しく作成します。

パラメータ:
size - 初期サイズ
戻り値:
バイト配列出力ストリーム (ByteArrayOutputStream)

getOutputStream

public java.io.OutputStream getOutputStream(java.net.URL url)
                                     throws java.io.IOException

url への接続を確立し、その接続に書き込みを行う出力ストリームを作成します。

パラメータ:
url - URL
戻り値:
URL 接続に書き込みを行う出力ストリーム (BufferedOutputStream)
例外:
java.io.IOException - 入出力例外が発生した場合
UnknownServiceException - プロトコルが出力をサポートしていない場合