com.atlassian.confluence.content.render.xhtml

Class StaxUtils

java.lang.Object

com.atlassian.confluence.content.render.xhtml.StaxUtils

public final class StaxUtils
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
StaxUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static void	closeQuietly(javax.xml.stream.XMLEventReader xmlEventReader)
static void	closeQuietly(javax.xml.stream.XMLEventWriter xmlEventWriter)
static void	closeQuietly(javax.xml.stream.XMLStreamReader xmlStreamReader)
static void	closeQuietly(javax.xml.stream.XMLStreamWriter xmlStreamWriter)
static java.lang.StringBuilder	collectWhitespace(java.lang.StringBuilder builder, javax.xml.stream.XMLEventReader reader) Collect whitespace from the given reader, into the given builder.
static java.lang.String	collectWhitespace(javax.xml.stream.XMLEventReader reader) Collect whitespace from the given reader.
static XhtmlException	convertToXhtmlException(com.ctc.wstx.exc.WstxLazyException ex) Take a WstxLazyException as a parameter and return the appropriate XhtmlException for the Woodstox exception supplied.
static void	flushEventWriter(javax.xml.stream.XMLEventWriter eventWriter) Ensure all xml events that have been added to the event buffer of the writer are flushed.
static java.lang.String	getAttributeValue(javax.xml.stream.events.StartElement startElement, javax.xml.namespace.QName attributeQName)
static java.lang.String	getAttributeValue(javax.xml.stream.events.StartElement startElement, javax.xml.namespace.QName attributeQName, java.lang.String defaultValue) Retrieves the value of the specified attribute name on the specified start element.
static java.lang.String	getAttributeValue(javax.xml.stream.events.StartElement startElement, java.lang.String attributeName)
static java.lang.String	getAttributeValue(javax.xml.stream.events.StartElement startElement, java.lang.String attributeName, java.lang.String defaultValue) Retrieves the value of the specified attribute name on the specified start element.
static boolean	hasAttributes(javax.xml.stream.events.StartElement startElement, java.lang.String... attributeNames) Returns true if start element has all the specified attributes.
static boolean	hasClass(javax.xml.stream.events.StartElement startElement, java.lang.String className)
static java.lang.String	readCharactersAndEntities(javax.xml.stream.XMLEventReader reader) Read all characters and entities from the supplied reader until a non-character or non-entity event is read.
static void	skipWhitespace(javax.xml.stream.XMLEventReader reader) Skip whitespace from the given reader.
static java.util.List<java.lang.String>	splitCData(java.lang.String data) Take a String and split into multiple substrings where each substring is suitable to be written as CData.
static java.lang.CharSequence	stripIllegalControlChars(java.lang.CharSequence unclean) Removes control characters from a CharSequence so that it can be parsed by a Stax parser.
static java.lang.String	toString(javax.xml.stream.XMLEventReader reader) Deprecated. since 5.2. Use toXmlString(javax.xml.stream.XMLEventReader, XmlOutputFactory)
static java.lang.String	toXmlString(javax.xml.stream.XMLEventReader reader, XmlOutputFactory xmlOutputFactory)
static java.lang.String	toXmlStringWithoutTag(javax.xml.stream.XMLEventReader reader, XmlOutputFactory xmlOutputFactory, java.util.Set<javax.xml.namespace.QName> ignoredElements) Reads an XML stream and turns it into a string while removing any tags matched in ignoredElements
static void	writeAttribute(javax.xml.stream.XMLStreamWriter writer, javax.xml.namespace.QName attribute, java.lang.String value) Write an attribute and its value on the provided XMLStreamWriter
static void	writeRawXML(javax.xml.stream.XMLStreamWriter writer, java.io.Writer out, Streamable streamable) Write raw XML properly on the provided Writer, which is wrapped by a XMLStreamWriter
static void	writeStartElement(javax.xml.stream.XMLStreamWriter writer, javax.xml.namespace.QName element) Write the element start on the provided XMLStreamWriter

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StaxUtils

public StaxUtils()

Method Detail

writeStartElement

public static void writeStartElement(javax.xml.stream.XMLStreamWriter writer,
                     javax.xml.namespace.QName element)
                              throws javax.xml.stream.XMLStreamException

Write the element start on the provided XMLStreamWriter

Throws:

javax.xml.stream.XMLStreamException

Since:

5.6

writeAttribute

public static void writeAttribute(javax.xml.stream.XMLStreamWriter writer,
                  javax.xml.namespace.QName attribute,
                  java.lang.String value)
                           throws javax.xml.stream.XMLStreamException

Write an attribute and its value on the provided XMLStreamWriter

Throws:

javax.xml.stream.XMLStreamException

Since:

5.6

writeRawXML

public static void writeRawXML(javax.xml.stream.XMLStreamWriter writer,
               java.io.Writer out,
               Streamable streamable)
                        throws java.io.IOException,
                               javax.xml.stream.XMLStreamException

Write raw XML properly on the provided Writer, which is wrapped by a XMLStreamWriter

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

Since:

5.6

closeQuietly

public static void closeQuietly(javax.xml.stream.XMLEventReader xmlEventReader)

closeQuietly

public static void closeQuietly(javax.xml.stream.XMLStreamReader xmlStreamReader)

closeQuietly

public static void closeQuietly(javax.xml.stream.XMLEventWriter xmlEventWriter)

closeQuietly

public static void closeQuietly(javax.xml.stream.XMLStreamWriter xmlStreamWriter)

getAttributeValue

public static java.lang.String getAttributeValue(javax.xml.stream.events.StartElement startElement,
                                 java.lang.String attributeName)

getAttributeValue

public static java.lang.String getAttributeValue(javax.xml.stream.events.StartElement startElement,
                                 javax.xml.namespace.QName attributeQName)

getAttributeValue

public static java.lang.String getAttributeValue(javax.xml.stream.events.StartElement startElement,
                                 java.lang.String attributeName,
                                 java.lang.String defaultValue)

Retrieves the value of the specified attribute name on the specified start element.

Parameters:

startElement - start element

attributeName - attribute name

Returns:

attribute value or default value if attribute does not exist

getAttributeValue

public static java.lang.String getAttributeValue(javax.xml.stream.events.StartElement startElement,
                                 javax.xml.namespace.QName attributeQName,
                                 java.lang.String defaultValue)

Retrieves the value of the specified attribute name on the specified start element.

Parameters:

startElement - start element

attributeQName - attribute QName

Returns:

attribute value or default value if attribute does not exist

hasAttributes

public static boolean hasAttributes(javax.xml.stream.events.StartElement startElement,
                    java.lang.String... attributeNames)

Returns true if start element has all the specified attributes.

Parameters:

startElement - start element

attributeNames - attribute names

Returns:

true if start element has all the specified attributes, false otherwise.

hasClass

public static boolean hasClass(javax.xml.stream.events.StartElement startElement,
               java.lang.String className)

Parameters:

startElement -

className -

Returns:

true if the supplied startElement has an HTML class attribute containing the supplied class name.

collectWhitespace

public static java.lang.String collectWhitespace(javax.xml.stream.XMLEventReader reader)
                                          throws javax.xml.stream.XMLStreamException

Collect whitespace from the given reader. Useful for conditional inclusion in parsed results.

Parameters:

reader - the reader

Returns:

the whitespace

Throws:

javax.xml.stream.XMLStreamException - if there are problems reading from the supplied reader

collectWhitespace

public static java.lang.StringBuilder collectWhitespace(java.lang.StringBuilder builder,
                                        javax.xml.stream.XMLEventReader reader)
                                                 throws javax.xml.stream.XMLStreamException

Collect whitespace from the given reader, into the given builder. Useful for conditional inclusion in parsed results.

Parameters:

builder - the builder

reader - the reader

Returns:

the given builder

Throws:

javax.xml.stream.XMLStreamException - if there are problems reading from the supplied reader

skipWhitespace

public static void skipWhitespace(javax.xml.stream.XMLEventReader reader)
                           throws javax.xml.stream.XMLStreamException

Skip whitespace from the given reader. Useful for unconditionally ignoring whitespace in parsed results.

Parameters:

reader - the reader

Throws:

javax.xml.stream.XMLStreamException - if there are problems reading from the supplied reader

readCharactersAndEntities

public static java.lang.String readCharactersAndEntities(javax.xml.stream.XMLEventReader reader)
                                                  throws javax.xml.stream.XMLStreamException

Read all characters and entities from the supplied reader until a non-character or non-entity event is read. At this point the stream will be left with the next event being this terminating event.

Parameters:

reader - the reader to read from, with the current event being either a character or an entity

Returns:

a String including all characters and entities read.

Throws:

javax.xml.stream.XMLStreamException - if there are problems reading from the supplied reader

toString

@Deprecated
public static java.lang.String toString(javax.xml.stream.XMLEventReader reader)

Deprecated. since 5.2. Use toXmlString(javax.xml.stream.XMLEventReader, XmlOutputFactory)

toXmlString

public static java.lang.String toXmlString(javax.xml.stream.XMLEventReader reader,
                           XmlOutputFactory xmlOutputFactory)

toXmlStringWithoutTag

public static java.lang.String toXmlStringWithoutTag(javax.xml.stream.XMLEventReader reader,
                                     XmlOutputFactory xmlOutputFactory,
                                     java.util.Set<javax.xml.namespace.QName> ignoredElements)

Reads an XML stream and turns it into a string while removing any tags matched in ignoredElements

Parameters:

reader - The XML event reader

xmlOutputFactory - The XML output factory

ignoredElements - A set of tags that should be stripped from the output

Returns:

A string representation of the XML document with the specified tags removed.

flushEventWriter

public static void flushEventWriter(javax.xml.stream.XMLEventWriter eventWriter)
                             throws javax.xml.stream.XMLStreamException

Ensure all xml events that have been added to the event buffer of the writer are flushed.

You want to be using this instead of XMLEventWriter.flush() when:

you have just written the start element to the event stream plan to then write the body of the element directly to the underlying writer If you want to do this, you need this method to append the closing angle bracket of the start element. You want to do in preparation for writing to the underlying writer directly.

Parameters:

eventWriter - the event writer

Throws:

javax.xml.stream.XMLStreamException

splitCData

public static java.util.List<java.lang.String> splitCData(java.lang.String data)

Take a String and split into multiple substrings where each substring is suitable to be written as CData.

You would use this method when you want to write CDATA to an XML document and you need to be sure that the content you are writing doesn't contain a CDATA closing triad (]]>) which would cause a premature closing of the CDATA.

So as an example if you supply a String like <![CDATA[stuff]]> then the returned Strings would be

1. <![CDATA[stuff]]
2. >

The final > would close the CDATA so is returned in a separate String. Both these returned Strings can be safely written to CDATA sections in a document.

If the supplied String is already safe for writing to a CDATA section then a single item List will be returned containing the supplied String.

Parameters:

data - the data to be made safe for writing to a CDATA section.

Returns:

a list of one or more items where each item is safe to be written to a separate CDATA sections.

convertToXhtmlException

public static XhtmlException convertToXhtmlException(com.ctc.wstx.exc.WstxLazyException ex)

Take a WstxLazyException as a parameter and return the appropriate XhtmlException for the Woodstox exception supplied.

Parameters:

ex - the Woodstox exception to be converted to an XhtmlException.

Returns:

an XhtmlParsingException if the WstxLazyException is wrapping a WstxParsingException, otherwise an XhtmlException

stripIllegalControlChars

public static java.lang.CharSequence stripIllegalControlChars(java.lang.CharSequence unclean)

Removes control characters from a CharSequence so that it can be parsed by a Stax parser. The xml spec defines what characters an XML processor must accept:

Legal characters are tab, carriage return, line feed, and the legal characters of Unicode and ISO/IEC 10646

XML Charsets.

This method only removes illegal control chars, and doesn't attempt to remove illegal Unicode characters.

Parameters:

unclean -

Returns:

the supplied CharSequence with illegal control characters stripped