AbstractXmlObjectMapper constructor

AbstractXmlObjectMapper([
  1. 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:

Example

class MyXmlMapper extends AbstractXmlObjectMapper {
  @override
  String writeValueAsXml(Object? value) {
    // Custom XML serialization
  }
}

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>());
  }
}