Интерфейс NetworkChannel

Все суперинтерфейсы:: AutoCloseable, Channel, Closeable

Все известные подинтерфейсы:: MulticastChannel

Все известные реализующие классы:: AsynchronousServerSocketChannel, AsynchronousSocketChannel, DatagramChannel, ServerSocketChannel, SocketChannel

public interface NetworkChannel
extends Channel

Канал к сокету сети.

Канал, реализующий этот интерфейс, представляет собой канал к сокету сети. Метод bind используется для привязки сокета к локальному address, метод getLocalAddress возвращает адрес, к которому привязан сокет, а методы setOption и getOption используются для установки и запроса параметров сокета. Реализация этого интерфейса должна указать параметры сокета, которые она поддерживает.

Методы bind и setOption, которые не имеют значения для возврата, определены для возврата сетевого канала, на котором они вызываются. Это позволяет цепочить вызовы методов. Реализации этого интерфейса должны специализировать тип возвращаемого значения, чтобы вызовы методов в реализующем классе можно было цепочить.

С:: 1.7

Методы

Модификатор и тип	Метод	Описание
`NetworkChannel`	`bind(SocketAddress local)`	Привязывает сокет канала к локальному адресу.
`SocketAddress`	`getLocalAddress()`	Возвращает адрес сокета, к которому привязан сокет этого канала.
`<T> T`	`getOption(SocketOption<T> name)`	Возвращает значение параметра сокета.
`<T> NetworkChannel`	`setOption(SocketOption<T> name, T value)`	Устанавливает значение параметра сокета.
`Set<SocketOption<?>>`	`supportedOptions()`	Возвращает набор параметров сокета, поддерживаемых этим каналом.

Методы, объявленные в интерфейсе java.nio.channels.Channel

close, isOpen

Методы

bind

NetworkChannel bind(SocketAddress local)
             throws IOException

Привязывает сокет канала к локальному адресу.

Этот метод используется для установления связи между сокетом и локальным адресом. После установления связи сокет остается привязанным до закрытия канала. Если параметр local имеет значение null, сокет будет привязан к автоматически назначенному адресу.

Параметры:: local - Адрес для привязки сокета или null для привязки сокета к автоматически назначенному адресу сокета
Возвращает:: Этот канал
Исключения:: AlreadyBoundException - Если сокет уже привязан; UnsupportedAddressTypeException - Если тип заданного адреса не поддерживается; ClosedChannelException - Если канал закрыт; IOException - Если произошла другая ошибка ввода/вывода; SecurityException - Если установлен менеджер безопасности, и он отклонил неопределенное разрешение. Реализация этого интерфейса должна указать все необходимые разрешения.
См. также:: getLocalAddress()

getLocalAddress

SocketAddress getLocalAddress()
                       throws IOException

Возвращает адрес сокета, к которому привязан сокет этого канала.

Если канал привязан к адресу сокета Интернета, то значение, возвращаемое этим методом, имеет тип InetSocketAddress.

Возвращает:: Адрес сокета, к которому привязан сокет, или null если сокет канала не привязан
Исключения:: ClosedChannelException - Если канал закрыт; IOException - Если произошла ошибка ввода/вывода

setOption

<T> NetworkChannel setOption(SocketOption<T> name,
                             T value)
                      throws IOException

Устанавливает значение параметра сокета.

Параметры типа:: T - Тип значения параметра сокета
Параметры:: name - Параметр сокета; value - Значение параметра сокета. Значение null может быть допустимым значением для некоторых параметров сокета.
Возвращает:: Этот канал
Исключения:: UnsupportedOperationException - Если параметр сокета не поддерживается этим каналом; IllegalArgumentException - Если значение не является допустимым значением для данного параметра сокета; ClosedChannelException - Если этот канал закрыт; IOException - Если произошла ошибка ввода/вывода
См. также:: StandardSocketOptions

getOption

<T> T getOption(SocketOption<T> name)
         throws IOException

Возвращает значение параметра сокета.

Параметры типа:: T - Тип значения параметра сокета
Параметры:: name - Параметр сокета
Возвращает:: Значение параметра сокета. Значение null может быть допустимым значением для некоторых параметров сокета.
Исключения:: UnsupportedOperationException - Если параметр сокета не поддерживается этим каналом; ClosedChannelException - Если этот канал закрыт; IOException - Если произошла ошибка ввода/вывода
См. также:: StandardSocketOptions

supportedOptions

Set<SocketOption<?>> supportedOptions()

Возвращает набор параметров сокета, поддерживаемых этим каналом.

Этот метод будет продолжать возвращать набор опций даже после закрытия канала.

Возвращает:: Набор параметров сокета, поддерживаемых этим каналом