MessageDigest (Java Platform SE 8 )

java.lang.Object
- java.security.MessageDigestSpi
- - java.security.MessageDigest

```
public abstract class MessageDigest
extends MessageDigestSpi
```
这一消息摘要类提供了应用程序的消息摘要算法的功能，如SHA-1和SHA-256。消息摘要是安全的单向哈希函数接受任意大小的数据，输出一个固定长度的哈希值。
一个消息摘要开始初始化对象。数据处理通过使用update方法。在任何时候reset可以称为重置消化。一旦所有的数据被更新已更新，其中的一个digest方法应该叫完成哈希计算。

的digest方法可以称为一次给定数量的更新。在digest被称为消息摘要对象重置为其初始状态。

实现自由实现Cloneable接口。客户端应用程序可以通过尝试和捕捉clonenotsupportedexception克隆试验cloneability：
```
 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类中定义的方法的通知；在父类的所有方法都用于加密服务供应商希望提供自己的消息摘要算法的实现。

java平台的每种实现都要求支持以下标准MessageDigest算法：
- MD5
- SHA-1
- SHA-256
这些算法的java加密体系标准算法的名字 MessageDigest section描述文件。请咨询您的实现的发布文档，以查看是否支持任何其他算法。
另请参见：

DigestInputStream， DigestOutputStream

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`MessageDigest(String algorithm)` 用指定的算法名称创建一个消息摘要。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 返回一个克隆如果实现Cloneable。
`byte[]`	`digest()` 通过执行诸如填充之类的最终操作来完成哈希计算。
`byte[]`	`digest(byte[] input)` 使用指定的字节数组对摘要执行最后一个更新，然后完成摘要计算。
`int`	`digest(byte[] buf, int offset, int len)` 通过执行诸如填充之类的最终操作来完成哈希计算。
`String`	`getAlgorithm()` 返回一个确定该算法的字符串，独立于实现细节。
`int`	`getDigestLength()` 返回的字节长度的消化，或0如果操作的提供程序不支持和执行不可复制。
`static MessageDigest`	`getInstance(String algorithm)` 返回一个消息摘要对象实现指定的摘要算法。
`static MessageDigest`	`getInstance(String algorithm, Provider provider)` 返回一个消息摘要对象实现指定的摘要算法。
`static MessageDigest`	`getInstance(String algorithm, String provider)` 返回一个消息摘要对象实现指定的摘要算法。
`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更新摘要。

Methods inherited from class java.security.MessageDigestSpi
engineDigest, engineDigest, engineGetDigestLength, engineReset, engineUpdate, engineUpdate, engineUpdate

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - MessageDigest
```
protected MessageDigest(String algorithm)
```
    用指定的算法名称创建一个消息摘要。
    
    参数
    
    algorithm -摘要算法的标准名称。看在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息消息摘要部分。
- 方法详细信息
  - getInstance
```
public static MessageDigest getInstance(String algorithm)
                                 throws NoSuchAlgorithmException
```
    返回一个消息摘要对象实现指定的摘要算法。
    该方法通过注册安全提供商列表，从最开始的首选供应商。一个新的消息摘要对象封装messagedigestspi实施支持指定算法的第一供应商返回。
    
    注意，注册商的列表可以通过Security.getProviders()检索方法。
    
    参数
    
    algorithm -算法的名字要求。看在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息消息摘要部分。
    
    结果
    
    一个实现指定算法的消息摘要对象。
    
    异常
    
    NoSuchAlgorithmException -如果没有提供程序支持一个指定的算法messagedigestspi实施。
    
    另请参见：
    
    Provider
  - getInstance
```
public static MessageDigest getInstance(String algorithm,
                                        String provider)
                                 throws NoSuchAlgorithmException,
                                        NoSuchProviderException
```
    返回一个消息摘要对象实现指定的摘要算法。
    一个新的消息摘要对象封装messagedigestspi实现从指定的提供程序返回。指定的提供程序必须在安全提供程序列表中注册。
    
    注意，注册商的列表可以通过Security.getProviders()检索方法。
    
    参数
    
    algorithm -算法的名字要求。看在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息消息摘要部分。
    
    provider -提供者的名称。
    
    结果
    
    一个消息摘要对象实现指定的算法。
    
    异常
    
    NoSuchAlgorithmException -如果一个指定的算法messagedigestspi执行不可从指定的供应商。
    
    NoSuchProviderException -如果指定的供应商不在安全提供商注册名单。
    
    IllegalArgumentException如果提供者名称为空或空。
    
    另请参见：
    
    Provider
  - getInstance
```
public static MessageDigest getInstance(String algorithm,
                                        Provider provider)
                                 throws NoSuchAlgorithmException
```
    返回一个消息摘要对象实现指定的摘要算法。
    一个新的消息摘要对象封装messagedigestspi实现从指定的提供程序对象返回。请注意，指定的提供程序对象不必在提供者列表中注册。
    
    参数
    
    algorithm -算法的名字要求。看在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息消息摘要部分。
    
    provider -供应商。
    
    结果
    
    一个消息摘要对象实现指定的算法。
    
    异常
    
    NoSuchAlgorithmException -如果一个指定的算法messagedigestspi执行不可从指定的提供程序对象。
    
    IllegalArgumentException -如果指定的提供程序是无效的。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Provider
  - getProvider
```
public final Provider getProvider()
```
    返回此邮件摘要对象的提供程序。
    
    结果
    
    此消息摘要对象的提供程序
  - update
```
public void update(byte input)
```
    使用指定的字节来更新摘要。
    
    参数
    
    input与字节更新摘要。
  - update
```
public void update(byte[] input,
                   int offset,
                   int len)
```
    使用指定的偏移量开始在指定的偏移量上更新使用指定的字节数组的摘要。
    
    参数
    
    input -字节数组。
    
    offset -偏移量开始从字节数组。
    
    len -使用的字节数，从 offset。
  - update
```
public void update(byte[] input)
```
    使用指定的字节数组来更新摘要。
    
    参数
    
    input -字节数组。
  - update
```
public final void update(ByteBuffer input)
```
    使用指定的ByteBuffer更新摘要。摘要利用 input.remaining()字节开始 input.position()更新。当返回时，缓冲区的位置将等于它的极限，它的限制不会改变。
    
    参数
    
    input - ByteBuffer
    
    从以下版本开始：
    
    一点五
  - digest
```
public byte[] digest()
```
    通过执行诸如填充之类的最终操作来完成哈希计算。此调用后，摘要被重置。
    
    结果
    
    用于产生的散列值的字节数组。
  - digest
```
public int digest(byte[] buf,
                  int offset,
                  int len)
           throws DigestException
```
    通过执行诸如填充之类的最终操作来完成哈希计算。此调用后，摘要被重置。
    
    参数
    
    buf -计算摘要输出缓冲区
    
    offset到输出缓冲区偏移开始储存消化
    
    在缓冲区分配的字节数 len消化
    
    结果
    
    放入 buf字节数
    
    异常
    
    DigestException -如果出现错误。
  - digest
```
public byte[] digest(byte[] input)
```
    使用指定的字节数组对摘要执行最后一个更新，然后完成摘要计算。即，该方法首先调用 update(input)，通过输入阵列的 update方法，然后调用 digest()。
    
    参数
    
    input -被更新之前消化完毕输入。
    
    结果
    
    用于产生的散列值的字节数组。
  - toString
```
public String toString()
```
    返回此邮件摘要对象的字符串表示形式。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    对象的字符串表示形式。
  - isEqual
```
public static boolean isEqual(byte[] digesta,
                              byte[] digestb)
```
    比较两个相等的消化。做一个简单的字节比较。
    
    参数
    
    digesta -一个摘要比较。
    
    digestb -其他消化比较。
    
    结果
    
    如果消化是平等的真，否则为假。
  - reset
```
public void reset()
```
    重置为进一步利用消化。
  - getAlgorithm
```
public final String getAlgorithm()
```
    返回一个确定该算法的字符串，独立于实现细节。这个名字应该是一个标准的java安全名称（如“沙”，“密码”，等等）。看在 Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称信息消息摘要部分。
    
    结果
    
    算法的名称
  - getDigestLength
```
public final int getDigestLength()
```
    返回的字节长度的消化，或0如果操作的提供程序不支持和执行不可复制。
    
    结果
    
    在字节长度的消化，或0如果操作的提供程序不支持和执行不可复制。
    
    从以下版本开始：
    
    一点二
  - clone
```
public Object clone()
             throws CloneNotSupportedException
```
    返回一个克隆如果实现Cloneable。
    
    重写：
    
    clone 方法重写，继承类 MessageDigestSpi
    
    结果
    
    一个克隆，如果实现Cloneable。
    
    异常
    
    CloneNotSupportedException -如果这是号召，不支持 Cloneable实施。
    
    另请参见：
    
    Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class MessageDigest

构造方法摘要

方法摘要

Methods inherited from class java.security.MessageDigestSpi

Methods inherited from class java.lang.Object

Constructor Detail

MessageDigest

方法详细信息

getInstance

getInstance

getInstance

getProvider

update

update

update

update

digest

digest

digest

toString

isEqual

reset

getAlgorithm

getDigestLength

clone