class BufferedPseudoFile

Buffered pseudo-file.

This variant is optimized for incrementally reading and writing properties which are larger than

can typically be read or written by the client in a single I/O transaction.

In read mode, the pseudo-file invokes its read handler when the file is opened and retains the

content in an output buffer which the client incrementally reads from and can seek within.

In write mode, the client incrementally writes into and seeks within an input buffer which the

pseudo-file delivers as a whole to the write handler when the file is closed. Truncation is also

supported.

Each client has its own separate output and input buffers. Writing into the output buffer does

not affect the contents of the client's input buffer or that of any other client. Changes to the

underlying state of the pseudo-file are not observed by the client until it closes and re-opens

the file.

This class is thread-safe.