Класс DigestOutputStream

public class DigestOutputStream
extends FilterOutputStream

Прозрачный поток, обновляющий связанный дайджест сообщения с использованием битов, проходящих через поток.

Для завершения вычисления дайджеста сообщения вызовите один из digest методов связанного дайджеста сообщения после ваших вызовов одного из методов потока вывода дайджеста write.

Возможна активация или деактивация этого потока (см. on). При включенном режиме вызов одного из write методов приводит к обновлению дайджеста сообщения. При выключенном режиме дайджест сообщения не обновляется. По умолчанию поток включен.

Поля

digest

protected MessageDigest digest

Дайджест сообщения, связанный с этим потоком.

Конструкторы

DigestOutputStream

public DigestOutputStream(OutputStream stream,
                          MessageDigest digest)

Создает поток вывода дайджеста, используя указанный поток вывода и дайджест сообщения.

Параметры:

stream - поток вывода.

digest - дайджест сообщения, который следует связать с этим потоком.

Методы

getMessageDigest

public MessageDigest getMessageDigest()

Возвращает дайджест сообщения, связанный с этим потоком.

Возвращает:

дайджест сообщения, связанный с этим потоком.

См. также:

setMessageDigest(java.security.MessageDigest)

setMessageDigest

public void setMessageDigest(MessageDigest digest)

Связывает указанный дайджест сообщения с этим потоком.

Параметры:

digest - дайджест сообщения, который следует связать с этим потоком.

См. также:

getMessageDigest()

write

public void write(int b)
           throws IOException

Обновляет дайджест сообщения (если функция дайджеста включена) с использованием указанного байта и в любом случае записывает байт в поток вывода. То есть, если функция дайджеста включена (см. on), этот метод вызывает update для дайджеста сообщения, связанного с этим потоком, передавая ему байт b. Этот метод затем записывает байт в поток вывода, блокируя до тех пор, пока байт не будет фактически записан.

Переопределяет:

write в классе FilterOutputStream

Параметры:

b - байт, используемый для обновления и записи в поток вывода.

Исключения:

IOException - если произошла ошибка ввода-вывода.

См. также:

MessageDigest.update(byte)

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Обновляет дайджест сообщения (если функция дайджеста включена) с использованием указанной подмассива и в любом случае записывает подмассив в поток вывода. То есть, если функция дайджеста включена (см. on), этот метод вызывает update для дайджеста сообщения, связанного с этим потоком, передавая ему спецификации подмассива. Этот метод затем записывает байты подмассива в поток вывода, блокируя до тех пор, пока байты не будут фактически записаны.

Переопределяет:

write в классе FilterOutputStream

Параметры:

b - массив, содержащий подмассив, используемый для обновления и записи в поток вывода.

off - смещение в b первого байта, который нужно обновить и записать.

len - количество байтов данных, которые нужно обновить и записать из b, начиная со смещения off.

Исключения:

IOException - если произошла ошибка ввода-вывода.

См. также:

MessageDigest.update(byte[], int, int)

on

public void on(boolean on)

Включает или выключает функцию дайджеста. По умолчанию включено. При включении вызов одного из write методов приводит к обновлению дайджеста сообщения. При выключении дайджест сообщения не обновляется.

Параметры:

on - true для включения функции дайджеста, false для ее выключения.

toString

public String toString()

Выводит строковое представление этого потока вывода дайджеста и связанного объекта дайджеста сообщений.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление объекта.