Package com.marklogic.client.extra.jdom

Class JDOMHandle

java.lang.Object

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

com.marklogic.client.io.BaseHandle<java.io.InputStream,OutputStreamSender>

com.marklogic.client.extra.jdom.JDOMHandle

All Implemented Interfaces:

ContentDescriptor, AbstractReadHandle, AbstractWriteHandle, BufferableHandle, ContentHandle<org.jdom2.Document>, DocumentMetadataReadHandle, DocumentMetadataWriteHandle, DocumentPatchHandle, QueryOptionsListReadHandle, QueryOptionsReadHandle, QueryOptionsWriteHandle, RuleListReadHandle, RuleReadHandle, RuleWriteHandle, SearchReadHandle, SPARQLResultsReadHandle, StructureReadHandle, StructureWriteHandle, TriplesReadHandle, TriplesWriteHandle, TuplesReadHandle, ValuesListReadHandle, ValuesReadHandle, XMLReadHandle, XMLWriteHandle, OutputStreamSender

public class JDOMHandle
extends BaseHandle<java.io.InputStream,OutputStreamSender>
implements OutputStreamSender, BufferableHandle, ContentHandle<org.jdom2.Document>, XMLReadHandle, XMLWriteHandle, StructureReadHandle, StructureWriteHandle

A JDOM Handle represents XML content as a JDOM document for reading or writing. You must install the JDOM library to use this class.

Field Summary

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

UNKNOWN_LENGTH

Constructor Summary

Constructors

Constructor	Description
JDOMHandle()	Zero-argument constructor.
JDOMHandle(org.jdom2.Document content)	Provides a handle on XML content as a JDOM document structure.

Method Summary

Modifier and Type	Method	Description
void	fromBuffer(byte[] buffer)	Sets the content of the handle by copying from a byte array buffer encoded in UTF-8.
org.jdom2.Document	get()	Returns the XML document structure.
org.jdom2.input.SAXBuilder	getBuilder()	Returns the JDOM structure builder for XML content.
org.jdom2.output.XMLOutputter	getOutputter()	Returns the JDOM serializer for XML content.
protected org.jdom2.input.SAXBuilder	makeBuilder()
protected org.jdom2.output.XMLOutputter	makeOutputter()
static ContentHandleFactory	newFactory()	Creates a factory to create a JDOMHandle instance for a JDOM document.
protected java.lang.Class<java.io.InputStream>	receiveAs()
protected void	receiveContent(java.io.InputStream content)
protected OutputStreamSender	sendContent()
void	set(org.jdom2.Document content)	Assigns an XML document structure as the content.
void	setBuilder(org.jdom2.input.SAXBuilder builder)	Specifies a JDOM structure builder for XML content.
void	setFormat(Format format)	Restricts the format to XML.
void	setOutputter(org.jdom2.output.XMLOutputter outputter)	Specifies a JDOM serializer for XML content.
byte[]	toBuffer()	Copies the content of the handle to a byte array buffer encoded in UTF-8.
java.lang.String	toString()	Returns the XML document as a string.
JDOMHandle	with(org.jdom2.Document content)	Assigns an XML document structure as the content and returns the handle.
void	write(java.io.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, getServerTimestamp, setByteLength, setMimetype, setServerTimestamp

Methods inherited from interface com.marklogic.client.io.marker.ContentHandle

getContentClass

Methods inherited from class com.marklogic.client.impl.HandleImplementation

getPointInTimeQueryTimestamp, isResendable, setPointInTimeQueryTimestamp, setResendable, setResponseServerTimestamp

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

JDOMHandle

public JDOMHandle()

Zero-argument constructor.

JDOMHandle

public JDOMHandle(org.jdom2.Document content)

Provides a handle on XML content as a JDOM document structure.

Parameters:

content - the XML document.

Method Detail

newFactory

public static ContentHandleFactory newFactory()

Creates a factory to create a JDOMHandle instance for a JDOM document.

Returns:

the factory

getBuilder

public org.jdom2.input.SAXBuilder getBuilder()

Returns the JDOM structure builder for XML content.

Returns:

the JDOM builder.

setBuilder

public void setBuilder(org.jdom2.input.SAXBuilder builder)

Specifies a JDOM structure builder for XML content.

Parameters:

builder - the JDOM builder.

makeBuilder

protected org.jdom2.input.SAXBuilder makeBuilder()

getOutputter

public org.jdom2.output.XMLOutputter getOutputter()

Returns the JDOM serializer for XML content.

Returns:

the JDOM serializer.

setOutputter

public void setOutputter(org.jdom2.output.XMLOutputter outputter)

Specifies a JDOM serializer for XML content.

Parameters:

outputter - the JDOM serializer.

makeOutputter

protected org.jdom2.output.XMLOutputter makeOutputter()

get

public org.jdom2.Document get()

Returns the XML document structure.

Specified by:

get in interface ContentHandle<org.jdom2.Document>

Returns:

the XML document.

set

public void set(org.jdom2.Document content)

Assigns an XML document structure as the content.

Specified by:

set in interface ContentHandle<org.jdom2.Document>

Parameters:

content - the XML document.

with

public JDOMHandle with(org.jdom2.Document content)

Assigns an XML document structure as the content and returns the handle.

Parameters:

content - the XML document.

Returns:

the handle on the XML document.

setFormat

public void setFormat(Format format)

Restricts the format to XML.

Specified by:

setFormat in interface ContentDescriptor

Overrides:

setFormat in class BaseHandle<java.io.InputStream,OutputStreamSender>

Parameters:

format - the format of the content

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 java.lang.String toString()

Returns the XML document as a string.

Overrides:

toString in class java.lang.Object

receiveAs

protected java.lang.Class<java.io.InputStream> receiveAs()

Overrides:

receiveAs in class com.marklogic.client.impl.HandleImplementation<java.io.InputStream,OutputStreamSender>

receiveContent

protected void receiveContent(java.io.InputStream content)

Overrides:

receiveContent in class com.marklogic.client.impl.HandleImplementation<java.io.InputStream,OutputStreamSender>

sendContent

protected OutputStreamSender sendContent()

Overrides:

sendContent in class com.marklogic.client.impl.HandleImplementation<java.io.InputStream,OutputStreamSender>

write

public void write(java.io.OutputStream out)
           throws java.io.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:

java.io.IOException - if io problems arise