ContentDescriptor, AbstractReadHandle, AbstractWriteHandle, BinaryReadHandle, BinaryWriteHandle, BufferableHandle, ContentHandle<java.io.InputStream>, CtsQueryWriteHandle, DocumentMetadataReadHandle, DocumentMetadataWriteHandle, DocumentPatchHandle, GenericReadHandle, GenericWriteHandle, JSONReadHandle, JSONWriteHandle, QuadsWriteHandle, QueryOptionsListReadHandle, QueryOptionsReadHandle, QueryOptionsWriteHandle, RuleListReadHandle, RuleReadHandle, RuleWriteHandle, SearchReadHandle, SPARQLResultsReadHandle, StructureReadHandle, StructureWriteHandle, TextReadHandle, TextWriteHandle, TriplesReadHandle, TriplesWriteHandle, TuplesReadHandle, ValuesListReadHandle, ValuesReadHandle, XMLReadHandle, XMLWriteHandle, java.io.Closeable, java.lang.AutoCloseablepublic class InputStreamHandle extends BaseHandle<java.io.InputStream,java.io.InputStream> implements BufferableHandle, ContentHandle<java.io.InputStream>, BinaryReadHandle, BinaryWriteHandle, GenericReadHandle, GenericWriteHandle, JSONReadHandle, JSONWriteHandle, TextReadHandle, TextWriteHandle, XMLReadHandle, XMLWriteHandle, StructureReadHandle, StructureWriteHandle, CtsQueryWriteHandle, TriplesReadHandle, TriplesWriteHandle, QuadsWriteHandle, SPARQLResultsReadHandle, java.io.Closeable
An InputStreamHandle represents a resource as an InputStream for reading or writing.
When writing JSON, text, or XML content, you should use an InputStream only
if the stream is encoded in UTF-8. If the characters have a different encoding, use
a ReaderHandle and specify the correct character encoding for the stream when
creating the Reader.
Either call close() or get().close() when finished with this handle
to release the resources.
UNKNOWN_LENGTH| Constructor | Description |
|---|---|
InputStreamHandle() |
Zero-argument constructor.
|
InputStreamHandle(java.io.InputStream content) |
Initializes the handle with an input stream for the content.
|
| Modifier and Type | Method | Description |
|---|---|---|
void |
close() |
Either call close() or get().close() when finished with this handle to close the underlying InputStream.
|
void |
fromBuffer(byte[] buffer) |
Sets the content of the handle by copying from a byte array buffer
encoded in UTF-8.
|
java.io.InputStream |
get() |
Returns an input stream for a resource read from the database.
|
static ContentHandleFactory |
newFactory() |
Creates a factory to create an InputStreamHandle instance for an input stream.
|
protected java.lang.Class<java.io.InputStream> |
receiveAs() |
|
protected void |
receiveContent(java.io.InputStream content) |
|
protected java.io.InputStream |
sendContent() |
|
void |
set(java.io.InputStream content) |
Assigns an input stream as the content.
|
byte[] |
toBuffer() |
Copies the content of the handle to a byte array buffer
encoded in UTF-8.
|
java.lang.String |
toString() |
Buffers the input stream and returns the buffer as a string
with the assumption that the stream is encoded in UTF-8.
|
InputStreamHandle |
with(java.io.InputStream content) |
Assigns an input stream as the content and returns the handle
as a fluent convenience.
|
InputStreamHandle |
withFormat(Format format) |
Specifies the format of the content and returns the handle
as a fluent convenience.
|
InputStreamHandle |
withMimetype(java.lang.String mimetype) |
Specifies the mime type of the content and returns the handle
as a fluent convenience.
|
getByteLength, getFormat, getMimetype, getServerTimestamp, setByteLength, setFormat, setMimetype, setServerTimestamppublic InputStreamHandle()
public InputStreamHandle(java.io.InputStream content)
content - an input streampublic static ContentHandleFactory newFactory()
public java.io.InputStream get()
get in interface ContentHandle<java.io.InputStream>public void set(java.io.InputStream content)
set in interface ContentHandle<java.io.InputStream>content - an input streampublic InputStreamHandle with(java.io.InputStream content)
content - an input streampublic InputStreamHandle withFormat(Format format)
format - the format of the contentpublic InputStreamHandle withMimetype(java.lang.String mimetype)
mimetype - the mime type of the contentpublic void fromBuffer(byte[] buffer)
BufferableHandlefromBuffer in interface BufferableHandlebuffer - the byte arraypublic byte[] toBuffer()
BufferableHandletoBuffer in interface BufferableHandlepublic java.lang.String toString()
toString in class java.lang.Objectprotected java.lang.Class<java.io.InputStream> receiveAs()
receiveAs in class com.marklogic.client.impl.HandleImplementation<java.io.InputStream,java.io.InputStream>protected void receiveContent(java.io.InputStream content)
receiveContent in class com.marklogic.client.impl.HandleImplementation<java.io.InputStream,java.io.InputStream>protected java.io.InputStream sendContent()
sendContent in class com.marklogic.client.impl.HandleImplementation<java.io.InputStream,java.io.InputStream>public void close()
close in interface java.lang.AutoCloseableclose in interface java.io.CloseableCopyright © 2013-2019 MarkLogic Corporation.