LHA Library for Java

jp.gr.java_conf.dangan.util.lha
クラス TwoLevelHashSearch

java.lang.Object
  拡張jp.gr.java_conf.dangan.util.lha.TwoLevelHashSearch
すべての実装インタフェース:
LzssSearchMethod

public class TwoLevelHashSearch
extends Object
implements LzssSearchMethod

二段階ハッシュと単方向連結リストを使って高速化された LzssSearchMethod。
定兼氏の論文 を参考にした。

 -- revision history --
 $Log: TwoLevelHashSearch.java,v $
 Revision 1.1  2002/12/10 22:06:40  dangan
 [bug fix]
     searchAndPut() で最近の最長一致を取れなかったバグを修正。

 Revision 1.0  2002/12/03 00:00:00  dangan
 first edition
 add to version control

 

バージョン:
$Revision: 1.1 $
作成者:
$Author: dangan $

コンストラクタの概要
TwoLevelHashSearch(int DictionarySize, int MaxMatch, int Threshold, byte[] TextBuffer)
          二段階ハッシュを使用した LzssSearchMethod を構築する。
TwoLevelHashSearch(int DictionarySize, int MaxMatch, int Threshold, byte[] TextBuffer, String HashMethodClassName)
          二段階ハッシュを使用した LzssSearchMethod を構築する。
 
メソッドの概要
 void put(int position)
          position から始まるデータパタンを 二段階ハッシュと連結リストから成る検索機構に登録する。
 int putRequires()
          put() で LzssSearchMethodにデータを 登録するときに使用されるデータ量を得る。
 int search(int position, int lastPutPos)
          ハッシュと連結リストを使用した検索機構に登録された データパタンを検索し position から始まるデータパタンと 最長の一致を持つものを得る。
 int searchAndPut(int position)
          二段階ハッシュと連結リストから成る検索機構に登録された データパタンから position から始まるデータパタンと 最長の一致を持つものを検索し、 同時に position から始まるデータパタンを 二段階ハッシュと連結リストから成る検索機構に登録する。
 void slide()
          TextBuffer内のpositionまでのデータを 前方へ移動する際、それに応じて SearchMethod内の データも TextBuffer内のデータと矛盾しないように 前方へ移動する処理を行う。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

TwoLevelHashSearch

public TwoLevelHashSearch(int DictionarySize,
                          int MaxMatch,
                          int Threshold,
                          byte[] TextBuffer)
二段階ハッシュを使用した LzssSearchMethod を構築する。
一段目のハッシュ関数には デフォルトのものが使用される。

パラメータ:
DictionarySize - 辞書サイズ
MaxMatch - 最大一致長
Threshold - 圧縮、非圧縮の閾値
TextBuffer - LZSS圧縮を施すためのバッファ

TwoLevelHashSearch

public TwoLevelHashSearch(int DictionarySize,
                          int MaxMatch,
                          int Threshold,
                          byte[] TextBuffer,
                          String HashMethodClassName)
二段階ハッシュを使用した LzssSearchMethod を構築する。

パラメータ:
DictionarySize - 辞書サイズ
MaxMatch - 最大一致長
Threshold - 圧縮、非圧縮の閾値
TextBuffer - LZSS圧縮を施すためのバッファ
HashMethodClassName - Hash関数を提供するクラス名
例外:
NoClassDefFoundError - HashMethodClassName で与えられたクラスが見つからない場合。
InstantiationError - HashMethodClassName で与えられたクラスが abstract class であるためインスタンスを生成できない場合。
NoSuchMethodError - HashMethodClassName で与えられたクラスが コンストラクタ HashMethod( byte[] )を持たない場合。
メソッドの詳細

put

public void put(int position)
position から始まるデータパタンを 二段階ハッシュと連結リストから成る検索機構に登録する。

定義:
インタフェース LzssSearchMethod 内の put
パラメータ:
position - TextBuffer内のデータパタンの開始位置

searchAndPut

public int searchAndPut(int position)
二段階ハッシュと連結リストから成る検索機構に登録された データパタンから position から始まるデータパタンと 最長の一致を持つものを検索し、 同時に position から始まるデータパタンを 二段階ハッシュと連結リストから成る検索機構に登録する。

定義:
インタフェース LzssSearchMethod 内の searchAndPut
パラメータ:
position - TextBuffer内のデータパタンの開始位置。
戻り値:
一致が見つかった場合は LzssOutputStream.createSearchReturn によって生成された一致位置と一致長の情報を持つ値、 一致が見つからなかった場合は LzssOutputStream.NOMATCH。
関連項目:
LzssOutputStream.createSearchReturn(int,int), LzssOutputStream.NOMATCH

search

public int search(int position,
                  int lastPutPos)
ハッシュと連結リストを使用した検索機構に登録された データパタンを検索し position から始まるデータパタンと 最長の一致を持つものを得る。

定義:
インタフェース LzssSearchMethod 内の search
パラメータ:
position - TextBuffer内のデータパタンの開始位置。
lastPutPos - 最後に登録したデータパタンの開始位置。
戻り値:
一致が見つかった場合は LzssOutputStream.createSearchReturn によって生成された一致位置と一致長の情報を持つ値、 一致が見つからなかった場合は LzssOutputStream.NOMATCH。
関連項目:
LzssOutputStream.createSearchReturn(int,int), LzssOutputStream.NOMATCH

slide

public void slide()
TextBuffer内のpositionまでのデータを 前方へ移動する際、それに応じて SearchMethod内の データも TextBuffer内のデータと矛盾しないように 前方へ移動する処理を行う。

定義:
インタフェース LzssSearchMethod 内の slide

putRequires

public int putRequires()
put() で LzssSearchMethodにデータを 登録するときに使用されるデータ量を得る。 TwoLevelHashSearch では、内部で使用している HashMethod の実装が hash() のために必要とするデータ量( HashMethod.hashRequires() の戻り値 ) と 二段目のハッシュに必要な最大のバイト数を足したものを返す。

定義:
インタフェース LzssSearchMethod 内の putRequires
戻り値:
一段目と二段目のハッシュに必要なバイト数を足したもの。

LHA Library for Java

バグやドキュメントの誤りの報告は作者宛てにお願いします。
ドキュメント内に含まれる社名、製品名については一般に各社の商標または登録商標です。
Copyright © 2001-2002 Michel Ishizuka. All Rights Reserved.