|
||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||
public interface IXMLWriter
XML writer interface used for output of marshalled document. This interface allows easy substitution of different output formats, including parse event stream equivalents. This makes heavy use of state information, so each method call defined is only valid in certain states.
| Method Summary | |
|---|---|
void |
addAttribute(int index,
java.lang.String name,
java.lang.String value)
Add attribute to current open start tag. |
void |
close()
Close document output. |
void |
closeEmptyTag()
Close the current open start tag as an empty element. |
void |
closeStartTag()
Close the current open start tag. |
void |
endTag(int index,
java.lang.String name)
Generate end tag. |
void |
flush()
Flush document output. |
java.lang.String[][] |
getExtensionNamespaces()
Get extension namespace URIs added to those in mapping. |
int |
getNamespaceCount()
Get the number of namespaces currently defined. |
java.lang.String |
getNamespacePrefix(int index)
Get current prefix defined for namespace. |
java.lang.String[] |
getNamespaces()
Get namespace URIs for mapping. |
java.lang.String |
getNamespaceUri(int index)
Get URI for namespace. |
int |
getNestingDepth()
Get the current element nesting depth. |
int |
getPrefixIndex(java.lang.String prefix)
Get index of namespace mapped to prefix. |
void |
indent()
Request output indent. |
void |
init()
Initialize writer. |
int[] |
openNamespaces(int[] nums,
java.lang.String[] prefs)
Open the specified namespaces for use. |
void |
popExtensionNamespaces()
Remove extension namespace URIs. |
void |
popTranslationTable()
Pop a translation table used for converting namespace index numbers to values matching the internal lookup. |
void |
pushExtensionNamespaces(java.lang.String[] uris)
Append extension namespace URIs to those in mapping. |
void |
pushTranslationTable(int[] table)
Push a translation table to be used for converting namespace index numbers passed as arguments to values used for internal lookup. |
void |
reset()
Reset to initial state for reuse. |
void |
setIndentSpaces(int count,
java.lang.String newline,
char indent)
Set nesting indentation. |
void |
startTagClosed(int index,
java.lang.String name)
Generate closed start tag. |
void |
startTagNamespaces(int index,
java.lang.String name,
int[] nums,
java.lang.String[] prefs)
Generate start tag for element with namespaces. |
void |
startTagOpen(int index,
java.lang.String name)
Generate open start tag. |
void |
writeCData(java.lang.String text)
Write CDATA text to document. |
void |
writeComment(java.lang.String text)
Write comment to document. |
void |
writeDocType(java.lang.String name,
java.lang.String sys,
java.lang.String pub,
java.lang.String subset)
Write DOCTYPE declaration to document. |
void |
writeEntityRef(java.lang.String name)
Write entity reference to document. |
void |
writePI(java.lang.String target,
java.lang.String data)
Write processing instruction to document. |
void |
writeTextContent(java.lang.String text)
Write ordinary character data text content to document. |
void |
writeXMLDecl(java.lang.String version,
java.lang.String encoding,
java.lang.String standalone)
Write XML declaration to document. |
| Method Detail |
|---|
void init()
throws java.io.IOException
java.io.IOExceptionint getNestingDepth()
int getNamespaceCount()
void setIndentSpaces(int count,
java.lang.String newline,
char indent)
count - number of character to indent per level, or disable
indentation if negative (zero means new line only)newline - sequence of characters used for a line ending
(null means use the single character '\n')indent - whitespace character used for indentation
void writeXMLDecl(java.lang.String version,
java.lang.String encoding,
java.lang.String standalone)
throws java.io.IOException
version - XML version textencoding - text for encoding attribute (unspecified if
null)standalone - text for standalone attribute (unspecified if
null)
java.io.IOException - on error writing to document
void startTagOpen(int index,
java.lang.String name)
throws java.io.IOException
closeStartTag() call.
index - namespace URI index numbername - unqualified element name
java.io.IOException - on error writing to document
void startTagNamespaces(int index,
java.lang.String name,
int[] nums,
java.lang.String[] prefs)
throws java.io.IOException
index - namespace URI index numbername - element namenums - array of namespace indexes defined by this element (must
be constant, reference is kept until end of element)prefs - array of namespace prefixes mapped by this element (no
null values, use "" for default namespace declaration)
java.io.IOException - on error writing to document
void addAttribute(int index,
java.lang.String name,
java.lang.String value)
throws java.io.IOException
startTagOpen(int, java.lang.String) and before the corresponding call to closeStartTag().
index - namespace URI index numbername - unqualified attribute namevalue - text value for attribute
java.io.IOException - on error writing to document
void closeStartTag()
throws java.io.IOException
startTagOpen(int, java.lang.String).
java.io.IOException - on error writing to document
void closeEmptyTag()
throws java.io.IOException
startTagOpen(int, java.lang.String).
java.io.IOException - on error writing to document
void startTagClosed(int index,
java.lang.String name)
throws java.io.IOException
index - namespace URI index numbername - unqualified element name
java.io.IOException - on error writing to document
void endTag(int index,
java.lang.String name)
throws java.io.IOException
index - namespace URI index numbername - unqualified element name
java.io.IOException - on error writing to document
void writeTextContent(java.lang.String text)
throws java.io.IOException
text - content value text (must not be null)
java.io.IOException - on error writing to document
void writeCData(java.lang.String text)
throws java.io.IOException
text - content value text (must not be null)
java.io.IOException - on error writing to document
void writeComment(java.lang.String text)
throws java.io.IOException
text - comment text (must not be null)
java.io.IOException - on error writing to document
void writeEntityRef(java.lang.String name)
throws java.io.IOException
name - entity name (must not be null)
java.io.IOException - on error writing to document
void writeDocType(java.lang.String name,
java.lang.String sys,
java.lang.String pub,
java.lang.String subset)
throws java.io.IOException
name - root element namesys - system ID (null if none, must be
non-null for public ID to be used)pub - public ID (null if none)subset - internal subset (null if none)
java.io.IOException - on error writing to document
void writePI(java.lang.String target,
java.lang.String data)
throws java.io.IOException
target - processing instruction target name (must not be
null)data - processing instruction data (must not be null)
java.io.IOException - on error writing to document
void indent()
throws java.io.IOException
java.io.IOException - on error writing to document
void flush()
throws java.io.IOException
java.io.IOException - on error writing to document
void close()
throws java.io.IOException
java.io.IOException - on error writing to documentvoid reset()
java.lang.String[] getNamespaces()
java.lang.String getNamespaceUri(int index)
index - namespace URI index number
null if the namespace index
is invalidjava.lang.String getNamespacePrefix(int index)
index - namespace URI index number
null if the namespace is not
currently mappedint getPrefixIndex(java.lang.String prefix)
prefix - text to match (non-null, use "" for default
prefix)
void pushExtensionNamespaces(java.lang.String[] uris)
uris - namespace URIs to extend those in mappingvoid popExtensionNamespaces()
pushExtensionNamespaces(java.lang.String[]).
java.lang.String[][] getExtensionNamespaces()
null if
none)
int[] openNamespaces(int[] nums,
java.lang.String[] prefs)
throws java.io.IOException
nums - array of namespace indexes defined by this element (reference
kept until namespaces are closed, values may be modified by this method)prefs - array of namespace prefixes mapped by this element (no
null values, use "" for default namespace declaration)
java.io.IOException - on error writing to documentvoid pushTranslationTable(int[] table)
table - translation table to be used (null if no
change)void popTranslationTable()
|
||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||