Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface NetworkChannel extends Channel
Канал, который реализует этот интерфейс, является каналом к сетевому сокету. bind
метод используется, чтобы связать сокет с локальной переменной address
, getLocalAddress
метод возвращает адрес, что сокет связывается с, и setOption
и getOption
методы используются, чтобы установить и запросить опции сокета. Реализация этого интерфейса должна определить опции сокета, которые это поддерживает.
bind
и setOption
методы, у которых иначе нет значения, чтобы возвратиться, определяются, чтобы возвратить сетевой канал, на который они вызываются. Это позволяет вызовам метода быть объединенными в цепочку. Реализации этого интерфейса должны специализировать тип возврата так, чтобы вызовы метода на реализации class могли быть объединены в цепочку.
Модификатор и Тип | Метод и Описание |
---|---|
NetworkChannel |
bind(SocketAddress local)
Связывает сокет канала с локальным адресом.
|
SocketAddress |
getLocalAddress()
Возвращает адрес сокета, что сокет этого канала связывается с, или
null если сокет не связывается. |
<T> T |
getOption(SocketOption<T> name)
Возвращает значение опции сокета.
|
<T> NetworkChannel |
setOption(SocketOption<T> name, T value)
Устанавливает значение опции сокета.
|
Set<SocketOption<?>> |
supportedOptions()
Возвраты ряд опций сокета поддерживаются этим каналом.
|
NetworkChannel bind(SocketAddress local) throws IOException
Этот метод используется, чтобы установить ассоциацию между сокетом и локальным адресом. Как только ассоциация устанавливается тогда, сокет остается связанным, пока канал не закрывается. Если local
у параметра есть значение null
тогда сокет будет связан с адресом, который присваивается автоматически.
local
- Адрес, чтобы связать сокет, или null
связывать сокет с автоматически присвоенным адресом сокетаAlreadyBoundException
- Если сокет уже связываетсяUnsupportedAddressTypeException
- Если тип данного адреса не поддерживаетсяClosedChannelException
- Если канал закрываетсяIOException
- Если некоторая другая ошибка ввода-вывода происходитSecurityException
- Если менеджер безопасности устанавливается, и он отрицает неуказанное разрешение. Реализация этого интерфейса должна определить любые необходимые полномочия.getLocalAddress()
SocketAddress getLocalAddress() throws IOException
null
если сокет не связывается. Где канал bound
к Интернету сокет Протокола адресуется тогда, возвращаемое значение от этого метода имеет тип InetSocketAddress
.
null
если сокет канала не связываетсяClosedChannelException
- Если канал закрываетсяIOException
- Если ошибка ввода-вывода происходит<T> NetworkChannel setOption(SocketOption<T> name, T value) throws IOException
name
- Опция сокетаvalue
- Значение опции сокета. Значение null
может быть допустимое значение для некоторых опций сокета.UnsupportedOperationException
- Если опция сокета не поддерживается этим каналомIllegalArgumentException
- Если значение не является допустимым значением для этой опции сокетаClosedChannelException
- Если этот канал закрываетсяIOException
- Если ошибка ввода-вывода происходитStandardSocketOptions
<T> T getOption(SocketOption<T> name) throws IOException
name
- Опция сокетаnull
может быть допустимое значение для некоторых опций сокета.UnsupportedOperationException
- Если опция сокета не поддерживается этим каналомClosedChannelException
- Если этот канал закрываетсяIOException
- Если ошибка ввода-вывода происходитStandardSocketOptions
Set<SocketOption<?>> supportedOptions()
Этот метод будет продолжать возвращать набор опций даже после того, как канал был закрыт.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92