Класс Base64

java.lang.Object

java.util.Base64

public final class Base64 extends Object

Этот класс состоит исключительно из статических методов для получения кодировщиков и декодировщиков схемы кодирования Base64. Реализация этого класса поддерживает следующие типы Base64, определённые в RFC 4648 и RFC 2045.

Базовый
Для операций кодирования и декодирования используется «алфавит Base64», указанный в таблице 1 RFC 4648 и RFC 2045. Кодировщик не добавляет символ перевода строки (разделитель строк). Декодировщик отклоняет данные, содержащие символы, не входящие в алфавит Base64.
Безопасный для URL и имён файлов
Для кодирования и декодирования используется «алфавит Base64, безопасный для URL и имён файлов», указанный в таблице 2 RFC 4648. Кодировщик не добавляет символ перевода строки (разделитель строк). Декодировщик отклоняет данные, содержащие символы, не входящие в алфавит Base64.
MIME
Для операций кодирования и декодирования используется «алфавит Base64», указанный в таблице 1 RFC 2045. Закодированные выходные данные должны быть представлены строками длиной не более 76 символов; в качестве разделителя строк используется возврат каретки '\r', за которым непосредственно следует перевод строки '\n'. В конец закодированных выходных данных разделитель строк не добавляется. При декодировании все разделители строк и другие символы, отсутствующие в таблице алфавита Base64, игнорируются.

Если не указано иное, передача аргумента null методу этого класса приведёт к выбрасыванию NullPointerException.

Начиная с версии:

1.8

Внешние спецификации

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`Base64.Decoder`	Этот класс реализует декодировщик для декодирования байтовых данных с использованием схемы кодирования Base64, указанной в RFC 4648 и RFC 2045.
`static class`	`Base64.Encoder`	Этот класс реализует кодировщик для кодирования байтовых данных с использованием схемы кодирования Base64, указанной в RFC 4648 и RFC 2045.

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

Модификатор и тип	Метод	Описание
`static Base64.Decoder`	`getDecoder()`	Возвращает `Base64.Decoder`, выполняющий декодирование с использованием схемы кодирования Base64 базового типа.
`static Base64.Encoder`	`getEncoder()`	Возвращает `Base64.Encoder`, выполняющий кодирование с использованием схемы кодирования Base64 базового типа.
`static Base64.Decoder`	`getMimeDecoder()`	Возвращает `Base64.Decoder`, выполняющий декодирование с использованием схемы декодирования Base64 типа MIME.
`static Base64.Encoder`	`getMimeEncoder()`	Возвращает `Base64.Encoder`, выполняющий кодирование с использованием схемы кодирования Base64 типа MIME.
`static Base64.Encoder`	`getMimeEncoder(int lineLength, byte[] lineSeparator)`	Возвращает `Base64.Encoder`, выполняющий кодирование с использованием схемы кодирования Base64 типа MIME с заданной длиной строк и разделителями строк.
`static Base64.Decoder`	`getUrlDecoder()`	Возвращает `Base64.Decoder`, выполняющий декодирование с использованием схемы кодирования Base64 типа безопасного для URL и имён файлов.
`static Base64.Encoder`	`getUrlEncoder()`	Возвращает `Base64.Encoder`, выполняющий кодирование с использованием схемы кодирования Base64 типа безопасного для URL и имён файлов.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Метод завершения устарел и может быть удалён в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.

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

getEncoder

public static Base64.Encoder getEncoder()

Возвращает Base64.Encoder, выполняющий кодирование с использованием схемы кодирования Base64 базового типа.

Возвращает:: Кодировщик Base64.

getUrlEncoder

public static Base64.Encoder getUrlEncoder()

Возвращает Base64.Encoder, выполняющий кодирование с использованием схемы кодирования Base64 типа безопасного для URL и имён файлов.

Возвращает:: Кодировщик Base64.

getMimeEncoder

public static Base64.Encoder getMimeEncoder()

Возвращает Base64.Encoder, выполняющий кодирование с использованием схемы кодирования Base64 типа MIME.

Возвращает:: Кодировщик Base64.

getMimeEncoder

public static Base64.Encoder getMimeEncoder(int lineLength, byte[] lineSeparator)

Возвращает Base64.Encoder, выполняющий кодирование с использованием схемы кодирования Base64 типа MIME с заданной длиной строк и разделителями строк.

Параметры:: lineLength — длина каждой выходной строки (округляется вниз до ближайшего числа, кратного 4). Если округлённая вниз длина строки не является положительным значением, выходные данные не будут разбиты на строки; lineSeparator — разделитель строк для каждой выходной строки
Возвращает:: Кодировщик Base64.
Выбрасывает:: IllegalArgumentException — если lineSeparator содержит какой-либо символ из «алфавита Base64», указанного в таблице 1 RFC 2045.

getDecoder

public static Base64.Decoder getDecoder()

Возвращает Base64.Decoder, выполняющий декодирование с использованием схемы кодирования Base64 базового типа.

Возвращает:: Декодировщик Base64.

getUrlDecoder

public static Base64.Decoder getUrlDecoder()

Возвращает Base64.Decoder, выполняющий декодирование с использованием схемы кодирования Base64 типа безопасного для URL и имён файлов.

Возвращает:: Декодировщик Base64.

getMimeDecoder

public static Base64.Decoder getMimeDecoder()

Возвращает Base64.Decoder, выполняющий декодирование с использованием схемы декодирования Base64 типа MIME.

Возвращает:: Декодировщик Base64.

© 1993, 2025, 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.