SSLSession (Платформа Java SE 7)

Все Известные Классы с реализацией:

ExtendedSSLSession
```
public interface SSLSession
```
На SSL сеансы используются, чтобы описать длительные отношения между двумя объектами. Каждое соединение SSL включает один сеанс за один раз, но тот сеанс может использоваться на многих соединениях между теми объектами, одновременно или последовательно. Сеанс, используемый на соединении, может также быть заменен различным сеансом. Сеансы создаются, или воссоединяются как часть протокола квитирования SSL. Сеансы могут быть лишены законной силы из-за политик, влияющих на безопасность или использование ресурсов, или приложением, явно вызывая invalidate. Политики управления сеансами обычно используются, чтобы настроить производительность.
В дополнение к стандартным атрибутам сеанса сеансы SSL представляют эти атрибуты "только для чтения":
- Равноправные Идентификационные данные. Сеансы между определенным клиентом и определенным сервером. Идентификационные данные коллеги, возможно, были установлены как часть установки сеанса. Коллеги обычно идентифицируются цепочками сертификата X.509.
- Имя Комплекта шифра. Комплекты шифра описывают вид криптографической защиты, это используется соединениями в определенном сеансе.
- Равноправный Узел. Все соединения в сеансе между теми же самыми двумя узлами. Адрес узла с другой стороны соединения доступен.
Сеансы могут быть явно лишены законной силы. Аннулирование может также быть сделано неявно, когда сталкивающийся с определенными видами ошибок.
С тех пор:

1.4

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`int`	`getApplicationBufferSize()` Получает текущий размер самых больших данных приложения, который ожидается при использовании этого сеанса.
`Строка`	`getCipherSuite()` Возвращает имя комплекта шифра SSL, который используется для всех соединений в сеансе.
`long`	`getCreationTime()` Возвращает время, в которое это представление Сеанса создавалось, в миллисекундах с полуночи, 1 января 1970 UTC.
`byte[]`	`getId()` Возвращает идентификатор, присвоенный этому Сеансу.
`long`	`getLastAccessedTime()` Возвращается в прошлый раз, когда к этому представлению Сеанса получила доступ инфраструктура сеансового уровня, в миллисекундах с полуночи, 1 января 1970 UTC.
`Сертификат[]`	`getLocalCertificates()` Возвращает сертификат (ы), которые были отправлены коллеге во время квитирования.
`Принципал`	`getLocalPrincipal()` Возвращает принципал, который был отправлен коллеге во время квитирования.
`int`	`getPacketBufferSize()` Получает текущий размер самого большого пакета SSL/TLS, который ожидается при использовании этого сеанса.
`X509Certificate[]`	`getPeerCertificateChain()` Возвращает идентификационные данные коллеги, которая была идентифицирована как часть определения сеанса.
`Сертификат[]`	`getPeerCertificates()` Возвращает идентификационные данные коллеги, которая была установлена как часть определения сеанса.
`Строка`	`getPeerHost()` Возвращает имя хоста коллеги в этом сеансе.
`int`	`getPeerPort()` Возвращает номер порта коллеги в этом сеансе.
`Принципал`	`getPeerPrincipal()` Возвращает идентификационные данные коллеги, которая была установлена как часть определения сеанса.
`Строка`	`getProtocol()` Возвращает стандартное имя протокола, используемого для всех соединений в сеансе.
`SSLSessionContext`	`getSessionContext()` Возвращает контекст, в котором связывается этот сеанс.
`Объект`	`getValue(String name)` Возвращает объект, связанный с именем в данных прикладного уровня сеанса.
`Строка[]`	`getValueNames()` Возвращает массив имен всех объектов данных прикладного уровня, связанных в Сеанс.
`void`	`invalidate()` Лишает законной силы сеанс.
`boolean`	`isValid()` Возвраты, допустим ли этот сеанс и доступен для возобновления или присоединения.
`void`	`putValue(String name, Object value)` Связывает указанное `value` объект в данные прикладного уровня сеанса с данным `name`.
`void`	`removeValue(String name)` Удаляет объект, связанный с именем в данных прикладного уровня сеанса.

- Деталь метода
  - getId
```
byte[] getId()
```
    Возвращает идентификатор, присвоенный этому Сеансу.
    
    Возвраты:
    идентификатор Сеанса
  - getSessionContext
```
SSLSessionContext getSessionContext()
```
    Возвращает контекст, в котором связывается этот сеанс.
    Этот контекст может быть недоступным в некоторых средах, когда этот метод возвращает нуль.
    Если контекст доступен и есть установленный менеджер безопасности, вызывающая сторона может потребовать, чтобы разрешение получило доступ к этому, или исключение безопасности может быть выдано. В среде Java, менеджер безопасности checkPermission метод вызывают с a SSLPermission("getSSLSessionContext") разрешение.
    
    Возвраты:
    контекст сеанса, используемый для этого сеанса, или нуля, если контекст недоступен.
    
    Броски:
    
    SecurityException - если у вызывающего потока нет разрешения, чтобы получить контекст сеанса SSL.
  - getCreationTime
```
long getCreationTime()
```
    Возвращает время, в которое это представление Сеанса создавалось, в миллисекундах с полуночи, 1 января 1970 UTC.
    
    Возвраты:
    время этот Сеанс создавалось
  - getLastAccessedTime
```
long getLastAccessedTime()
```
    Возвращается в прошлый раз, когда к этому представлению Сеанса получила доступ инфраструктура сеансового уровня, в миллисекундах с полуночи, 1 января 1970 UTC.
    Доступ указывает на новое соединение, устанавливаемое, используя данные сеанса. В это время доступа не отражаются операции уровня приложения, такие как получение или установка значения, связанного с сеансом.
    Эта информация особенно полезна в политиках управления сеансами. Например, поток менеджера сеансов мог оставить все сеансы в данном контексте, которые не использовались в длительное время; или, сеансы могли бы быть сортированы согласно возрасту, чтобы оптимизировать некоторую задачу.
    
    Возвраты:
    в прошлый раз к этому Сеансу получили доступ
  - лишить законной силы
```
void invalidate()
```
    Лишает законной силы сеанс.
    Будущие соединения не будут в состоянии возобновить или присоединиться к этому сеансу. Однако, любое существующее соединение, используя этот сеанс может продолжать использовать сеанс, пока соединение не закрывается.
    
    См. Также:
    isValid()
  - isValid
```
boolean isValid()
```
    Возвраты, допустим ли этот сеанс и доступен для возобновления или присоединения.
    
    Возвраты:
    истина, если этот сеанс может быть воссоединен.
    С тех пор:
    
    1.5
    
    См. Также:
    invalidate()
  - putValue
```
void putValue(String name,
            Object value)
```
    Связывает указанное value объект в данные прикладного уровня сеанса с данным name.
    Любая существующая привязка, используя то же самое name заменяется. Если новое (или существующий) value реализации SSLSessionBindingListener интерфейс, объект, представленный value уведомляется соответственно.
    Для соображений безопасности те же самые именованные значения, возможно, не видимы через различные контексты управления доступом.
    
    Параметры:
    name - имя, с которым будет связан объект данных. Это, возможно, не нуль.
    value - объект данных, который будет связан. Это, возможно, не нуль.
    
    Броски:
    
    IllegalArgumentException - если любым параметром является нуль.
  - getValue
```
Object getValue(String name)
```
    Возвращает объект, связанный с именем в данных прикладного уровня сеанса. Нуль возвратов, если нет такой привязки.
    Для соображений безопасности те же самые именованные значения, возможно, не видимы через различные контексты управления доступом.
    
    Параметры:
    name - имя привязки, чтобы найти.
    
    Возвраты:
    значение, связанное с тем именем, или нулем, если привязка не существует.
    
    Броски:
    
    IllegalArgumentException - если параметром является нуль.
  - removeValue
```
void removeValue(String name)
```
    Удаляет объект, связанный с именем в данных прикладного уровня сеанса. Ничего не делает, если нет никакого объекта, связанного с именем. Если связанный существующий объект реализует SessionBindingListener интерфейс, это уведомляется соответственно.
    Для соображений безопасности те же самые именованные значения, возможно, не видимы через различные контексты управления доступом.
    
    Параметры:
    name - имя объекта удалить видимый через различные контексты управления доступом
    
    Броски:
    
    IllegalArgumentException - если параметром является нуль.
  - getValueNames
```
String[] getValueNames()
```
    Возвращает массив имен всех объектов данных прикладного уровня, связанных в Сеанс.
    Для соображений безопасности те же самые именованные значения, возможно, не видимы через различные контексты управления доступом.
    
    Возвраты:
    ненуль (возможно пустой) массив имен объектов, связанных с этим Сеансом.
  - getPeerCertificates
```
Certificate[] getPeerCertificates()
                                  throws SSLPeerUnverifiedException
```
    Возвращает идентификационные данные коллеги, которая была установлена как часть определения сеанса.
    Отметьте: Этот метод может использоваться только при использовании основанных на сертификате комплектов шифра; используя это с не сертификат базируемые комплекты шифра, такие как Kerberos, бросят SSLPeerUnverifiedException.
    
    Возвраты:
    упорядоченный массив равноправных сертификатов, с собственным сертификатом коллеги, сначала сопровождаемым любыми центрами сертификации.
    
    Броски:
    
    SSLPeerUnverifiedException - если идентификационные данные коллеги не были проверены
    См. Также:
    getPeerPrincipal()
  - getLocalCertificates
```
Certificate[] getLocalCertificates()
```
    Возвращает сертификат (ы), которые были отправлены коллеге во время квитирования.
    Отметьте: Этот метод полезен только при использовании основанных на сертификате комплектов шифра.
    Когда многократные сертификаты доступны для использования в квитировании, реализация выбирает то, что это считает "лучшую" цепочку сертификата доступной, и передачи это другой стороне. Этот метод позволяет вызывающей стороне знать, какая цепочка сертификата фактически использовалась.
    
    Возвраты:
    упорядоченный массив сертификатов, с локальным сертификатом, сначала сопровождаемым любыми центрами сертификации. Если никакие сертификаты не были отправлены, то нуль возвращается.
    См. Также:
    getLocalPrincipal()
  - getPeerCertificateChain
```
X509Certificate[] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException
```
    Возвращает идентификационные данные коллеги, которая была идентифицирована как часть определения сеанса.
    Отметьте: Этот метод может использоваться только при использовании основанных на сертификате комплектов шифра; используя это с не сертификат базируемые комплекты шифра, такие как Kerberos, бросят SSLPeerUnverifiedException.
    Отметьте: этот метод существует для совместимости с предыдущими выпусками. Новые приложения должны использовать getPeerCertificates() вместо этого.
    
    Возвраты:
    упорядоченный массив коллеги сертификаты X.509, с собственным сертификатом коллеги, сначала сопровождаемым любыми центрами сертификации. (Сертификаты находятся в исходном сертификате JSSE X509Certificate формат.)
    
    Броски:
    
    SSLPeerUnverifiedException - если идентификационные данные коллеги не были проверены
    См. Также:
    getPeerPrincipal()
  - getPeerPrincipal
```
Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException
```
    Возвращает идентификационные данные коллеги, которая была установлена как часть определения сеанса.
    
    Возвраты:
    принципал коллеги. Возвращает X500Principal объекта конца certiticate для X509-на-основе комплектов шифра, и KerberosPrincipal для комплектов шифра Kerberos.
    
    Броски:
    
    SSLPeerUnverifiedException - если идентификационные данные коллеги не были проверены
    С тех пор:
    
    1.5
    
    См. Также:
    getPeerCertificates(), getLocalPrincipal()
  - getLocalPrincipal
```
Principal getLocalPrincipal()
```
    Возвращает принципал, который был отправлен коллеге во время квитирования.
    
    Возвраты:
    принципал, отправленный коллеге. Возвращает X500Principal сертификата объекта конца для X509-на-основе комплектов шифра, и KerberosPrincipal для комплектов шифра Kerberos. Если никакой принципал не был отправлен, то нуль возвращается.
    С тех пор:
    
    1.5
    
    См. Также:
    getLocalCertificates(), getPeerPrincipal()
  - getCipherSuite
```
String getCipherSuite()
```
    Возвращает имя комплекта шифра SSL, который используется для всех соединений в сеансе.
    Это определяет уровень защиты, обеспеченный для данных, отправленных на соединении, включая вид используемого шифрования и большинство аспектов того, как аутентификация делается.
    
    Возвраты:
    имя комплекта шифра сеанса
  - getProtocol
```
String getProtocol()
```
    Возвращает стандартное имя протокола, используемого для всех соединений в сеансе.
    Это определяет протокол, используемый в соединении.
    
    Возвраты:
    стандартное имя протокола используется для всех соединений в сеансе.
  - getPeerHost
```
String getPeerHost()
```
    Возвращает имя хоста коллеги в этом сеансе.
    Для сервера это - узел клиента; и для клиента, это - узел сервера. Имя, возможно, не полностью определенное имя хоста или даже имя хоста вообще, поскольку оно может представить строковое кодирование сетевого адреса коллеги. Если такое имя требуется, оно могло бы быть разрешено через службу имен, основанную на значении, возвращенном этим методом.
    Это значение не аутентифицируется и не должно быть положено. Это, главным образом, используется в качестве подсказки для SSLSession кэширование стратегий.
    
    Возвраты:
    имя хоста равноправного узла, или нуль, если никакая информация не доступна.
  - getPeerPort
```
int getPeerPort()
```
    Возвращает номер порта коллеги в этом сеансе.
    Для сервера это - номер порта клиента; и для клиента, это - номер порта сервера.
    Это значение не аутентифицируется и не должно быть положено. Это, главным образом, используется в качестве подсказки для SSLSession кэширование стратегий.
    
    Возвраты:
    номер порта равноправного узла, или-1, если никакая информация не доступна.
    С тех пор:
    
    1.5
  - getPacketBufferSize
```
int getPacketBufferSize()
```
    Получает текущий размер самого большого пакета SSL/TLS, который ожидается при использовании этого сеанса.
    A SSLEngine использование этого сеанса может генерировать пакеты SSL/TLS любого размера до и включая значение, возвращенное этим методом. Все SSLEngine сетевые буферы должны быть измерены, по крайней мере, это большое, чтобы избежать недостаточных проблем свободного пространства, выполняя wrap и unwrap вызовы.
    
    Возвраты:
    текущий максимальный ожидаемый сетевой пакетный размер
    С тех пор:
    
    1.5
    
    См. Также:
    SSLEngine.wrap(ByteBuffer, ByteBuffer), SSLEngine.unwrap(ByteBuffer, ByteBuffer)
  - getApplicationBufferSize
```
int getApplicationBufferSize()
```
    Получает текущий размер самых больших данных приложения, который ожидается при использовании этого сеанса.
    SSLEngine буферы данных приложения должны быть достаточно большими, чтобы содержать данные приложения от любого входящего сетевого полученного пакета данных приложения. Как правило, исходящие буферы данных приложения могут иметь любой размер.
    
    Возвраты:
    текущий максимальный ожидаемый пакетный размер приложения
    С тех пор:
    
    1.5
    
    См. Также:
    SSLEngine.wrap(ByteBuffer, ByteBuffer), SSLEngine.unwrap(ByteBuffer, ByteBuffer)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный SSLSession

Сводка метода

Деталь метода

getId

getSessionContext

getCreationTime

getLastAccessedTime

лишить законной силы

isValid

putValue

getValue

removeValue

getValueNames

getPeerCertificates

getLocalCertificates

getPeerCertificateChain

getPeerPrincipal

getLocalPrincipal

getCipherSuite

getProtocol

getPeerHost

getPeerPort

getPacketBufferSize

getApplicationBufferSize