org.zkoss.xml
Class XMLs

java.lang.Object
  org.zkoss.xml.XMLs

public class XMLs
extends java.lang.Object

The XML relevant utilities.

Author:

tomyeh

See Also:

Element

Constructor Summary

XMLs()

Method Summary

static java.lang.String	encodeAttribute(java.lang.String value) Encodes a value such that it could be used as XML attribute.
static java.lang.String	encodeText(java.lang.String value) Encodes a value such that it could be enclosed by a XML elemnt.
static java.lang.StringBuffer	encodeText(java.lang.StringBuffer sb, java.lang.String value) Encodes a value and appends it to a string buffer, such that it could be enclosed by a XML elemnt.
static java.lang.StringBuffer	encodeText(java.lang.StringBuffer sb, java.lang.String value, int begin, int end) Encodes a value of the specified range, and appends it to a string buffer, such that it could be enclosed by a XML elemnt.
static java.lang.String	escapeXML(char cc) Enscapes a character into a string if it is a special XML character, returns null if not a special character.
static java.lang.String	escapeXML(java.lang.String s) Encodes a string that special characters are quoted to be compatible with HTML/XML.
static java.lang.String	toXMLName(java.lang.String name) Converting a name to a valid XML name.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLs

public XMLs()

Method Detail

toXMLName

public static final java.lang.String toXMLName(java.lang.String name)

Converting a name to a valid XML name. Note: it is not reversible.

encodeAttribute

public static final java.lang.String encodeAttribute(java.lang.String value)

Encodes a value such that it could be used as XML attribute.

encodeText

public static final java.lang.String encodeText(java.lang.String value)

Encodes a value such that it could be enclosed by a XML elemnt.

Note: It is sometime inproper to use CDATA if the text contains CDATA, too. The simplest way is NOT to use CDATA but encoding the string by this method.

encodeText

public static final java.lang.StringBuffer encodeText(java.lang.StringBuffer sb,
                                                      java.lang.String value)

Encodes a value and appends it to a string buffer, such that it could be enclosed by a XML elemnt.

Note: It is sometime inproper to use CDATA if the text contains CDATA, too. The simplest way is NOT to use CDATA but encoding the string by this method.

encodeText

public static final java.lang.StringBuffer encodeText(java.lang.StringBuffer sb,
                                                      java.lang.String value,
                                                      int begin,
                                                      int end)

Encodes a value of the specified range, and appends it to a string buffer, such that it could be enclosed by a XML elemnt.

Note: It is sometime inproper to use CDATA if the text contains CDATA, too. The simplest way is NOT to use CDATA but encoding the string by this method.

Parameters:

value - the string to encode

begin - the beginning index, inclusive, of the string to encode (i.e., value), includinge

end - the ending index, exclusive of the string to encode (i.e., value), excluded

Since:

5.0.0

escapeXML

public static final java.lang.String escapeXML(java.lang.String s)

Encodes a string that special characters are quoted to be compatible with HTML/XML. For example, < is translated to &lt;. & -> &amp;
< -> &lt;
> -> &gt;
" -> &#034;
' -> &#039;

Parameters:

s - the string to quote; null is OK

Returns:

the escaped string, or an empty string if s is null

escapeXML

public static final java.lang.String escapeXML(char cc)

Enscapes a character into a string if it is a special XML character, returns null if not a special character. & -> &amp;
< -> &lt;
> -> &gt;
" -> &#034;
' -> &#039;