|
LHA Library for Java | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.io.OutputStream
jp.gr.java_conf.dangan.util.lha.LhaRetainedOutputStream
public class LhaRetainedOutputStream
接続されたRandomAccessFileに 圧縮データを出力するためのユーティリティクラス。
java.util.zip.ZipOutputStream と似たインターフェイスを持つように作った。
圧縮失敗時( 圧縮後サイズが圧縮前サイズを上回った場合 )の処理を自動的に行う。
進捗報告を実装する場合、このような処理をクラス内に隠蔽すると進捗報告は何秒間か
時によっては何十分も応答しなくなる。(例えばギガバイト級のデータを扱った場合)
このような事態を避けたい場合は LhaImmediateOutputStreamを使用すること。
また、JDK 1.1 以前では RandomAccessFile が setLength を持たないため、
書庫データの後ろに他のデータがある場合でもファイルサイズを切り詰めることが出来ない。
この問題点は常にサイズ0の新しいファイルを開く事によって回避する事ができる。
-- revision history -- $Log: LhaRetainedOutputStream.java,v $ Revision 1.2 2002/12/11 02:25:14 dangan [bug fix] jdk1.2 でコンパイルできなかった箇所を修正。 Revision 1.1 2002/12/08 00:00:00 dangan [maintenance] LhaConstants から CompressMethod へのクラス名の変更に合わせて修正。 Revision 1.0 2002/08/05 00:00:00 dangan add to version control [change] コンストラクタから 引数に String encode を取るものを廃止、 Properties を引数に取るものを追加。 [maintenance] ソース整備 タブ廃止 ライセンス文の修正
Constructor Summary | |
---|---|
LhaRetainedOutputStream(java.io.File filename)
filename のファイルに 圧縮データを出力するOutputStreamを構築する。 各圧縮形式に対応した符号器の生成式等を持つプロパティには LhaProperty.getProperties() で得られたプロパティが使用される。 |
|
LhaRetainedOutputStream(java.io.File filename,
java.util.Properties property)
filename のファイルに 圧縮データを出力するOutputStreamを構築する。 |
|
LhaRetainedOutputStream(java.io.RandomAccessFile file)
fileに 圧縮データを出力するOutputStreamを構築する。 各圧縮形式に対応した符号器の生成式等を持つプロパティには LhaProperty.getProperties() で得られたプロパティが使用される。 |
|
LhaRetainedOutputStream(java.io.RandomAccessFile file,
java.util.Properties property)
fileに 圧縮データを出力するOutputStreamを構築する。 各圧縮形式に対応した符号器の生成式等を持つプロパティには LhaProperty.getProperties() で得られたプロパティが使用される。 |
|
LhaRetainedOutputStream(java.lang.String filename)
filename のファイルに 圧縮データを出力するOutputStreamを構築する。 各圧縮形式に対応した符号器の生成式等を持つプロパティには LhaProperty.getProperties() で得られたプロパティが使用される。 |
|
LhaRetainedOutputStream(java.lang.String filename,
java.util.Properties property)
filename のファイルに 圧縮データを出力するOutputStreamを構築する。 |
Method Summary | |
---|---|
void |
close()
出力先に全てのデータを出力し、ストリームを閉じる。 また、使用していた全てのリソースを解放する。 |
void |
closeEntry()
現在出力中のエントリを閉じ、次のエントリが出力可能な状態にする。 圧縮に失敗した(圧縮後サイズが圧縮前サイズを上回った)場合、 解凍し無圧縮で格納する。エントリのサイズが大きい場合、 この処理にはかなりの時間がかかる。 |
void |
flush()
現在書き込み中のエントリのデータを強制的に出力先に書き出す。 これは PostLzssEncoder, LzssOutputStream の規約どおり flush() しなかった場合とは別のデータを出力する。 (大抵の場合は 単に圧縮率が低下するだけである。) |
void |
putNextEntry(LhaHeader header)
新しいエントリを書き込むようにストリームを設定する。 このメソッドは 既に圧縮済みのエントリの場合は putNextEntryAlreadyCompressed(), 未だに圧縮されていない場合は putNextEntryNotYetCompressed() を呼び出す。 圧縮されているかの判定は、 header.getCompressedSize() header.getCRC() のどれか一つでも LhaHeader.UNKNOWN であれば未だに圧縮されていないとする。 header には正確な OriginalSize が指定されている必要がある。 |
void |
putNextEntryAlreadyCompressed(LhaHeader header)
既に圧縮済みのエントリを書きこむようにストリームを設定する。 圧縮済みデータが正しい事は、呼び出し側が保証する事。 |
void |
putNextEntryNotYetCompressed(LhaHeader header)
未だに圧縮されていないエントリを書きこむようにストリームを設定する。 header には正確な OriginalSize が指定されている必要がある。 header に CompressedSize, CRCが指定されていても無視される。 |
void |
write(byte[] buffer)
現在のエントリに bufferの内容を全て書き出す。 |
void |
write(byte[] buffer,
int index,
int length)
現在のエントリに bufferの indexから lengthバイトのデータを書き出す。 |
void |
write(int data)
現在のエントリに1バイトのデータを書きこむ。 |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public LhaRetainedOutputStream(java.lang.String filename) throws java.io.FileNotFoundException
filename
- 圧縮データを書きこむファイルの名前
java.io.FileNotFoundException
- filename で与えられたファイルが見つからない場合。
java.lang.SecurityException
- セキュリティマネージャがファイルへのアクセスを許さない場合。LhaProperty.getProperties()
public LhaRetainedOutputStream(java.lang.String filename, java.util.Properties property) throws java.io.FileNotFoundException
filename
- 圧縮データを書きこむファイルの名前property
- 各圧縮形式に対応した符号器の生成式等が含まれるプロパティ
java.io.FileNotFoundException
- filename で与えられたファイルが見つからない場合。
java.lang.SecurityException
- セキュリティマネージャがファイルへのアクセスを許さない場合。LhaProperty
public LhaRetainedOutputStream(java.io.File filename) throws java.io.IOException
filename
- 圧縮データを書きこむファイルの名前
java.io.FileNotFoundException
- filename で与えられたファイルが見つからない場合。
java.lang.SecurityException
- セキュリティマネージャがファイルへのアクセスを許さない場合。
java.io.IOException
- JDK1.2 でコンパイルするためだけに存在する。LhaProperty.getProperties()
public LhaRetainedOutputStream(java.io.File filename, java.util.Properties property) throws java.io.IOException
filename
- 圧縮データを書きこむファイルの名前property
- 各圧縮形式に対応した符号器の生成式等が含まれるプロパティ
java.io.FileNotFoundException
- filename で与えられたファイルが見つからない場合。
java.lang.SecurityException
- セキュリティマネージャがファイルへのアクセスを許さない場合。
java.io.IOException
- JDK1.2 でコンパイルするためだけに存在する。LhaProperty
public LhaRetainedOutputStream(java.io.RandomAccessFile file)
file
- RandomAccessFile のインスタンス。LhaProperty.getProperties()
public LhaRetainedOutputStream(java.io.RandomAccessFile file, java.util.Properties property)
file
- RandomAccessFile のインスタンス。property
- 各圧縮形式に対応した符号器の生成式等が含まれるプロパティLhaProperty
Method Detail |
---|
public void write(int data) throws java.io.IOException
write
in class java.io.OutputStream
data
- 書きこむデータ
java.io.IOException
- 入出力エラーが発生した場合。public void write(byte[] buffer) throws java.io.IOException
write
in class java.io.OutputStream
buffer
- 書き出すデータの入ったバイト配列
java.io.IOException
- 入出力エラーが発生した場合。public void write(byte[] buffer, int index, int length) throws java.io.IOException
write
in class java.io.OutputStream
buffer
- 書き出すデータの入ったバイト配列index
- buffer内の書き出すべきデータの開始位置length
- データのバイト数
java.io.IOException
- 入出力エラーが発生した場合。public void flush() throws java.io.IOException
flush
in interface java.io.Flushable
flush
in class java.io.OutputStream
java.io.IOException
- 入出力エラーが発生した場合PostLzssEncoder.flush()
,
LzssOutputStream.flush()
public void close() throws java.io.IOException
close
in interface java.io.Closeable
close
in class java.io.OutputStream
java.io.IOException
- 入出力エラーが発生した場合public void putNextEntry(LhaHeader header) throws java.io.IOException
header
- 書きこむエントリについての情報を持つ
LhaHeaderのインスタンス。
java.io.IOException
- 入出力エラーが発生した場合
java.lang.IllegalArgumentException
- header.getOriginalSize() が LhaHeader.UNKNOWN を返す場合public void putNextEntryAlreadyCompressed(LhaHeader header) throws java.io.IOException
header
- 書きこむエントリについての情報を持つ
LhaHeaderのインスタンス。
java.io.IOException
- 入出力エラーが発生した場合
java.lang.IllegalArgumentException
- public void putNextEntryNotYetCompressed(LhaHeader header) throws java.io.IOException
header
- 書きこむエントリについての情報を持つ
LhaHeaderのインスタンス。
java.io.IOException
- 入出力エラーが発生した場合
java.lang.IllegalArgumentException
- header.getOriginalSize() が LhaHeader.UNKNOWN を返す場合public void closeEntry() throws java.io.IOException
java.io.IOException
- 入出力エラーが発生した場合
|
LHA Library for Java | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |