org.maachang.dbm
インタフェース MaachangDbm

既知の実装クラスの一覧:
MaachangDbmImpl

public interface MaachangDbm

MaachangDbm.
MaachangDbmとは、javaで作成されたDBM[データベースマネージャ]で Key,Value形式の内容を永続化させます.
データ管理最大数は、4250000件(425万件)です.

MaachangDbmの利用方法について説明します.
MaachangDbmを利用するには、まず最初に、以下のように、MaachangDbmを初期化する 必要があります.

 MaachangDbm dbm = new MaachangDbmImpl( "dbm" ) ;
 
 

第一引数には、MaachangDbmの内容を保持するディレクトリ名を指定します.
これで、MaachangDbmが利用可能になります.
また、MaachangDbmを操作するには、

 MaachangDbm dbm = new MaachangDbmImpl( "dbm" ) ;
 dbm.put( "hoge".getBytes( "UTF8" ),"hogehoge".getBytes( "UTF8" ) ;
 byte[] b = dbm.get( "hoge".getBytes( "UTF8" ) ) ;
 System.out.println( new String( b,"UTF8" ) ) ;
 dbm.remove( "hoge".getBytes( "UTF8" ) ) ;
 
 

などで、利用できますが、この場合["hoge".getBytes( "UTF8" )]などと記述するのは、面倒です.
このため、MaachangDbm操作用オブジェクトとして、別途[MaachangDbmOp]が用意されています.
利用方法としては、以下の通りです.

 MaachangDbm dbm = new MaachangDbmImpl( "dbm" ) ;
 MaachangDbmOp op = new MaachangDbmOp( dbm ) ;
 
 

または、

 MaachangDbmOp op = new MaachangDbmOp( "dbm" ) ;
 
 

のようにMaachangDbmOpを初期化します.そして、MaachangDbmOpの利用方法は、下記の通りです.

 op.put( "hoge","moge" ) ;
 String a = op.getString( "hoge" ) ;
 op.remove( "hoge" ) ;
 
 

導入されたバージョン:
MaachangDBM 1.00
バージョン:
2008/01/18
作成者:
masahito suzuki

メソッドの概要
 void close()
          オブジェクトクローズ.
 java.util.Enumeration<byte[]> elements()
          キー内容を列挙.
 byte[] get(byte[] key)
          情報を取得.
 java.lang.String getDirectory()
          MaachangDbm展開ディレクトリを取得.
 MDbmEngine getEngine()
          MaachangDbmエンジンを取得.
 boolean isUse()
          このオブジェクトが有効かチェック.
 void put(byte[] key, byte[] value)
          情報を設定.
 void remove(byte[] key)
          情報を削除.
 int size()
          格納情報数を取得.
 

メソッドの詳細

close

void close()
オブジェクトクローズ.


put

void put(byte[] key,
         byte[] value)
         throws java.lang.Exception
情報を設定.

パラメータ:
key - 対象のキー情報を設定します.
value - 対象の情報を設定します.
例外:
java.lang.Exception - 例外.

remove

void remove(byte[] key)
            throws java.lang.Exception
情報を削除.

パラメータ:
key - 対象のキー情報を設定します.
例外:
java.lang.Exception - 例外.

get

byte[] get(byte[] key)
           throws java.lang.Exception
情報を取得.

パラメータ:
key - 対象のキー情報を設定します.
戻り値:
byte[] 対象の情報が返されます.
例外:
java.lang.Exception - 例外.

elements

java.util.Enumeration<byte[]> elements()
キー内容を列挙.

戻り値:
Enumeration 列挙オブジェクトが返されます.

size

int size()
格納情報数を取得.

戻り値:
int 格納情報数が返されます.
[-1]が返された場合、オブジェクトは既に破棄されています.

getDirectory

java.lang.String getDirectory()
MaachangDbm展開ディレクトリを取得.

戻り値:
String MaachangDbm展開ディレクトリ名が返されます.

getEngine

MDbmEngine getEngine()
MaachangDbmエンジンを取得.

戻り値:
MDbmEngine MaachangDbmエンジンが返されます.

isUse

boolean isUse()
このオブジェクトが有効かチェック.

戻り値:
boolean [true]の場合、有効です.