com.fasterxml.jackson.dataformat.xml

Interface XmlNameProcessor

All Superinterfaces:

Serializable

public interface XmlNameProcessor
extends Serializable

API of processors primarily used for dealing with XML names containing invalid characters. Invalid characters in names can, for instance, easily appear in map keys.

Processors should be set in the XmlMapper.setXmlNameProcessor(com.fasterxml.jackson.dataformat.xml.XmlNameProcessor) and/or the XmlMapper.Builder.xmlNameProcessor(com.fasterxml.jackson.dataformat.xml.XmlNameProcessor) methods.

See XmlNameProcessors for default processors.

Since:

2.14

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	XmlNameProcessor.XmlName Representation of an XML element or attribute name

Method Summary

Modifier and Type	Method and Description
void	decodeName(XmlNameProcessor.XmlName name) Used during XML deserialization.
void	encodeName(XmlNameProcessor.XmlName name) Used during XML serialization.

Method Detail

encodeName

void encodeName(XmlNameProcessor.XmlName name)

Used during XML serialization.

This method should process the provided XmlNameProcessor.XmlName and escape / encode invalid XML characters.

Parameters:

name - The name to encode

decodeName

void decodeName(XmlNameProcessor.XmlName name)

Used during XML deserialization.

This method should process the provided XmlNameProcessor.XmlName and revert the encoding done in the encodeName(XmlName) method.

Note: Depending on the use case, it is not always required (or even possible) to reverse an encoding with 100% accuracy.

Parameters:

name - The name to encode