Класс DigestOutputStream

java.security.DigestOutputStream

Все реализованные интерфейсы:: Closeable, Flushable, AutoCloseable

public class DigestOutputStream extends FilterOutputStream

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

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

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

С:

1.2

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected MessageDigest`	`digest`	Дайджест сообщения, связанный с этим потоком.

Поля, объявленные в классе java.io.FilterOutputStream

out

Краткое описание конструкторов

Конструктор	Описание
`DigestOutputStream(OutputStream stream, MessageDigest digest)`	Создаёт поток дайджеста, используя указанный выходной поток и дайджест сообщения.

Краткое описание методов

Модификатор и тип	Метод	Описание
`MessageDigest`	`getMessageDigest()`	Возвращает дайджест сообщения, связанный с этим потоком.
`void`	`on(boolean on)`	Включает или выключает функцию дайджеста.
`void`	`setMessageDigest(MessageDigest digest)`	Связывает указанный дайджест сообщения с этим потоком.
`String`	`toString()`	Выводит строковое представление этого потока дайджеста и связанного объекта дайджеста сообщений.
`void`	`write(byte[] b, int off, int len)`	Обновляет дайджест сообщения (если функция дайджеста включена) с использованием указанного подмассива, и в любом случае записывает подмассив в выходной поток.
`void`	`write(int b)`	Обновляет дайджест сообщения (если функция дайджеста включена) с использованием указанного байта, и в любом случае записывает байт в выходной поток.

Методы, объявленные в классе java.io.FilterOutputStream

close, flush, write

Методы, объявленные в классе java.io.OutputStream

nullOutputStream

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

digest

protected MessageDigest digest

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

Подробное описание конструкторов

DigestOutputStream

public DigestOutputStream(OutputStream stream, MessageDigest digest)

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

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

Подробное описание методов

getMessageDigest

public MessageDigest getMessageDigest()

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

Возвращает:

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

См. также:

setMessageDigest

public void setMessageDigest(MessageDigest digest)

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

Параметры:

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

См. также:

write

public void write(int b) throws IOException

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

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

write в классе FilterOutputStream

Параметры:

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

Исключения:

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

См. также:

write

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

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

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

write в классе FilterOutputStream

Параметры:

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

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

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

Исключения:

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

См. также:

on

public void on(boolean on)

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

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

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта.

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/DigestOutputStream.html