- All Superinterfaces:
- AbstractReadHandle, AbstractWriteHandle
- All Known Subinterfaces:
- BufferableContentHandle<C,R>, ResendableContentHandle<C,R>, StreamingContentHandle<C,R>
- All Known Implementing Classes:
- BytesHandle, DocumentMetadataHandle, DOM4JHandle, DOMHandle, FileHandle, GSONHandle, InputSourceHandle, InputStreamHandle, JacksonDatabindHandle, JacksonHandle, JacksonParserHandle, JAXBHandle, JDOMHandle, ReaderHandle, SourceHandle, StringHandle, XMLEventReaderHandle, XMLStreamReaderHandle
public interface BufferableHandle
extends AbstractWriteHandle, AbstractReadHandle
A Bufferable Handle can read content from a byte[] buffer or write content
as a byte[] buffer without changing the state of an external resource.
Handles that modify an external resource, such as FileHandle, cannot
implement BufferableHandle.
For JSON, text, or XML content, the byte array must be encoded in UTF-8.
Where possible, the handle uses the byte array directly as a backing store.
Otherwise, the handle makes a copy into its own store from the byte array.