MessageDigest 通過其getInstance系列靜態函數來進行實例化和初始化。MessageDigest 對象通過使用 update
方法處理數據。任何時候都可以調用 reset
方法重置摘要。一旦所有需要更新的數據都已經被更新了,應該調用 digest
方法之一完成哈希計算並返回結果。
對於給定數量的更新數據,digest
方法只能被調用一次。digest
方法被調用后,MessageDigest 對象被重新設置成其初始狀態。
MessageDigest 的實現可隨意選擇是否實現 Cloneable 接口。客戶端應用程可以通過嘗試復制和捕獲 CloneNotSupportedException 測試可復制性:
MessageDigest md = MessageDigest.getInstance("SHA");
try {
md.update(toChapter1);
MessageDigest tc1 = md.clone();
byte[] toChapter1Digest = tc1.digest();
md.update(toChapter2);
...etc.
} catch (CloneNotSupportedException cnse) {
throw new DigestException("couldn't make digest of partial content");
}
注意1:即時給定MessageDigest的實現是不可復制的,則仍然能夠通過getInstance方法實例化幾個實例計算來同時進行摘要信息的計算。
注意2:由於歷史原因,此類是抽象的,是從 MessageDigestSpi
擴展的。應用程序開發人員只應該注意在此 MessageDigest
類中定義的方法;超類中的所有方法是供希望提供自己的信息摘要算法實現的加密服務提供者使用的。
注意3:MessageDigest並不是單實例的。如下代碼所示:
try
{
MessageDigest mdTemp1 = MessageDigest.getInstance("MD5");
MessageDigest mdTemp2= MessageDigest.getInstance("MD5");
MessageDigest mdTemp3= MessageDigest.getInstance("MD5");
System.out.println("mdTemp1==mdTemp2?:"+(mdTemp1==mdTemp2));
System.out.println("mdTemp2==mdTemp3?:"+(mdTemp2==mdTemp3));
} catch (NoSuchAlgorithmException e)
{
// TODO Auto-generated catch block
e.printStackTrace();
}
運行結果
mdTemp1==mdTemp2?:false
mdTemp2==mdTemp3?:false
構造方法摘要 | |
---|---|
protected |
MessageDigest(String algorithm) 創建具有指定算法名稱的MessageDigest 實例對象。 |
方法摘要 | |
---|---|
Object |
clone() 如果實現是可復制的,則返回一個副本。 |
byte[] |
digest() 通過執行諸如填充之類的最終操作完成哈希計算。 |
byte[] |
digest(byte[] input) 使用指定的字節數組對摘要進行最后更新,然后完成摘要計算。 |
int |
digest(byte[] buf, int offset, int len) 通過執行諸如填充之類的最終操作完成哈希計算。 |
String |
getAlgorithm() 返回標識算法的獨立於實現細節的字符串。 |
int |
getDigestLength() 返回以字節為單位的摘要長度,如果提供程序不支持此操作並且實現是不可復制的,則返回 0。 |
static MessageDigest |
getInstance(String algorithm) 生成實現指定摘要算法的 MessageDigest 對象。 |
static MessageDigest |
getInstance(String algorithm, Provider provider) 生成實現指定提供程序提供的指定算法的 MessageDigest 對象,如果該算法可從指定的提供程序得到的話。 |
static MessageDigest |
getInstance(String algorithm, String provider) 生成實現指定提供程序提供的指定算法的 MessageDigest 對象,如果該算法可從指定的提供程序得到的話。 |
Provider |
getProvider() 返回此信息摘要對象的提供程序。 |
static boolean |
isEqual(byte[] digesta, byte[] digestb) 比較兩個摘要的相等性。 |
void |
reset() 重置摘要以供再次使用。 |
String |
toString() 返回此信息摘要對象的字符串表示形式。 |
void |
update(byte input) 使用指定的字節更新摘要。 |
void |
update(byte[] input) 使用指定的字節數組更新摘要。 |
void |
update(byte[] input, int offset, int len) 使用指定的字節數組,從指定的偏移量開始更新摘要。 |
void |
update(ByteBuffer input) 使用指定的 ByteBuffer 更新摘要。 |
public static MessageDigest getInstance(String algorithm)
public static MessageDigest getInstance(String algorithm, String provider);
public void update(byte[] input)
MessageDigest m=MessageDigest.getInstance("MD5");
m.update(x.getBytes("UTF8" ));
byte s[ ]=m.digest( );
900150983cd24fb0d6963f7d28e17f72