Spec-Zone.ru › OpenJDK 25

Класс SNIServerName

java.lang.Object
javax.net.ssl.SNIServerName
Прямые известные подклассы:
SNIHostName
public abstract class SNIServerName extends Object
Экземпляры этого класса представляют имя сервера в расширении Server Name Indication (SNI).

Расширение SNI — это функция, расширяющая протоколы SSL/TLS/DTLS и позволяющая указать имя сервера, к которому клиент пытается подключиться во время рукопожатия. См. раздел 3 «Server Name Indication» документа Расширения TLS (RFC 6066).

Объекты SNIServerName неизменяемы. Подклассы не должны предоставлять методы, позволяющие изменять состояние экземпляра после его создания.

С момента:
1.8
Внешние спецификации
  • RFC 6066: Расширения протокола защиты транспортного уровня (TLS): определения расширений
См. также:
  • SSLParameters.getServerNames()
  • SSLParameters.setServerNames(List)

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

SNIServerName(int type, byte[] encoded)
Модификатор Конструктор Описание
protected
Создаёт SNIServerName с указанными типом имени и закодированным значением.

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

Модификатор и тип Метод Описание
boolean equals(Object other)
Указывает, равен ли этот объект имени данного сервера.
final byte[] getEncoded()
Возвращает копию закодированного значения имени этого сервера.
final int getType()
Возвращает тип имени этого сервера.
int hashCode()
Возвращает значение хеш-кода для имени этого сервера.
String toString()
Возвращает строковое представление имени этого сервера, включая тип имени сервера и закодированное значение имени сервера в этом объекте SNIServerName.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

SNIServerName

protected SNIServerName(int type, byte[] encoded)
Создаёт SNIServerName с указанными типом имени и закодированным значением.

Обратите внимание, что массив байтов encoded клонируется для защиты от последующего изменения.

Параметры:
type — тип имени сервера
encoded — закодированное значение имени сервера
Исключения:
IllegalArgumentException — если type не входит в диапазон от 0 до 255 включительно.
NullPointerException — если encoded равно null

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

getType

public final int getType()
Возвращает тип имени этого сервера.
Возвращает:
тип имени этого сервера

getEncoded

public final byte[] getEncoded()
Возвращает копию закодированного значения имени этого сервера.
Возвращает:
копию закодированного значения имени этого сервера

equals

public boolean equals(Object other)
Указывает, равен ли этот объект имени данного сервера.
Переопределяет:
equals в классе Object
Параметры:
other — объект-ссылка, с которым выполняется сравнение.
Возвращает:
true тогда и только тогда, когда other принадлежит тому же классу, что и этот объект, и имеет тот же тип имени и закодированное значение, что и имя данного сервера.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Возвращает значение хеш-кода для имени этого сервера.

Значение хеш-кода вычисляется с использованием типа имени и закодированного значения имени этого сервера.

Переопределяет:
hashCode в классе Object
Возвращает:
значение хеш-кода для имени этого сервера.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

toString

public String toString()
Возвращает строковое представление имени этого сервера, включая тип имени сервера и закодированное значение имени сервера в этом объекте SNIServerName.

Точный формат представления не определён и может измениться, однако типичным можно считать следующий вариант:

    "type=<name type>, value=<name value>"

В этом классе формат «<name type>» — «[LITERAL] (INTEGER)», где необязательное значение «LITERAL» — это имя в буквальном виде, а INTEGER — целочисленное значение типа имени. Формат «<name value>» — «XX:...:XX», где «XX» — шестнадцатеричное представление значения байта. Например, возвращаемое значение для псевдоимени сервера может выглядеть так:

    "type=(31), value=77:77:77:2E:65:78:61:6D:70:6C:65:2E:63:6E"
или
    "type=host_name (0), value=77:77:77:2E:65:78:61:6D:70:6C:65:2E:63:6E"

Обратите ВНИМАНИЕ: точный формат представления не определён и может измениться; подклассы могут переопределить этот метод, задав собственный формат.

Переопределяет:
toString в классе Object
Возвращает:
строковое представление имени этого сервера

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры рабочего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/javax/net/ssl/SNIServerName.html

Spec-Zone.ru

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