Интерфейс ReadableByteChannel

int read(ByteBuffer dst) throws IOException

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

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

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

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

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