Класс SocketChannel

Новый канал создается путем вызова метода openSocketChannel системного глобального объекта по умолчанию SelectorProvider.

Новый канал создается путем вызова метода openSocketChannel(ProtocolFamily) системного глобального объекта по умолчанию. SelectorProvider объекта.

Если удаленный адрес является InetSocketAddress, то этот метод работает так, как если бы был вызван метод open(), вызвав метод connect для полученного сокет-канала, передав remote, и затем вернув этот канал.

Если удаленный адрес является UnixDomainSocketAddress, то это делается путем вызова метода open(ProtocolFamily) с параметром StandardProtocolFamily.UNIX, вызова метода connect для полученного сокет-канала, передав remote, а затем вернув этот канал.

Сокет-каналы поддерживают подключение, чтение и запись, поэтому этот метод возвращает (SelectionKey.OP_CONNECT | SelectionKey.OP_READ | SelectionKey.OP_WRITE).

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

После отключения для чтения дальнейшие чтения по каналу вернут -1, указатель конца потока. Если сторона ввода соединения уже отключена, вызов этого метода не окажет никакого эффекта.

После отключения для записи дальнейшие попытки записи в канал вызовут ClosedChannelException. Если сторона вывода соединения уже отключена, вызов этого метода не окажет никакого эффекта.

Если этот канал находится в режиме без блокировки, то вызов этого метода инициирует операцию подключения без блокировки. Если подключение установлено немедленно, как может произойти с локальным подключением, то этот метод возвращает true. В противном случае этот метод возвращает false и операция подключения должна быть завершена позже вызовом метода finishConnect.

Если этот канал находится в режиме блокировки, то вызов этого метода будет блокировать выполнение, пока подключение не будет установлено или не произойдет ошибка ввода-вывода.

Для каналов к сокетам протокола Интернета этот метод выполняет точно такие же проверки безопасности, как и класс Socket. То есть, если установлено средство управления безопасностью, этот метод проверяет, что метод checkConnect разрешает подключение к адресу и номеру порта указанного удаленного узла.

Для каналов к сокетам доменной области Unix этот метод проверяет NetPermission ("accessUnixDomainSocket") с помощью метода checkPermission средства управления безопасностью.

Этот метод можно вызывать в любое время. Если операция чтения или записи на этом канале вызывается во время выполнения вызова этого метода, то эта операция сначала будет блокироваться до завершения этого вызова. Если попытка подключения не удалась, то есть если вызов этого метода вызывает проверенное исключение, то канал будет закрыт.

Операция подключения без блокировки инициируется путем перевода сокета канала в режим без блокировки, а затем вызовом его метода connect. После того как подключение установлено или попытка завершилась неудачей, сокет канала станет подключаемым, и этот метод может быть вызван для завершения последовательности подключения. Если операция подключения завершилась неудачей, то вызов этого метода приведет к соответствующему выбрасыванию исключения IOException.

Если этот канал уже подключен, то этот метод не будет блокировать выполнение и сразу вернет true. Если этот канал находится в режиме без блокировки, то этот метод вернет false если процесс подключения еще не завершен. Если этот канал находится в режиме блокировки, то этот метод будет блокировать выполнение до тех пор, пока подключение не будет завершено или не завершится с ошибкой, и всегда вернет true или выбросит проверенное исключение, описывающее ошибку.

Этот метод можно вызывать в любое время. Если операция чтения или записи на этом канале вызывается во время выполнения вызова этого метода, то эта операция сначала будет блокироваться до завершения этого вызова. Если попытка подключения завершается неудачей, то есть если вызов этого метода выбрасывает проверенное исключение, то канал будет закрыт.

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

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

Производится попытка прочитать до r байтов из канала, где r - количество байтов, оставшихся в буфере, то есть, dst.remaining(), в момент вызова этого метода.

Предположим, что прочитана последовательность байтов длиной n, где 0 <= n <= r. Эта последовательность байтов будет перенесена в буфер таким образом, что первый байт в последовательности находится по индексу p, а последний байт - по индексу p + n - 1, где p - позиция буфера в момент вызова этого метода. После возвращения позиция буфера будет равна p + n; его предел не изменится.

Операция чтения может не заполнить буфер, и фактически может вообще не прочитать никаких байтов. Это зависит от характера и состояния канала. Например, сокетный канал в режиме без блокировки не может прочитать больше байтов, чем немедленно доступны из входного буфера сокета; аналогично, файловый канал не может прочитать больше байтов, чем остается в файле. Однако гарантируется, что если канал находится в режиме блокировки и в буфере остается как минимум один байт, этот метод будет блокировать выполнение, пока не будет прочитан как минимум один байт.

Этот метод можно вызывать в любое время. Однако, если другой поток уже инициировал операцию чтения на этом канале, то вызов этого метода будет блокировать выполнение до завершения первой операции.

Вызов этого метода пытается прочитать до r байтов из этого канала, где r — общее количество байтов, оставшихся в указанной подпоследовательности массива буферов, то есть,

    dsts[offset].remaining()
        + dsts[offset+1].remaining()
        + ... + dsts[offset+length-1].remaining()

Предположим, что прочитана последовательность байтов длиной n, где 0 <= n <= r. До первых dsts[offset].remaining() байтов этой последовательности передаются в буфер dsts[offset], до следующих dsts[offset+1].remaining() байтов — в буфер dsts[offset+1], и так далее, пока вся последовательность байтов не будет передана в заданные буферы. Максимальное количество байтов передаётся в каждый буфер, поэтому конечная позиция каждого обновлённого буфера, кроме последнего, гарантированно равна пределу этого буфера.

Этот метод может быть вызван в любое время. Однако, если другой поток уже инициировал операцию чтения в этом канале, вызов этого метода будет блокироваться до завершения первой операции.

Вызов этого метода в форме c.read(dsts) ведет себя точно так же, как вызов

    c.read(dsts, 0, dsts.length);

Пытается записать до r байтов в канал, где r — количество байтов, оставшихся в буфере, то есть, src.remaining(), в момент вызова этого метода.

Предположим, что записана последовательность байтов длиной n, где 0 <= n <= r. Эта последовательность байтов будет передана из буфера, начиная с индекса p, где p — позиция буфера в момент вызова этого метода; индекс последнего записанного байта будет p + n - 1. После возврата позиция буфера будет равна p + n; его предел не изменится.

Если не указано иное, операция записи вернётся только после записи всех r запрошенных байтов. Некоторые типы каналов, в зависимости от их состояния, могут записать только некоторые байты или, возможно, вообще ни одного. Например, сокет-канал в режиме без блокировки не может записать больше байтов, чем свободны в буфере вывода сокета.

Этот метод может быть вызван в любое время. Однако, если другой поток уже инициировал операцию записи в этот канал, вызов этого метода будет блокироваться до завершения первой операции.

Пытается записать до r байтов в этот канал, где r — общее количество байтов, оставшихся в указанной подпоследовательности массива буферов, то есть,

    srcs[offset].remaining()
        + srcs[offset+1].remaining()
        + ... + srcs[offset+length-1].remaining()

Предположим, что записана последовательность байтов длиной n, где 0 <= n <= r. До первых srcs[offset].remaining() байтов этой последовательности записываются из буфера srcs[offset], до следующих srcs[offset+1].remaining() байтов — из буфера srcs[offset+1], и так далее, пока вся последовательность байтов не будет записана. Максимальное количество байтов записывается из каждого буфера, поэтому конечная позиция каждого обновлённого буфера, кроме последнего, гарантированно равна пределу этого буфера.

Если не указано иное, операция записи вернётся только после записи всех r запрошенных байтов. Некоторые типы каналов, в зависимости от их состояния, могут записать только некоторые байты или, возможно, вообще ни одного. Например, сокет-канал в режиме без блокировки не может записать больше байтов, чем свободны в буфере вывода сокета.

Этот метод может быть вызван в любое время. Однако, если другой поток уже инициировал операцию записи в этот канал, вызов этого метода будет блокироваться до завершения первой операции.

Вызов этого метода в форме c.write(srcs) ведет себя точно так же, как вызов

    c.write(srcs, 0, srcs.length);

Если канал bound к адресу сокета Интернет-протокола, то возвращаемое значение этого метода имеет тип InetSocketAddress. Если установлен менеджер безопасности, его метод checkConnect вызывается с локальным адресом и -1 в качестве аргументов, чтобы проверить, разрешена ли операция. Если операция не разрешена, возвращается SocketAddress , представляющий loopback адрес и локальный порт сокета канала.

Если канал привязан к адресу сокета Unix-домена, адрес сокета является UnixDomainSocketAddress. Если установлен менеджер безопасности, вызывается его метод checkPermission с NetPermission ("accessUnixDomainSocket"). Если операция не разрешена, возвращается безымянный UnixDomainSocketAddress.