org.zkoss.xml
Class XMLs

java.lang.Object
  extended by 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;



Copyright © 2005-2011 Potix Corporation. All Rights Reserved. SourceForge.net Logo