|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.cdmckay.coffeedom.output.Format
public class Format
Class to encapsulate XMLOutputter format options. Typical users can use the standard format configurations obtained
by getRawFormat()
(no whitespace changes), getPrettyFormat()
(whitespace beautification), and getCompactFormat()
(whitespace normalization).
Format.TextMode
for details.
Nested Class Summary | |
---|---|
static class |
Format.TextMode
Class to signify how text should be handled on output. |
Method Summary | |
---|---|
protected Format |
clone()
|
static Format |
getCompactFormat()
Returns a new Format object that performs whitespace normalization, uses the UTF-8 encoding, doesn't expand empty elements, includes the declaration and encoding, and uses the default entity escape strategy. |
String |
getEncoding()
Returns the configured output encoding. |
EscapeStrategy |
getEscapeStrategy()
Returns the current escape strategy |
boolean |
getExpandEmptyElements()
Returns whether empty elements are expanded. |
boolean |
getIgnoreTrAXEscapingPIs()
Returns whether JAXP TrAX processing instructions for disabling/enabling output escaping are ignored. |
String |
getIndent()
Returns the indent string in use. |
String |
getLineSeparator()
Returns the current line separator. |
boolean |
getOmitDeclaration()
Returns whether the XML declaration will be omitted. |
boolean |
getOmitEncoding()
Returns whether the XML declaration encoding will be omitted. |
static Format |
getPrettyFormat()
Returns a new Format object that performs whitespace beautification with 2-space indents, uses the UTF-8 encoding, doesn't expand empty elements, includes the declaration and encoding, and uses the default entity escape strategy. |
static Format |
getRawFormat()
Returns a new Format object that performs no whitespace changes, uses the UTF-8 encoding, doesn't expand empty elements, includes the declaration and encoding, and uses the default entity escape strategy. |
Format.TextMode |
getTextMode()
Returns the current text output style. |
Format |
setEncoding(String encoding)
Sets the output encoding. |
Format |
setEscapeStrategy(EscapeStrategy strategy)
Sets the EscapeStrategy to use for character escaping. |
Format |
setExpandEmptyElements(boolean expandEmptyElements)
This will set whether empty elements are expanded from <tagName/> to
<tagName></tagName> . |
void |
setIgnoreTrAXEscapingPIs(boolean ignoreTrAXEscapingPIs)
This will set whether JAXP TrAX processing instructions for disabling/enabling output escaping are ignored. |
Format |
setIndent(String indent)
This will set the indent String to use; this is usually a String of empty spaces. |
Format |
setLineSeparator(String separator)
This will set the newline separator ( lineSeparator ). |
Format |
setOmitDeclaration(boolean omitDeclaration)
This will set whether the XML declaration ( <?xml version="1.0"?gt; ) will be
omitted or not. |
Format |
setOmitEncoding(boolean omitEncoding)
This will set whether the XML declaration ( <?xml version="1.0"
encoding="UTF-8"?> ) includes the encoding of the document. |
Format |
setTextMode(Format.TextMode mode)
This sets the text output style. |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static Format getRawFormat()
public static Format getPrettyFormat()
public static Format getCompactFormat()
public Format setEscapeStrategy(EscapeStrategy strategy)
EscapeStrategy
to use for character escaping.
strategy
- the EscapeStrategy to use
public EscapeStrategy getEscapeStrategy()
public Format setLineSeparator(String separator)
lineSeparator
). The default is \r\n
. To make it
output the system default line ending string, call setLineSeparator(System.getProperty("line.separator"))
.
To output "UNIX-style" documents, call setLineSeparator("\n")
. To output "Mac-style"
documents, call setLineSeparator("\r")
. DOS-style documents use CR-LF ("\r\n"), which is the
default.
Note that this only applies to newlines generated by the outputter. If you parse an XML document that contains newlines embedded inside a text node, and you do not set TextMode.NORMALIZE, then the newlines will be output verbatim, as "\n" which is how parsers normalize them.
If the format's "indent" property is null (as is the default for the Raw and Compact formats), then this value only effects the newlines written after the declaration and doctype.
separator
- String
line separator to use.
setTextMode(org.cdmckay.coffeedom.output.Format.TextMode)
public String getLineSeparator()
public Format setOmitEncoding(boolean omitEncoding)
<?xml version="1.0"
encoding="UTF-8"?>
) includes the encoding of the document. It is common to omit this in uses such
as WML and other wireless device protocols.
omitEncoding
- boolean
indicating whether or not the XML declaration should indicate the
document encoding.
public boolean getOmitEncoding()
public Format setOmitDeclaration(boolean omitDeclaration)
<?xml version="1.0"?gt;
) will be
omitted or not. It is common to omit this in uses such as SOAP and XML-RPC calls.
omitDeclaration
- boolean
indicating whether or not the XML declaration should be omitted.
public boolean getOmitDeclaration()
public Format setExpandEmptyElements(boolean expandEmptyElements)
<tagName/>
to
<tagName></tagName>
.
expandEmptyElements
- boolean
indicating whether or not empty elements should be expanded.
public boolean getExpandEmptyElements()
public void setIgnoreTrAXEscapingPIs(boolean ignoreTrAXEscapingPIs)
When processed, these processing instructions are removed from the generated XML
text and control whether the element text content is output verbatim or with escaping of the pre-defined entities
in XML 1.0. The text to be output verbatim shall be surrounded by the <?javax.xml.transform.disable-output-escaping
?>
and <?javax.xml.transform.enable-output-escaping ?>
PIs.
When ignored, the processing instructions are present in the generated XML text and the pre-defined entities in XML 1.0 are escaped.
Default: false
.
ignoreTrAXEscapingPIs
- boolean
indicating whether or not TrAX ouput escaping PIs are ignored.Result.PI_ENABLE_OUTPUT_ESCAPING
,
Result.PI_DISABLE_OUTPUT_ESCAPING
public boolean getIgnoreTrAXEscapingPIs()
public Format setTextMode(Format.TextMode mode)
Format.TextMode
instances. The default is
Format.TextMode.PRESERVE
.
mode
-
public Format.TextMode getTextMode()
public Format setIndent(String indent)
String
to use; this is usually a String
of empty spaces. If
you pass the empty string (""), then no indentation will happen but newlines will still be generated. Passing
null will result in no indentation and no newlines generated. Default: none (null)
indent
- String
to use for indentation.
public String getIndent()
public Format setEncoding(String encoding)
encoding
- the encoding format. Use XML-style names like "UTF-8" or "ISO-8859-1" or "US-ASCII"
public String getEncoding()
protected Format clone()
clone
in class Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |