モジュール java.base

パッケージ java.util.zip

インタフェースChecksum

既知のすべての実装クラス:

Adler32, CRC32, CRC32C

public interface Checksum

データ・チェックサムを表すインタフェースです。

導入されたバージョン:

1.1

メソッドのサマリー

修飾子と型	メソッド	説明
long	getValue()	現在のチェックサム値を返します。
void	reset()	チェックサムを初期値にリセットします。
default void	update(byte[] b)	現在のチェックサムを指定されたバイト配列で更新します。
void	update(byte[] b, int off, int len)	現在のチェックサムを指定されたバイト配列で更新します。
void	update(int b)	現在のチェックサムを指定されたバイトで更新します。
default void	update(ByteBuffer buffer)	現在のチェックサムを、指定されたバッファのバイト数で更新します。

メソッドの詳細

update

void update(int b)

現在のチェックサムを指定されたバイトで更新します。

パラメータ:

b - チェックサムを更新するバイト

update

default void update(byte[] b)

現在のチェックサムを指定されたバイト配列で更新します。

実装要件:

このデフォルトの実装は、update(b, 0, b.length)を呼び出すことと同じです。

パラメータ:

b - チェックサムの更新に使用するバイト配列

例外:

NullPointerException - bがnullである場合

導入されたバージョン:

9

update

void update(byte[] b, int off, int len)

現在のチェックサムを指定されたバイト配列で更新します。

パラメータ:

b - チェックサムを更新するバイト配列

off - データの開始オフセット

len - 更新に使うバイト数

update

default void update(ByteBuffer buffer)

現在のチェックサムを、指定されたバッファのバイト数で更新します。 チェックサムは、バッファ内の残りのバイト数で、バッファ位置から更新されます。 戻ると、バッファの位置が制限値に更新され、制限値は変更されません。

APIのノート:

このインタフェースのバッキング配列実装者がいないDirectByteBufferおよびその他のByteBuffer実装のパフォーマンスを最大化するには、このメソッドをオーバーライドする必要があります。

実装要件:

デフォルト実装の動作は次のとおりです。
アクセス可能なバイト配列によって支えられたByteBuffersの場合。

 update(buffer.array(),
        buffer.position() + buffer.arrayOffset(),
        buffer.remaining());
 

アクセス可能なバイト配列に支えられていないByteBuffersの場合。

 byte[] b = new byte[Math.min(buffer.remaining(), 4096)];
 while (buffer.hasRemaining()) {
     int length = Math.min(buffer.remaining(), b.length);
     buffer.get(b, 0, length);
     update(b, 0, length);
 }
 

パラメータ:

buffer - チェックサムを更新するByteBuffer

例外:

NullPointerException - bufferがnullの場合

導入されたバージョン:

9

getValue

long getValue()

現在のチェックサム値を返します。

戻り値:

現在のチェックサム値

reset

void reset()

チェックサムを初期値にリセットします。