MessageDigest (Платформа Java SE 7)

java.lang. Объект
- java.security. MessageDigestSpi
- - java.security. MessageDigest

```
public abstract class MessageDigest
extends MessageDigestSpi
```
Этот класс MessageDigest обеспечивает приложения функциональность алгоритма обзора сообщения, такие как SHA 1 или SHA 256. Обзоры сообщения являются безопасными односторонними хэш-функциями, которые берут данные произвольного размера и выводят значение хэш-функции фиксированной длины.
Объект MessageDigest начинается инициализированный. Данные обрабатываются через это использующий update методы. В любой точке reset может быть вызван, чтобы сбросить обзор. Как только все данные, которые будут обновлены, были обновлены, один из digest методы нужно вызвать, чтобы завершить вычисление хеша.
digest однажды метод можно вызвать для данного числа обновлений. После digest был вызван, объект MessageDigest сбрасывается к его инициализированному состоянию.
Реализации свободны реализовать интерфейс Cloneable. Клиентские приложения могут протестировать cloneability, делая попытку клонирования и ловли 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");
 }
 
```
Отметьте, что, если данная реализация не является cloneable, все еще возможно вычислить промежуточные обзоры, инстанцируя нескольких экземпляров, если число обзоров известно заранее.
Отметьте, что этот класс абстрактен и расширяется от MessageDigestSpi по историческим причинам. Разработчики приложений должны только заметить методов, определенных в этом MessageDigest класс; все методы в суперклассе предназначаются для провайдеров криптографических служб, которые хотят предоставить их собственные реализации алгоритмов обзора сообщения.
Каждая реализация платформы Java обязана поддерживать следующий стандарт MessageDigest алгоритмы:
- MD5
- SHA-1
- SHA-256
Эти алгоритмы описываются в разделе MessageDigest Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.
См. Также:
DigestInputStream, DigestOutputStream

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`MessageDigest(String algorithm)` Создает обзор сообщения с указанным именем алгоритма.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Объект`	`clone()` Возвращает клона, если реализация является cloneable.
`byte[]`	`digest()` Завершает вычисление хеша, выполняя заключительные операции, такие как дополнение.
`byte[]`	`digest(byte[] input)` Выполняет заключительное обновление об обзоре, используя указанный массив байтов, затем завершает вычисление обзора.
`int`	`digest(byte[] buf, int offset, int len)` Завершает вычисление хеша, выполняя заключительные операции, такие как дополнение.
`Строка`	`getAlgorithm()` Возвращает строку, которая идентифицирует алгоритм, независимый от деталей реализации.
`int`	`getDigestLength()` Возвращает длину обзора в байтах, или 0, если эта работа не поддерживается провайдером, и реализация не является cloneable.
`static MessageDigest`	`getInstance(String algorithm)` Возвращается MessageDigest возражают, что реализует указанный алгоритм обзора.
`static MessageDigest`	`getInstance(String algorithm, Provider provider)` Возвращается MessageDigest возражают, что реализует указанный алгоритм обзора.
`static MessageDigest`	`getInstance(String algorithm, String provider)` Возвращается MessageDigest возражают, что реализует указанный алгоритм обзора.
`Провайдер`	`getProvider()` Возвращает провайдера этого объекта обзора сообщения.
`static boolean`	`isEqual(byte[] digesta, byte[] digestb)` Сравнивает два обзора для равенства.
`void`	`reset()` Сбрасывает обзор для дальнейшего использования.
`Строка`	`toString()` Возвращает строковое представление этого объекта обзора сообщения.
`void`	`update(byte input)` Обновляет обзор, используя указанный байт.
`void`	`update(byte[] input)` Обновляет обзор, используя указанный массив байтов.
`void`	`update(byte[] input, int offset, int len)` Обновляет обзор, используя указанный массив байтов, запускаясь при указанном смещении.
`void`	`update(ByteBuffer input)` Обновите обзор, используя указанный ByteBuffer.

Методы java.security унаследованный от класса. MessageDigestSpi
engineDigest, engineDigest, engineGetDigestLength, engineReset, engineUpdate, engineUpdate, engineUpdate

Методы java.lang унаследованный от класса. Объект
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - MessageDigest
```
protected MessageDigest(String algorithm)
```
    Создает обзор сообщения с указанным именем алгоритма.
    
    Параметры:
    algorithm - стандартное имя алгоритма обзора. См. раздел MessageDigest в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.
- Деталь метода
  - getInstance
```
public static MessageDigest getInstance(String algorithm)
                                 throws NoSuchAlgorithmException
```
    Возвращается MessageDigest возражают, что реализует указанный алгоритм обзора.
    Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект MessageDigest инкапсуляция реализации MessageDigestSpi от первого Провайдера, который поддерживает указанный алгоритм.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    algorithm - имя алгоритма требуют. См. раздел MessageDigest в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.
    
    Возвраты:
    сообщение Обзор возражает, что реализует указанный алгоритм.
    
    Броски:
    
    NoSuchAlgorithmException - если никакой Провайдер не поддерживает реализацию MessageDigestSpi для указанного алгоритма.
    См. Также:
    Provider
  - getInstance
```
public static MessageDigest getInstance(String algorithm,
                        String provider)
                                 throws NoSuchAlgorithmException,
                                        NoSuchProviderException
```
    Возвращается MessageDigest возражают, что реализует указанный алгоритм обзора.
    Возвращается новый объект MessageDigest инкапсуляция реализации MessageDigestSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    algorithm - имя алгоритма требуют. См. раздел MessageDigest в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.
    provider - имя провайдера.
    
    Возвраты:
    MessageDigest возражает, что реализует указанный алгоритм.
    
    Броски:
    
    NoSuchAlgorithmException - если реализация MessageDigestSpi для указанного алгоритма не доступна от указанного провайдера.
    
    NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.
    
    IllegalArgumentException - если имя провайдера является нулем или пустой.
    См. Также:
    Provider
  - getInstance
```
public static MessageDigest getInstance(String algorithm,
                        Provider provider)
                                 throws NoSuchAlgorithmException
```
    Возвращается MessageDigest возражают, что реализует указанный алгоритм обзора.
    Возвращается новый объект MessageDigest инкапсуляция реализации MessageDigestSpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.
    
    Параметры:
    algorithm - имя алгоритма требуют. См. раздел MessageDigest в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.
    provider - провайдер.
    
    Возвраты:
    MessageDigest возражает, что реализует указанный алгоритм.
    
    Броски:
    
    NoSuchAlgorithmException - если реализация MessageDigestSpi для указанного алгоритма не доступна от указанного объекта Провайдера.
    
    IllegalArgumentException - если указанный провайдер является нулем.
    С тех пор:
    
    1.4
    
    См. Также:
    Provider
  - getProvider
```
public final Provider getProvider()
```
    Возвращает провайдера этого объекта обзора сообщения.
    
    Возвраты:
    провайдер этого объекта обзора сообщения
  - обновление
```
public void update(byte input)
```
    Обновляет обзор, используя указанный байт.
    
    Параметры:
    input - байт, с которым можно обновить обзор.
  - обновление
```
public void update(byte[] input,
          int offset,
          int len)
```
    Обновляет обзор, используя указанный массив байтов, запускаясь при указанном смещении.
    
    Параметры:
    input - массив байтов.
    offset - смещение, чтобы запуститься с в массиве байтов.
    len - число байтов, чтобы использовать, запускаясь в offset.
  - обновление
```
public void update(byte[] input)
```
    Обновляет обзор, используя указанный массив байтов.
    
    Параметры:
    input - массив байтов.
  - обновление
```
public final void update(ByteBuffer input)
```
    Обновите обзор, используя указанный ByteBuffer. Обзор обновляется, используя input.remaining() байты, запускающиеся в input.position(). По возврату позиция буфера будет равна своему пределу; его предел не будет изменяться.
    
    Параметры:
    input - ByteBuffer
    С тех пор:
    
    1.5
  - обзор
```
public byte[] digest()
```
    Завершает вычисление хеша, выполняя заключительные операции, такие как дополнение. Обзор сбрасывается после того, как этот вызов выполняется.
    
    Возвраты:
    массив байтов для получающегося значения хэш-функции.
  - обзор
```
public int digest(byte[] buf,
         int offset,
         int len)
           throws DigestException
```
    Завершает вычисление хеша, выполняя заключительные операции, такие как дополнение. Обзор сбрасывается после того, как этот вызов выполняется.
    
    Параметры:
    buf - буфер вывода для вычисленного обзора
    offset - смещение в буфер вывода, чтобы начать хранить обзор
    len - число байтов в пределах buf выделяется для обзора
    
    Возвраты:
    число байтов, помещенных в buf
    
    Броски:
    
    DigestException - если ошибка происходит.
  - обзор
```
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 - другой обзор, чтобы сравниться.
    
    Возвраты:
    истина, если обзоры равны, ложны иначе.
  - сброс
```
public void reset()
```
    Сбрасывает обзор для дальнейшего использования.
  - getAlgorithm
```
public final String getAlgorithm()
```
    Возвращает строку, которая идентифицирует алгоритм, независимый от деталей реализации. Имя должно быть стандартным именем Безопасности Java (таким как "SHA", "MD5", и так далее). См. раздел MessageDigest в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.
    
    Возвраты:
    имя алгоритма
  - getDigestLength
```
public final int getDigestLength()
```
    Возвращает длину обзора в байтах, или 0, если эта работа не поддерживается провайдером, и реализация не является cloneable.
    
    Возвраты:
    длина обзора в байтах, или 0, если эта работа не поддерживается провайдером и реализацией, не является cloneable.
    С тех пор:
    
    1.2
  - клон
```
public Object clone()
             throws CloneNotSupportedException
```
    Возвращает клона, если реализация является cloneable.
    
    Переопределения:
    
    clone в классе MessageDigestSpi
    
    Возвраты:
    клон, если реализация является cloneable.
    
    Броски:
    
    CloneNotSupportedException - если это вызывают на реализации, которая не поддерживает Cloneable.
    См. Также:
    Cloneable

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс MessageDigest

Сводка конструктора

Сводка метода

Методы java.security унаследованный от класса. MessageDigestSpi

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

MessageDigest

Деталь метода

getInstance

getInstance

getInstance

getProvider

обновление

обновление

обновление

обновление

обзор

обзор

обзор

toString

isEqual

сброс

getAlgorithm

getDigestLength

клон