org.jdom2.output

类 StAXStreamReader

java.lang.Object

org.jdom2.output.StAXStreamReader

所有已实现的接口:

java.lang.Cloneable

public final class StAXStreamReader
extends java.lang.Object
implements java.lang.Cloneable

Represents a JDOM document as a StAX XMLStreamReader that can be read from.

The StAXStreamReader can manage many styles of document formatting, from untouched to 'pretty' printed. The default is to output the document content exactly as created, but this can be changed by setting a new Format object:

• For pretty-print output, use Format.getPrettyFormat().
• For whitespace-normalised output, use Format.getCompactFormat().
• For unmodified-format output, use Format.getRawFormat().

There is only one output(Document) method that exposes a JDOM Document as a StAX Stream.

If changing the Format settings are insufficient for your output needs you can customise this StAXStreamReader further by setting a different StAXStreamReaderProcessor with the setStAXAsStreamProcessor(StAXStreamReaderProcessor) method or an appropriate constructor. A fully-enabled Abstract class AbstractStAXStreamReaderProcessor is available to be further extended to your needs if all you want to do is tweak some details.

从以下版本开始:

JDOM 2.1.0

作者:

Rolf Lear

构造器概要

构造器

构造器和说明
StAXStreamReader() This will create an XMLOutputter with a default Format and StAXStreamReaderProcessor.
StAXStreamReader(Format format) This will create an XMLOutputter with the specified format characteristics.
StAXStreamReader(Format format, StAXStreamReaderProcessor processor) This will create an XMLOutputter with the specified format characteristics.
StAXStreamReader(StAXStreamReader that) This will create an XMLOutputter with the same customisations set in the given XMLOutputter instance.
StAXStreamReader(StAXStreamReaderProcessor processor) This will create an XMLOutputter with the specified XMLOutputProcessor.

方法概要

限定符和类型	方法和说明
StAXStreamReader	clone() Returns a cloned copy of this XMLOutputter.
Format	getFormat() Returns the current format in use by the XMLOutputter.
StAXStreamReaderProcessor	getStAXAsStreamProcessor() Returns the current XMLOutputProcessor instance in use by the StAXStreamReader.
javax.xml.stream.XMLStreamReader	output(Document doc) This will expose the Document as a StAX XMLStreamReader.
void	setFormat(Format newFormat) Sets the new format logic for the XMLOutputter.
void	setStAXAsStreamProcessor(StAXStreamReaderProcessor processor) Sets a new StAXStreamReaderProcessor instance for this StAXStreamReader.
java.lang.String	toString() Return a string listing of the settings for this XMLOutputter instance.

从类继承的方法 java.lang.Object

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

构造器详细资料

StAXStreamReader

public StAXStreamReader(Format format,
                        StAXStreamReaderProcessor processor)

This will create an XMLOutputter with the specified format characteristics.

Note: the format object is cloned internally before use. If you want to modify the Format after constructing the XMLOutputter you can modify the Format instance getFormat() returns.

参数:

format - The Format instance to use. This instance will be cloned() and as a consequence, changes made to the specified format instance will not be reflected in this XMLOutputter. A null input format indicates that XMLOutputter should use the default Format.getRawFormat()

processor - The XMLOutputProcessor to delegate output to. If null the XMLOutputter will use the default XMLOutputProcessor.

StAXStreamReader

public StAXStreamReader()

This will create an XMLOutputter with a default Format and StAXStreamReaderProcessor.

StAXStreamReader

public StAXStreamReader(StAXStreamReader that)

This will create an XMLOutputter with the same customisations set in the given XMLOutputter instance. Note that XMLOutputter two = one.clone(); would work equally well.

参数:

that - the XMLOutputter to clone

StAXStreamReader

public StAXStreamReader(Format format)

This will create an XMLOutputter with the specified format characteristics.

Note: the format object is cloned internally before use.

参数:

format - The Format instance to use. This instance will be cloned() and as a consequence, changes made to the specified format instance will not be reflected in this XMLOutputter. A null input format indicates that XMLOutputter should use the default Format.getRawFormat()

StAXStreamReader

public StAXStreamReader(StAXStreamReaderProcessor processor)

This will create an XMLOutputter with the specified XMLOutputProcessor.

参数:

processor - The XMLOutputProcessor to delegate output to. If null the XMLOutputter will use the default XMLOutputProcessor.

方法详细资料

setFormat

public void setFormat(Format newFormat)

Sets the new format logic for the XMLOutputter. Note the Format object is cloned internally before use.

参数:

newFormat - the format to use for subsequent output

另请参阅:

getFormat()

getFormat

public Format getFormat()

Returns the current format in use by the XMLOutputter. Note the Format object returned is not a clone of the one used internally, thus, an XMLOutputter instance is able to have it's Format changed by changing the settings on the Format instance returned by this method.

返回:

the current Format instance used by this XMLOutputter.

getStAXAsStreamProcessor

public StAXStreamReaderProcessor getStAXAsStreamProcessor()

Returns the current XMLOutputProcessor instance in use by the StAXStreamReader.

返回:

the current XMLOutputProcessor instance.

setStAXAsStreamProcessor

public void setStAXAsStreamProcessor(StAXStreamReaderProcessor processor)

Sets a new StAXStreamReaderProcessor instance for this StAXStreamReader. Note the processor object is expected to be thread-safe.

参数:

processor - the new XMLOutputProcesor to use for output

output

public final javax.xml.stream.XMLStreamReader output(Document doc)

This will expose the Document as a StAX XMLStreamReader.

参数:

doc - Document to format.

返回:

The XMLStreamReader representing the input Document.

抛出:

java.lang.NullPointerException - if the specified content is null.

clone

public StAXStreamReader clone()

Returns a cloned copy of this XMLOutputter.

覆盖:

clone 在类中 java.lang.Object

toString

public java.lang.String toString()

Return a string listing of the settings for this XMLOutputter instance.

覆盖:

toString 在类中 java.lang.Object

返回:

a string listing the settings for this XMLOutputter instance