net.lecousin.framework.io

Interface IO.Writable.Seekable

All Superinterfaces:

AsyncCloseable<IOException>, AutoCloseable, CloseableListenable, IConcurrentCloseable<IOException>, IO, IO.PositionKnown, IO.Seekable, IO.Writable, IO.WriterAsync

All Known Implementing Classes:

BufferedIO.ReadWrite, ByteArrayIO, FileIO.ReadWrite, FileIO.WriteOnly, FragmentedSubIO.ReadWrite, IOInMemoryOrFile, LinkedIO.ReadWrite, MemoryIO, SubIO.ReadWrite, SubIO.Writable.Seekable

Enclosing interface:

IO.Writable

public static interface IO.Writable.Seekable
extends IO.Writable, IO.Seekable

Add operations to write at a specific position. Important note: operations with a given position must not change the cursor position.

Nested Class Summary

Nested classes/interfaces inherited from interface net.lecousin.framework.io.IO.Writable

IO.Writable.Buffered, IO.Writable.Seekable

Nested classes/interfaces inherited from interface net.lecousin.framework.io.IO.Seekable

IO.Seekable.SeekType

Nested classes/interfaces inherited from interface net.lecousin.framework.io.IO

IO.KnownSize, IO.OperationType, IO.OutputToInput, IO.PositionKnown, IO.Readable, IO.ReadableByteStream, IO.Resizable, IO.Writable, IO.WritableByteStream, IO.WriterAsync

Nested classes/interfaces inherited from interface net.lecousin.framework.util.CloseableListenable

CloseableListenable.Impl

Method Summary

Modifier and Type	Method and Description
default AsyncSupplier<Integer,IOException>	writeAsync(long pos, ByteBuffer buffer) Equivalent to writeAsync(pos, buffer, null).
AsyncSupplier<Integer,IOException>	writeAsync(long pos, ByteBuffer buffer, Consumer<Pair<Integer,IOException>> ondone) Same as IO.Writable.writeAsync(ByteBuffer, Consumer) but at the given position.
int	writeSync(long pos, ByteBuffer buffer) Same as IO.Writable.writeSync(ByteBuffer) but at the given position.

Methods inherited from interface net.lecousin.framework.io.IO.Writable

canStartWriting, writeAsync, writeAsync, writeSync

Methods inherited from interface net.lecousin.framework.io.IO.Seekable

seekAsync, seekAsync, seekSync

Methods inherited from interface net.lecousin.framework.io.IO.PositionKnown

getPosition

Methods inherited from interface net.lecousin.framework.io.IO

cancelClosed, error, errorCancelled, getPriority, getSourceDescription, getTaskManager, getWrappedIO, setPriority

Methods inherited from interface net.lecousin.framework.util.IConcurrentCloseable

lockClose, unlockClose

Methods inherited from interface java.lang.AutoCloseable

close

Methods inherited from interface net.lecousin.framework.util.AsyncCloseable

closeAfter, closeAsync

Methods inherited from interface net.lecousin.framework.util.CloseableListenable

addCloseListener, addCloseListener, close, isClosed, removeCloseListener, removeCloseListener

Method Detail

writeSync

int writeSync(long pos,
              ByteBuffer buffer)
       throws IOException

Same as IO.Writable.writeSync(ByteBuffer) but at the given position. Note that if the IO implements Resizable, the behaviour is different when writing at the end or beyond the end of the IO: if not resizable, it must throw an exception, while a resizable IO should accept it except if the resize operation fails.

Throws:

IOException

writeAsync

AsyncSupplier<Integer,IOException> writeAsync(long pos,
                                              ByteBuffer buffer,
                                              Consumer<Pair<Integer,IOException>> ondone)

Same as IO.Writable.writeAsync(ByteBuffer, Consumer) but at the given position. Note that if the IO implements Resizable, the behaviour is different when writing at the end or beyond the end of the IO: if not resizable, it must throw an exception, while a resizable IO should accept it except if the resize operation fails.

writeAsync

default AsyncSupplier<Integer,IOException> writeAsync(long pos,
                                                      ByteBuffer buffer)

Equivalent to writeAsync(pos, buffer, null). Note that if the IO implements Resizable, the behaviour is different when writing at the end or beyond the end of the IO: if not resizable, it must throw an exception, while a resizable IO should accept it except if the resize operation fails.