Интерфейс ReadableByteChannel

int read(ByteBuffer dst) throws IOException

Читает последовательность байтов из этого канала в предоставленный буфер.

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

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

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

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