Save This Page
Home » dom4j-1.6.1 » org.dom4j.io » [javadoc | source]
org.dom4j.io
public class: OutputFormat [javadoc | source]
java.lang.Object
   org.dom4j.io.OutputFormat

All Implemented Interfaces:
    Cloneable

OutputFormat represents the format configuration used by {@linkXMLWriter}and its base classes to format the XML output

Field Summary
protected static final  String STANDARD_INDENT    standard value to indent by, if we are indenting 
Constructor:
 public OutputFormat() 
 public OutputFormat(String indent) 
    Creates an OutputFormat with the given indent added but no new lines added. All whitespace from element text will be included.
    Parameters:
    indent - is the indent string to be used for indentation (usually a number of spaces).
 public OutputFormat(String indent,
    boolean newlines) 
    Creates an OutputFormat with the given indent added with optional newlines between the Elements. All whitespace from element text will be included.
    Parameters:
    indent - is the indent string to be used for indentation (usually a number of spaces).
    newlines - whether new lines are added to layout the
 public OutputFormat(String indent,
    boolean newlines,
    String encoding) 
    Creates an OutputFormat with the given indent added with optional newlines between the Elements and the given encoding format.
    Parameters:
    indent - is the indent string to be used for indentation (usually a number of spaces).
    newlines - whether new lines are added to layout the
    encoding - is the text encoding to use for writing the XML
Method from org.dom4j.io.OutputFormat Summary:
createCompactFormat,   createPrettyPrint,   getAttributeQuoteCharacter,   getEncoding,   getIndent,   getLineSeparator,   getNewLineAfterNTags,   isExpandEmptyElements,   isNewLineAfterDeclaration,   isNewlines,   isOmitEncoding,   isPadText,   isSuppressDeclaration,   isTrimText,   isXHTML,   parseOptions,   setAttributeQuoteCharacter,   setEncoding,   setExpandEmptyElements,   setIndent,   setIndent,   setIndentSize,   setLineSeparator,   setNewLineAfterDeclaration,   setNewLineAfterNTags,   setNewlines,   setOmitEncoding,   setPadText,   setSuppressDeclaration,   setTrimText,   setXHTML
Methods from java.lang.Object:
equals,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.dom4j.io.OutputFormat Detail:
 public static OutputFormat createCompactFormat() 
    A static helper method to create the default compact format. This format does not have any indentation or newlines after an alement and all other whitespace trimmed
 public static OutputFormat createPrettyPrint() 
    A static helper method to create the default pretty printing format. This format consists of an indent of 2 spaces, newlines after each element and all other whitespace trimmed, and XMTML is false.
 public char getAttributeQuoteCharacter() 
 public String getEncoding() 
 public String getIndent() 
 public String getLineSeparator() 
 public int getNewLineAfterNTags() 
 public boolean isExpandEmptyElements() 
 public boolean isNewLineAfterDeclaration() 
    DOCUMENT ME!
 public boolean isNewlines() 
 public boolean isOmitEncoding() 
 public boolean isPadText() 
 public boolean isSuppressDeclaration() 
    DOCUMENT ME!
 public boolean isTrimText() 
 public boolean isXHTML() 

    Whether or not to use the XHTML standard: like HTML but passes an XML parser with real, closed tags. Also, XHTML CDATA sections will be output with the CDATA delimiters: ( " <![CDATA[ " and " ]]> " ) otherwise, the class HTMLWriter will output the CDATA text, but not the delimiters.

    Default is false

 public int parseOptions(String[] args,
    int i) 
    Parses command line arguments of the form -omitEncoding -indentSize 3 -newlines -trimText
 public  void setAttributeQuoteCharacter(char quoteChar) 
    Sets the character used to quote attribute values. The specified character must be a valid XML attribute quote character, otherwise an IllegalArgumentException will be thrown.
 public  void setEncoding(String encoding) 
    DOCUMENT ME!
 public  void setExpandEmptyElements(boolean expandEmptyElements) 

    This will set whether empty elements are expanded from <tagName> to <tagName></tagName>.

 public  void setIndent(String indent) 

    This will set the indent String to use; this is usually a String of empty spaces. If you pass null, or the empty string (""), then no indentation will happen.

    Default: none (null)
 public  void setIndent(boolean doIndent) 
    Set the indent on or off. If setting on, will use the value of STANDARD_INDENT, which is usually two spaces.
 public  void setIndentSize(int indentSize) 

    This will set the indent String's size; an indentSize of 4 would result in the indention being equivalent to the String "    " (four space characters).

 public  void setLineSeparator(String separator) 

    This will set the new-line separator. The default is \n. Note that if the "newlines" property is false, this value is irrelevant. To make it output the system default line ending string, call setLineSeparator(System.getProperty("line.separator"))

 public  void setNewLineAfterDeclaration(boolean newLineAfterDeclaration) 

    This will set whether a new line is printed after the XML declaration (assuming it is not supressed.)

 public  void setNewLineAfterNTags(int tagCount) 
    Controls output of a line.separator every tagCount tags when isNewlines is false. If tagCount equals zero, it means don't do anything special. If greater than zero, then a line.separator will be output after tagCount tags have been output. Used when you would like to squeeze the html as much as possible, but some browsers don't like really long lines. A tag count of 10 would produce a line.separator in the output after 10 close tags (including single tags).
 public  void setNewlines(boolean newlines) 
    DOCUMENT ME!
 public  void setOmitEncoding(boolean omitEncoding) 

    This will set whether the XML declaration (<?xml version="1.0" encoding="UTF-8"?>) includes the encoding of the document. It is common to suppress this in protocols such as WML and SOAP.

 public  void setPadText(boolean padText) 

    Ensure that text immediately preceded by or followed by an element will be "padded" with a single space. This is used to allow make browser-friendly HTML, avoiding trimText's transformation of, e.g., The quick <b>brown</b> fox into The quick<b>brown</b>fox (the latter will run the three separate words together into a single word). This setting is not too useful if you haven't also called #setTrimText .

    The padding string will only be added if the text itself starts or ends with some whitespace characters.

    Default: false

 public  void setSuppressDeclaration(boolean suppressDeclaration) 

    This will set whether the XML declaration (<?xml version="1.0" encoding="UTF-8"?>) is included or not. It is common to suppress this in protocols such as WML and SOAP.

 public  void setTrimText(boolean trimText) 
 public  void setXHTML(boolean xhtml) 

    This will set whether or not to use the XHTML standard: like HTML but passes an XML parser with real, closed tags. Also, XHTML CDATA sections will be output with the CDATA delimiters: ( " <[CDATA[ " and " ]]< ) otherwise, the class HTMLWriter will output the CDATA text, but not the delimiters.

    Default: false