Package org.grails.encoder.impl

Class BasicXMLEncoder

java.lang.Object

org.grails.encoder.AbstractCharReplacementEncoder

org.grails.encoder.impl.BasicXMLEncoder

All Implemented Interfaces:

CodecIdentifierProvider, Encoder, EncodesToWriter, StreamingEncoder

Direct Known Subclasses:

HTMLEncoder

public class BasicXMLEncoder
extends AbstractCharReplacementEncoder

Encoder implementation that escapes some characters for inclusion in XML documents Currently ', ", <, > and & characters are replaced with XML entities. Additionally backslash (/), non-breaking space, backtick (`) and @ are also replaced for visibility/additional security.

Since:

2.3

Field Summary

Fields

Modifier and Type	Field	Description
static final CodecIdentifier	XML_CODEC_IDENTIFIER

Fields inherited from class org.grails.encoder.AbstractCharReplacementEncoder

codecIdentifier

Constructor Summary

Constructors

Modifier	Constructor	Description
	BasicXMLEncoder()
protected	BasicXMLEncoder(CodecIdentifier codecIdentifier)

Method Summary

Modifier and Type	Method	Description
protected Object	doEncode(Object o)
final Object	encode(Object o)	Encode given input object
protected Object	encodeAsXmlObject(Object o)
protected String	escapeCharacter(char ch, char previousChar)	Escape the character, return null if no replacement has to be made
protected static final String	xmlEscapeCharacter(char ch)

Methods inherited from class org.grails.encoder.AbstractCharReplacementEncoder

convertToString, createChainingEncodesToWriter, doCharReplacementEncoding, encodeToStream, encodeToWriter, encodeToWriter, escapeCharSequence, getCodecIdentifier, isApplyToSafelyEncoded, isSafe, markEncoded

Methods inherited from class java.lang.Object

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

Field Details

XML_CODEC_IDENTIFIER

public static final CodecIdentifier XML_CODEC_IDENTIFIER

Constructor Details

BasicXMLEncoder

public BasicXMLEncoder()

BasicXMLEncoder

protected BasicXMLEncoder(CodecIdentifier codecIdentifier)

Method Details

xmlEscapeCharacter

protected static final String xmlEscapeCharacter(char ch)

escapeCharacter

protected String escapeCharacter(char ch,
 char previousChar)

Description copied from class: AbstractCharReplacementEncoder

Escape the character, return null if no replacement has to be made

Specified by:

escapeCharacter in class AbstractCharReplacementEncoder

Parameters:

ch - the character to escape

previousChar - the previous char

Returns:

the replacement string, null if no replacement has to be made

encode

public final Object encode(Object o)

Description copied from interface: Encoder

Encode given input object

Specified by:

encode in interface Encoder

Overrides:

encode in class AbstractCharReplacementEncoder

Parameters:

o - the input object

Returns:

the encoded object

doEncode

protected Object doEncode(Object o)

encodeAsXmlObject

protected Object encodeAsXmlObject(Object o)