java MessageDigest类的作用

一、结构和概述:

java.lang.Object
  java.security.MessageDigestSpi
      java.security.MessageDigest
声明:public abstract class MessageDigest extends MessageDigestSpi
此 MessageDigest 类为应用程序提供信息摘要算法的功能,如 MD5 或 SHA 算法。信息摘要是安全的单向哈希函数,它接收 任意大小的数据,并输出固定长度的哈希值。 MessageDigest 对象开始被初始化。该对象通过使用 update 方法处理数据。任何时候都可以调用 reset 方法重置摘要。一旦 所有需要更新的数据都已经被更新了,应该调用 digest 方法之一完成哈希计算。 对于给定数量的更新数据,digest 方法只能被调用一次。在调用 digest 之后,MessageDigest 对象被重新设置成其初始状态。 该实现可随意选择是否实现 Cloneable 接口。客户端应用程可以通过尝试复制和捕获 CloneNotSupportedException 来测试可复制性:
  1. MessageDigest md = MessageDigest.getInstance(“SHA”);  
  2.   
  3. try {  
  4.     md.update(toChapter1);  
  5.     MessageDigest tc1 = md.clone();  
  6.     byte[] toChapter1Digest = tc1.digest();  
  7.     md.update(toChapter2);  
  8.     …etc.  
  9. catch (CloneNotSupportedException cnse) {  
  10.     throw new DigestException(“couldn’t make digest of partial content”);  
  11. }  
 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");
 }
如果给定的实现是不可复制的,而事先已经知道摘要的数目,则仍然能够通过实例化几个实例计算中间摘要。 由于历史原因,此类是抽象类,是从 MessageDigestSpi 扩展的。应用程序开发人员只需注意在此 MessageDigest 类中定义 的方法;超类中的所有方法是供希望提供自己的信息摘要算法实现的加密服务提供者使用的。

二、构造方法

 
 
protected MessageDigest(String algorithm)   创建具有指定算法名称的信息摘要。 
参数:algorithm - 摘要算法的标准名称。

三、方法详细

1、public static MessageDigest getInstance(String algorithm) throws NoSuchAlgorithmException
返回实现指定摘要算法的 MessageDigest 对象。 

此方法从首选 Provider 开始遍历已注册安全提供者列表。返回封装取自第一个 Provider 的 MessageDigestSpi 实现的新 MessageDigest 对象,第一个 Provider 支持指定算法。 注意,可以通过 Security.getProviders() 方法获取已注册提供者列表。

参数:algorithm - 所请求算法的名称。

返回:实现指定算法的 Message Digest 对象。

抛出:NoSuchAlgorithmException - 如果没有 Provider 支持指定算法的 MessageDigestSpi 实现 
 

 

2、public static MessageDigest getInstance(String algorithm, String provider)   throws NoSuchAlgorithmException,  NoSuchProviderException

返回实现指定摘要算法的 MessageDigest 对象。

返回封装 MessageDigestSpi 实现的新 MessageDigest 对象,该实现取自指定提供者。指定提供者必须在安全提供者列表中注册。

注意,可以通过 Security.getProviders() 方法获取已注册提供者列表。

参数:algorithm - 所请求算法的名称。provider - 提供者的名称。

返回:实现指定算法的 MessageDigest 对象。 抛出: NoSuchAlgorithmException - 如果指定算法的 MessageDigestSpi 实现不能从指定提供者获得。             NoSuchProviderException - 如果指定提供者未在安全提供者列表中注册。 IllegalArgumentException - 如果提供者的名称为 null 或空。

 

3、public static MessageDigest getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException

返回实现指定摘要算法的 MessageDigest 对象。

返回封装 MessageDigestSpi 实现的新 MessageDigest 对象,该实现取自指定 Provider 对象。注意,指定 Provider 对象无需在提供者列表中注册。

参数: algorithm - 所请求算法的名称。provider - 提供者。

返回: 实现指定算法的 MessageDigest 对象。 抛出: NoSuchAlgorithmException - 如果指定算法的 MessageDigestSpi 实现不能从指定的提供者对象获得。 IllegalArgumentException - 如果指定的提供者为 null。

 

4、public final Provider getProvider()   返回此信息摘要对象的提供者。

 

5、public void update(byte input)       使用指定的字节更新摘要。

参数:input - 用于更新摘要的字节。

 

6、public void update(byte[] input,  int offset,  int len)     使用指定的 byte 数组,从指定的偏移量开始更新摘要。

参数: input - byte 数组。

      offset - byte 数组中的偏移量,操作从此处开始。

      len - 要使用的字节数,始于 offset

 

7、public void update(byte[] input)     使用指定的 byte 数组更新摘要。

参数:input - byte 数组。

 

8、public final void update(ByteBuffer input)

使用指定的 ByteBuffer 更新摘要。使用始于 input.position() 处的 input.remaining() 个字节更新摘要。一旦返回,该缓冲区的位置将等于它的界限;它的界限将不会更改。

参数: input - ByteBuffer

 

10、public byte[] digest()      通过执行诸如填充之类的最终操作完成哈希计算。在调用此方法之后,摘要被重置。

返回:存放哈希值结果的 byte 数组。

 

11、public int digest(byte[] buf,int offset, int len)  throws DigestException

通过执行诸如填充之类的最终操作完成哈希计算。在调用此方法之后,摘要被重置。

参数: buf - 存放计算摘要的输出缓冲区 offset - 输出缓冲区中的偏移量,从此处开始存储摘要。 len - 在 buf 中分配给摘要的字节数

返回: 放到 buf 中的字节数

抛出:DigestException - 如果发生错误。

 

12、public byte[] digest(byte[] input)

使用指定的 byte 数组对摘要进行最后更新,然后完成摘要计算。也就是说,此方法首先调用 update(input),向 update 方法传递 input 数组,然后调用 digest()

参数: input - 在完成摘要计算前要更新的输入。

返回: 存放哈希值结果的 byte 数组。

 

13、public String toString()    返回此信息摘要对象的字符串表示形式。

覆盖:Object 中的 toString

返回: 该对象的字符串表示形式。

 

14、public static boolean isEqual(byte[] digesta, byte[] digestb)    比较两个摘要的相等性。做简单的字节比较。

参数: digesta - 要比较的摘要之一。

               digestb - 要比较的另一个摘要。

返回: 如果摘要相等,则返回 true;否则返回 false

 

15、public void reset()     重置摘要以供再次使用。

 

16、public final String getAlgorithm()   返回标识算法的独立于实现细节的字符串。此名称应该是标准的 Java 安全名称(如 “SHA”、”MD5” 等等)。有关标准算法名称的信息,请参阅 Java Cryptography Architecture API Specification & Reference 中的附录 A。

返回:算法的名称

 

17、public final int getDigestLength()   返回以字节为单位的摘要长度,如果提供者不支持此操作并且实现是不可复制的,则返回 0。

返回: 以字节为单位的摘要长度,如果提供者不支持此操作并且实现是不可复制的,则返回 0。

 

18、public Object clone()  throws CloneNotSupportedException   如果实现是可复制的,则返回一个副本。

覆盖:MessageDigestSpi 中的 clone

返回:如果实现是可复制的,则返回一个副本。

抛出:CloneNotSupportedException - 如果对一个不支持 Cloneable 的实现调用此方法。

Javajava.security.MessageDigest是一个用于实现信息摘要算法(也称为哈希算法)的工具。它提供了一种用于计算消息摘要的方法,可以使用多种哈希算法,如MD5、SHA-1、SHA-256等。 使用java.security.MessageDigest可以实现以下功能: 1. 计算消息的哈希值:可以使用MessageDigest的getInstance()方法获取一个指定哈希算法的MessageDigest对象,然后使用update()方法将要计算哈希值的消息传递给MessageDigest对象,最后调用digest()方法获取消息的哈希值。例如,以下代码计算一个消息的MD5哈希值: ``` String message = "Hello, World!"; MessageDigest md = MessageDigest.getInstance("MD5"); byte[] hash = md.digest(message.getBytes()); ``` 2. 验证消息的完整性:可以使用哈希算法对消息进行哈希计算,然后将计算的哈希值与预期的哈希值进行比较,以验证消息的完整性。例如,以下代码验证一个消息的SHA-256哈希值是否等于预期的值: ``` String message = "Hello, World!"; byte[] expectedHash = ...; // 预期的SHA-256哈希值 MessageDigest md = MessageDigest.getInstance("SHA-256"); byte[] hash = md.digest(message.getBytes()); boolean isValid = Arrays.equals(expectedHash, hash); ``` 在实际应用中,java.security.MessageDigest常常用于对密码、数字签名等敏感信息进行摘要计算和验证。需要注意的是,在使用MessageDigest计算哈希值时,需要选择适当的哈希算法和填充方式,并采取适当的措施,以防止哈希碰撞和其他安全问题。
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值