Интерфейс BinaryEncodable

public sealed interface BinaryEncodable permits AsymmetricKey, KeyPair, PKCS8EncodedKeySpec, X509EncodedKeySpec, EncryptedPrivateKeyInfo, X509Certificate, X509CRL, PEMPREVIEW (not exhaustive)

Этот интерфейс обозначает криптографические объекты, которые можно преобразовывать в двоичные данные и обратно, а значит, кодировать в текст PEM и декодировать из него.

API для криптографических объектов, таких как открытые ключи, закрытые ключи, сертификаты и списки отзыва сертификатов, предоставляют средства для преобразования своих экземпляров в стандартизованные двоичные представления и обратно. Для других видов криптографических объектов, таких как запросы на выдачу сертификатов, соответствующего API нет, однако их всё ещё можно представить в стандартизованном двоичном формате. Интерфейс BinaryEncodable позволяет классам PEMEncoder^{ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ} и PEMDecoder^{ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ} единообразно работать с двоичными представлениями ключей или сертификатов.

Разрешённый подтип PEM примечателен тем, что поддерживает кодирование и декодирование текста PEM, представляющего криптографические объекты, для которых не существует API. В будущих выпусках могут быть добавлены другие разрешённые подтипы для поддержки кодирования и декодирования таких криптографических объектов.

Список разрешённых подтипов, приведённый после permits, не является исчерпывающим. Это означает, что если код приложения выполняет переключение по значению BinaryEncodable, то switch нельзя сделать исчерпывающим, просто указав метку case для каждого разрешённого подтипа из списка; также должна быть метка default или case BinaryEncodable для обработки дополнительных подтипов. Это позволяет со временем изменять список разрешённых подтипов, не вызывая сбоев ранее написанных операторов switch из-за нераспознанного подтипа.