Spec-Zone.ru › OpenJDK 21

Класс Base64

java.lang.Object
java.util.Base64
public 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.

Since:
1.8
Внешние спецификации
  • RFC 2045: Многоцелевые расширения электронной почты Интернет (MIME), Часть первая: Формат сообщений интернет-сообщений
  • RFC 4648: Кодирование данных Base16, Base32 и Base64

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

Модификатор и тип Класс Описание
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 и имён файлов.

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

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

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

getEncoder

public static Base64.Encoder getEncoder()
Возвращает Base64.Encoder, который кодирует с использованием схемы кодирования base64 типа Базовый.
Returns:
Кодер Base64.

getUrlEncoder

public static Base64.Encoder getUrlEncoder()
Возвращает Base64.Encoder, который кодирует с использованием схемы кодирования base64 типа Безопасный для URL и имён файлов.
Returns:
Кодер Base64.

getMimeEncoder

public static Base64.Encoder getMimeEncoder()
Возвращает Base64.Encoder, который кодирует с использованием схемы кодирования base64 типа MIME.
Returns:
Кодер Base64.

getMimeEncoder

public static Base64.Encoder getMimeEncoder(int lineLength, byte[] lineSeparator)
Возвращает Base64.Encoder, который кодирует с использованием схемы кодирования base64 типа MIME со специфицированной длиной строки и разделителями строк.
Parameters:
lineLength - длина каждой строки вывода (округляется вниз до ближайшего кратного 4). Если округленная вниз длина строки не является положительным значением, вывод не будет разделен на строки
lineSeparator - разделитель строк для каждой строки вывода
Returns:
Кодер Base64.
Throws:
IllegalArgumentException - если lineSeparator включает любой символ из "Алфавита Base64", как указано в Таблице 1 RFC 2045.

getDecoder

public static Base64.Decoder getDecoder()
Возвращает Base64.Decoder, который декодирует с использованием схемы кодирования base64 типа Базовый.
Returns:
Декодер Base64.

getUrlDecoder

public static Base64.Decoder getUrlDecoder()
Возвращает Base64.Decoder, который декодирует с использованием схемы кодирования base64 типа Безопасный для URL и имён файлов.
Returns:
Декодер Base64.

getMimeDecoder

public static Base64.Decoder getMimeDecoder()
Возвращает Base64.Decoder, который декодирует с использованием схемы декодирования base64 типа MIME.
Returns:
Декодер Base64.

© 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/util/Base64.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API