AbstractXmlObjectMapper constructor
AbstractXmlObjectMapper([
- bool autoRegisterStandardAdapters = true
Abstract base implementation of XmlObjectMapper providing core XML serialization and deserialization functionality.
This class implements all XmlObjectMapper methods using XML parsing and serialization. Subclasses provide the actual implementation details for parsing XML content and building objects from XML nodes.
Design
- Handles XML serialization and deserialization contract
- Delegates format-specific XML processing to subclasses
- Reuses ObjectMapper methods for JSON operations where applicable
- Provides XML-specific entry points without coupling to implementation
Responsibilities
This class handles:
- XML content parsing and tree traversal
- Tree-based XML navigation via XmlNode
- Format conversions between XML strings and maps
- Integration with Jetson's naming strategies and converters
Extension
Subclasses should override:
- writeValueAsXml - Custom XML serialization
- readXmlValue - Custom XML deserialization
- readXmlTree - XML tree parsing implementation
- Other methods as needed for custom XML processing
Example
class MyXmlMapper extends AbstractXmlObjectMapper {
@override
String writeValueAsXml(Object? value) {
// Custom XML serialization
}
}
Related Classes
- AbstractYamlObjectMapper - YAML extension
- XmlObjectMapper - Interface definition
- ObjectMapper - Base mapping contract
Implementation
AbstractXmlObjectMapper([super.autoRegisterStandardAdapters = true]) : super() {
if (autoRegisterStandardAdapters) {
// Primitives
registerSerializer(Class<String>(), StringSerializer<XmlGenerator, XmlSerializationContext>());
registerSerializer(Class<int>(), IntSerializer<XmlGenerator, XmlSerializationContext>());
registerSerializer(Class<double>(), DoubleSerializer<XmlGenerator, XmlSerializationContext>());
registerSerializer(Class<bool>(), BoolSerializer<XmlGenerator, XmlSerializationContext>());
registerSerializer(Class<num>(), NumSerializer<XmlGenerator, XmlSerializationContext>());
// Primitives
registerDeserializer(Class<String>(), StringDeserializer<XmlParser, XmlDeserializationContext>());
registerDeserializer(Class<int>(), IntDeserializer<XmlParser, XmlDeserializationContext>());
registerDeserializer(Class<double>(), DoubleDeserializer<XmlParser, XmlDeserializationContext>());
registerDeserializer(Class<bool>(), BoolDeserializer<XmlParser, XmlDeserializationContext>());
registerDeserializer(Class<num>(), NumDeserializer<XmlParser, XmlDeserializationContext>());
// Collections
registerAdapter(Class<List>(), ListXmlSerializationAdapter());
registerAdapter(Class<Map>(), MapXmlSerializationAdapter());
registerAdapter(Class<Set>(), SetXmlSerializationAdapter());
// Date/Time (from converter adapters)
registerAdapter(Class<DateTime>(), DateTimeSerializationAdapter<XmlGenerator, XmlParser, XmlDeserializationContext, XmlSerializationContext>());
registerAdapter(Class<ZonedDateTime>(), ZonedDateTimeSerializationAdapter<XmlGenerator, XmlParser, XmlDeserializationContext, XmlSerializationContext>());
registerAdapter(Class<LocalDateTime>(), LocalDateTimeSerializationAdapter<XmlGenerator, XmlParser, XmlDeserializationContext, XmlSerializationContext>());
registerAdapter(Class<LocalDate>(), LocalDateSerializationAdapter<XmlGenerator, XmlParser, XmlDeserializationContext, XmlSerializationContext>());
registerAdapter(Class<Duration>(), DurationSerializationAdapter<XmlGenerator, XmlParser, XmlDeserializationContext, XmlSerializationContext>());
// URIs
registerAdapter(Class<Uri>(), UriSerializationAdapter<XmlGenerator, XmlParser, XmlDeserializationContext, XmlSerializationContext>());
registerAdapter(Class<Url>(), UrlSerializationAdapter<XmlGenerator, XmlParser, XmlDeserializationContext, XmlSerializationContext>());
}
}