Interface BufferableHandle

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 BufferableHandleextends 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.