com.marklogic.client.io

Class StringHandle

java.lang.Object

com.marklogic.client.impl.HandleImplementation<R,W>

com.marklogic.client.io.BaseHandle<byte[],OutputStreamSender>

com.marklogic.client.io.StringHandle

All Implemented Interfaces:

ContentDescriptor, AbstractReadHandle, AbstractWriteHandle, BufferableHandle, ContentHandle<String>, DocumentMetadataReadHandle, DocumentMetadataWriteHandle, DocumentPatchHandle, JSONReadHandle, JSONWriteHandle, QueryOptionsListReadHandle, QueryOptionsReadHandle, QueryOptionsWriteHandle, RuleListReadHandle, RuleReadHandle, RuleWriteHandle, SearchReadHandle, StructureReadHandle, StructureWriteHandle, TextReadHandle, TextWriteHandle, TuplesReadHandle, ValuesListReadHandle, ValuesReadHandle, XMLReadHandle, XMLWriteHandle, OutputStreamSender

public class StringHandle
extends BaseHandle<byte[],OutputStreamSender>
implements OutputStreamSender, BufferableHandle, ContentHandle<String>, JSONReadHandle, JSONWriteHandle, TextReadHandle, TextWriteHandle, XMLReadHandle, XMLWriteHandle, StructureReadHandle, StructureWriteHandle

A String Handle represents document content as a string for reading or writing.

Field Summary

Fields inherited from interface com.marklogic.client.document.ContentDescriptor

UNKNOWN_LENGTH

Constructor Summary

Constructors

Constructor and Description
StringHandle() Zero-argument constructor.
StringHandle(String content) Initializes the handle with a string for the content.

Method Summary

Methods

Modifier and Type	Method and Description
void	fromBuffer(byte[] buffer) Sets the content of the handle by copying from a byte array buffer encoded in UTF-8.
String	get() Returns the string for the content.
static ContentHandleFactory	newFactory() Creates a factory to create a StringHandle instance for a string.
void	set(String content) Assigns an string as the content.
byte[]	toBuffer() Copies the content of the handle to a byte array buffer encoded in UTF-8.
String	toString() Returns the content.
StringHandle	with(String content) Assigns a string as the content and returns the handle as a fluent convenience.
StringHandle	withFormat(Format format) Specifies the format of the content and returns the handle as a fluent convenience.
StringHandle	withMimetype(String mimetype) Specifies the mime type of the content and returns the handle as a fluent convenience.
void	write(OutputStream out) Implements a callback to write content to the provided output stream for sending to the database server.

Methods inherited from class com.marklogic.client.io.BaseHandle

getByteLength, getFormat, getMimetype, setByteLength, setFormat, setMimetype

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

StringHandle

public StringHandle()

Zero-argument constructor.

StringHandle

public StringHandle(String content)

Initializes the handle with a string for the content.

Parameters:

content - a content string

Method Detail

newFactory

public static ContentHandleFactory newFactory()

Creates a factory to create a StringHandle instance for a string.

Returns:

the factory

get

public String get()

Returns the string for the content.

Specified by:

get in interface ContentHandle<String>

Returns:

the string

set

public void set(String content)

Assigns an string as the content.

Specified by:

set in interface ContentHandle<String>

Parameters:

content - a string

with

public StringHandle with(String content)

Assigns a string as the content and returns the handle as a fluent convenience.

Parameters:

content - a string

Returns:

this handle

withFormat

public StringHandle withFormat(Format format)

Specifies the format of the content and returns the handle as a fluent convenience.

Parameters:

format - the format of the content

Returns:

this handle

withMimetype

public StringHandle withMimetype(String mimetype)

Specifies the mime type of the content and returns the handle as a fluent convenience.

Parameters:

mimetype - the mime type of the content

Returns:

this handle

fromBuffer

public void fromBuffer(byte[] buffer)

Description copied from interface: BufferableHandle

Sets the content of the handle by copying from a byte array buffer encoded in UTF-8.

Specified by:

fromBuffer in interface BufferableHandle

Parameters:

buffer - the byte array

toBuffer

public byte[] toBuffer()

Description copied from interface: BufferableHandle

Copies the content of the handle to a byte array buffer encoded in UTF-8.

Specified by:

toBuffer in interface BufferableHandle

Returns:

the byte array

toString

public String toString()

Returns the content.

Overrides:

toString in class Object

write

public void write(OutputStream out)
           throws IOException

Description copied from interface: OutputStreamSender

Implements a callback to write content to the provided output stream for sending to the database server.

Specified by:

write in interface OutputStreamSender

Parameters:

out - the output stream receiving the content

Throws:

IOException