Интерфейс Checksum

Все известные реализующие классы:: Adler32, CRC32, CRC32C

public interface Checksum

Интерфейс, представляющий контрольную сумму данных.

С тех пор:: 1.1

Методы

Модификатор и тип	Метод	Описание
`long`	`getValue()`	Возвращает текущее значение контрольной суммы.
`void`	`reset()`	Сбрасывает контрольную сумму до её начального значения.
`default void`	`update(byte[] b)`	Обновляет текущую контрольную сумму с помощью указанного массива байтов.
`void`	`update(byte[] b, int off, int len)`	Обновляет текущую контрольную сумму с помощью указанного массива байтов.
`void`	`update(int b)`	Обновляет текущую контрольную сумму с помощью указанного байта.
`default void`	`update(ByteBuffer buffer)`	Обновляет текущую контрольную сумму с помощью байтов из указанного буфера.

Методы

update

void update(int b)

Обновляет текущую контрольную сумму с помощью указанного байта.

Параметры:: b - байт для обновления контрольной суммы

update

default void update(byte[] b)

Обновляет текущую контрольную сумму с помощью указанного массива байтов.

Требования к реализации:: Эта реализация по умолчанию эквивалентна вызову update(b, 0, b.length).
Параметры:: b - массив байтов для обновления контрольной суммы
Исключения:: NullPointerException - если b равен null
С тех пор:: 9

update

void update(byte[] b,
            int off,
            int len)

Обновляет текущую контрольную сумму с помощью указанного массива байтов.

Параметры:: b - массив байтов для обновления контрольной суммы; off - начальный смещение данных; len - количество байтов для обновления

update

default void update(ByteBuffer buffer)

Обновляет текущую контрольную сумму с помощью байтов из указанного буфера. Контрольная сумма обновляется оставшимися байтами в буфере, начиная с позиции буфера. По возвращении позиция буфера будет обновлена до его предела; его предел не будет изменён.

Примечание API:

Для лучшей производительности с DirectByteBuffer и другими реализациями ByteBuffer без обратной поддержки массива реализаторы этого интерфейса должны переопределить этот метод.

Требования к реализации:

Реализация по умолчанию имеет следующее поведение.
Для ByteBuffers, поддерживаемых доступным массивом байтов.

update(buffer.array(),
        buffer.position() + buffer.arrayOffset(),
        buffer.remaining());

Для ByteBuffers, не поддерживаемых доступным массивом байтов.

byte[] b = new byte[Math.min(buffer.remaining(), 4096)];
 while (buffer.hasRemaining()) {
     int length = Math.min(buffer.remaining(), b.length);
     buffer.get(b, 0, length);
     update(b, 0, length);
 }

Параметры:

buffer - ByteBuffer для обновления контрольной суммы

Исключения:

NullPointerException - если buffer равен null

С тех пор:

getValue

long getValue()

Возвращает текущее значение контрольной суммы.

Возвращает:: текущее значение контрольной суммы

reset

void reset()

Сбрасывает контрольную сумму до её начального значения.