Package com.topologi.diffx.xml.esc

Interface XMLEscape

All Known Implementing Classes:
XMLEscapeASCII, XMLEscapeBase, XMLEscapeUTF8
public interface XMLEscape
An interface to escape XML character data.

This interface assumes that the values to be escapes do not orignate from XML text, in order words, there should not be already any entity or markup in the document. If it is the case the methods in this class should also escapes them. Thus "&" would be represented as "&".

Also the method will not try to escape characters that cannot be escaped.

This interface is based on the paragraph 2.4 of the XML 1.0 Specifications.

Version:
7 March 2005

  • Method Details

    • toAttributeValue

      String toAttributeValue(char[] ch, int off, int len)
      Returns a well-formed attribute value.

      This method must replace any character in the specified value by the corresponding numeric character reference or the predefined XML general entities, if the character is not allowed or not in the encoding range.

      Attribute values must not contain '&amp' or '<. Quotes and apostrophes must also be escaped by "&quot;" and "&apos;" respectively.

      Parameters:
      ch - The value that needs to be attribute-escaped.
      off - The start (offset) of the characters.
      len - The length of characters to.
      Returns:
      A well-formed value for the attribute.

    • toAttributeValue

      String toAttributeValue(String value)
      Returns a well-formed attribute value.

      Method provided for convenience, using the same specifications as toAttributeValue(char[], int, int).

      This method should return null if the given value is null.

      Parameters:
      value - The value that needs to be attribute-escaped.
      Returns:
      A well-formed value for the attribute.

    • toElementText

      String toElementText(char[] ch, int off, int len)
      Returns a well-formed text value for the element.

      This method must replace any character in the specified value by the corresponding numeric character reference or the predefined XML general entities, if the character is not allowed or not in the encoding range.

      The text of an element must not contain '&amp' or '<.

      Parameters:
      ch - The value that needs to be attribute-escaped.
      off - The start (offset) of the characters.
      len - The length of characters to.
      Returns:
      A well-formed value for the text node.

    • toElementText

      String toElementText(String value)
      Returns a well-formed text value for the element.

      Method provided for convenience, using the same specifications as toElementText(char[], int, int).

      This method should return null if the given value is null.

      Parameters:
      value - The value that needs to be text-escaped.
      Returns:
      A well-formed value for the text node.

    • getEncoding

      String getEncoding()
      Returns the encoding used by the implementing class.
      Returns:
      The encoding used by the implementing class.