compact1, compact2, compact3

java.security

クラスMessageDigestSpi

java.lang.Object

java.security.MessageDigestSpi

直系の既知のサブクラス:

MessageDigest

public abstract class MessageDigestSpi
extends Object

MessageDigestクラスのサービス・プロバイダ・インタフェース (SPI)を定義します。これは、MD5やSHAといったメッセージ・ダイジェスト・アルゴリズムの機能を提供します。メッセージ・ダイジェストは、任意サイズのデータを取得して固定長のハッシュ値を出力する安全な一方向のハッシュ機能です。

このクラスのすべての抽象メソッドは、特定のメッセージ・ダイジェスト・アルゴリズムの実装を供給しようとする暗号化サービス・プロバイダによって実装されなければいけません。

Cloneableインタフェースは、自由に実装できます。

関連項目:

MessageDigest

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
MessageDigestSpi()

メソッドのサマリー

修飾子と型	メソッドと説明
Object	clone() 実装が複製可能な場合は複製を返します。
protected abstract byte[]	engineDigest() パディングなどの最終処理を行ってハッシュ計算を完了します。
protected int	engineDigest(byte[] buf, int offset, int len) パディングなどの最終処理を行ってハッシュ計算を完了します。
protected int	engineGetDigestLength() バイト単位のダイジェスト長を返します。
protected abstract void	engineReset() 再利用のためにダイジェストをリセットします。
protected abstract void	engineUpdate(byte input) 指定されたバイト・データを使ってダイジェストを更新します。
protected abstract void	engineUpdate(byte[] input, int offset, int len) 指定されたバイト・データの配列を使って、指定されたオフセットから開始してダイジェストを更新します。
protected void	engineUpdate(ByteBuffer input) 指定されたByteBufferを使用してダイジェストを更新します。

クラス java.lang.Objectから継承されたメソッド

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

MessageDigestSpi

public MessageDigestSpi()

メソッドの詳細

engineGetDigestLength

protected int engineGetDigestLength()

バイト単位のダイジェスト長を返します。

この具象メソッドは、事前に定義されたこの抽象クラスに追加されたものです。下位互換性のために、抽象メソッドにはできません。

デフォルト動作は0を返します。

このメソッドはプロバイダによってオーバーライドされると、ダイジェスト長を返します。

戻り値:

バイト単位のダイジェスト長。

導入されたバージョン:

1.2

engineUpdate

protected abstract void engineUpdate(byte input)

指定されたバイト・データを使ってダイジェストを更新します。

パラメータ:

input - 更新に使うバイト。

engineUpdate

protected abstract void engineUpdate(byte[] input,
                                     int offset,
                                     int len)

指定されたバイト・データの配列を使って、指定されたオフセットから開始してダイジェストを更新します。

パラメータ:

input - 更新に使うバイト・データの配列。

offset - バイトの配列での開始オフセット。

len - 使用するバイト数(offsetから開始)。

engineUpdate

protected void engineUpdate(ByteBuffer input)

指定されたByteBufferを使用してダイジェストを更新します。ダイジェストの更新時には、input.position()位置から始まるinput.remaining()バイトが使用されます。終了時に、バッファの位置はリミットに等しくなりますが、リミットは変更されません。

パラメータ:

input - ByteBuffer

導入されたバージョン:

1.5

engineDigest

protected abstract byte[] engineDigest()

パディングなどの最終処理を行ってハッシュ計算を完了します。engineDigestの呼出しのあと、エンジンはリセットされます(engineResetを参照)。リセット操作はエンジンの実装者が担当します。

戻り値:

結果として得られるハッシュ値に対するバイト・データの配列。

engineDigest

protected int engineDigest(byte[] buf,
                           int offset,
                           int len)
                    throws DigestException

パディングなどの最終処理を行ってハッシュ計算を完了します。engineDigestの呼出しのあと、エンジンはリセットされます(engineResetを参照)。リセット操作はエンジンの実装者が担当します。このメソッドは抽象メソッドでなければいけませんが、バイナリ互換を保つために具象メソッドのままにしておきます。互換性を配慮するプロバイダは、このメソッドをオーバーライドしてください。

パラメータ:

buf - ダイジェストを格納する出力バッファ

offset - 出力バッファの開始オフセット

len - ダイジェストを割り当てるバッファのバイト数。このデフォルト実装とSUNプロバイダは、どちらも部分的なダイジェストを返さない。このパラメータは、Java APIにおける統一性を保つためにだけ存在する。このパラメータの値が実際のダイジェスト長より短い場合、メソッドはDigestExceptionをスローする。このパラメータは、その値が実際のダイジェスト長より長いか、または等しい場合は無視される。

戻り値:

出力バッファに格納されるダイジェスト長。

例外:

DigestException - エラーが発生した場合。

導入されたバージョン:

1.2

engineReset

protected abstract void engineReset()

再利用のためにダイジェストをリセットします。

clone

public Object clone()
             throws CloneNotSupportedException

実装が複製可能な場合は複製を返します。

オーバーライド:

clone、クラス: Object

戻り値:

実装が複製可能な場合は複製。

例外:

CloneNotSupportedException - Cloneableをサポートしていない実装で呼び出された場合。

関連項目:

Cloneable