org.restlet.client.ext.xml

Class DomRepresentation

java.lang.Object

org.restlet.client.representation.Variant

org.restlet.client.representation.RepresentationInfo

org.restlet.client.representation.Representation

org.restlet.client.ext.xml.DomRepresentation

public class DomRepresentation
extends Representation

XML representation based on an XML DOM document. DOM is a standard XML object model defined by the W3C.

Author:

Jerome Louvel

Field Summary

Fields inherited from class org.restlet.client.representation.Representation

UNKNOWN_SIZE

Constructor Summary

Constructors

Constructor and Description
DomRepresentation(MediaType mediaType) Constructor for an empty document.
DomRepresentation(MediaType mediaType, com.google.gwt.xml.client.Document xmlDocument) Constructor from an existing DOM document.
DomRepresentation(Representation xmlRepresentation) Constructor.

Method Summary

Modifier and Type	Method and Description
com.google.gwt.xml.client.Document	getDocument() Returns the wrapped DOM document.
java.io.Reader	getReader()
java.io.InputStream	getStream()
java.lang.String	getText()
void	release() Releases the wrapped DOM document and the source XML representation if they have been defined.
void	setDocument(com.google.gwt.xml.client.Document dom) Sets the wrapped DOM document.

Methods inherited from class org.restlet.client.representation.Representation

append, exhaust, getAvailableSize, getDisposition, getExpirationDate, getRange, getSize, hasKnownSize, isAvailable, isEmpty, isTransient, setAvailable, setDisposition, setExpirationDate, setRange, setSize, setTransient

Methods inherited from class org.restlet.client.representation.RepresentationInfo

getModificationDate, getTag, setModificationDate, setTag

Methods inherited from class org.restlet.client.representation.Variant

createClientInfo, equals, getCharacterSet, getEncodings, getLanguages, getLocationRef, getMediaType, hashCode, includes, isCompatible, setCharacterSet, setEncodings, setLanguages, setLocationRef, setLocationRef, setMediaType, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DomRepresentation

public DomRepresentation(MediaType mediaType)

Constructor for an empty document.

Parameters:

mediaType - The representation's media type.

DomRepresentation

public DomRepresentation(MediaType mediaType,
                         com.google.gwt.xml.client.Document xmlDocument)

Constructor from an existing DOM document.

Parameters:

mediaType - The representation's media type.

xmlDocument - The source DOM document.

DomRepresentation

public DomRepresentation(Representation xmlRepresentation)

Constructor.

Parameters:

xmlRepresentation - A source XML representation to parse.

Method Detail

getDocument

public com.google.gwt.xml.client.Document getDocument()
                                               throws java.io.IOException

Returns the wrapped DOM document. If no document is defined yet, it attempts to parse the XML representation eventually given at construction time. Otherwise, it just creates a new document.

Returns:

The wrapped DOM document.

Throws:

java.io.IOException

getReader

public java.io.Reader getReader()
                         throws java.io.IOException

Specified by:

getReader in class Representation

Throws:

java.io.IOException

getStream

public java.io.InputStream getStream()
                              throws java.io.IOException

Specified by:

getStream in class Representation

Throws:

java.io.IOException

getText

public java.lang.String getText()
                         throws java.io.IOException

Specified by:

getText in class Representation

Throws:

java.io.IOException

release

public void release()

Releases the wrapped DOM document and the source XML representation if they have been defined.

Overrides:

release in class Representation

setDocument

public void setDocument(com.google.gwt.xml.client.Document dom)

Sets the wrapped DOM document.

Parameters:

dom - The wrapped DOM document.