refactor: Convert TimeConfigurationDto and UsagePointDto to records with FIELD access (Issue #61)

[dfcoffin]

Summary

Completes Issue #61 by converting the remaining 2 DTO POJOs (TimeConfigurationDto and UsagePointDto) to Java records, achieving 100% record adoption across all 36 DTOs.

Changes Made

Core DTO Conversions

• ✅ TimeConfigurationDto: Converted from POJO class to record with @XmlAccessorType(FIELD)
• ✅ UsagePointDto: Converted from POJO class to record with @XmlAccessorType(FIELD)
• Moved JAXB annotations from getter methods to record component parameters
• Added defensive byte array cloning in overridden accessors (dstStartRule(), dstEndRule(), roleFlags())
• Eliminated @XmlTransient annotations on utility methods (no longer needed with FIELD access)

Atom Feed Namespace Support

• ✅ AtomEntryDto: Enhanced to dynamically add xmlns:espi and xmlns:cust namespace declarations
• Auto-computes appropriate namespace based on resource type (usage vs customer)
• Supports both ESPI usage namespace (http://naesb.org/espi) and customer namespace (http://naesb.org/espi/customer)

ESPI Resource Type Mappings

• ✅ @JsonSubTypes: Expanded to include all 17 ESPI resources:
  • 9 Usage resources: ApplicationInformation, Authorization, ElectricPowerQualitySummary, IntervalBlock, MeterReading, ReadingType, TimeConfiguration, UsagePoint, UsageSummary
  • 8 Customer resources: Customer, CustomerAccount, CustomerAgreement, EndDevice, Meter, ProgramDateIdMappings, ServiceLocation, Statement
  • Note: TimeConfigurationDto supports BOTH espi:TimeConfiguration and cust:TimeConfiguration namespaces

Test Updates

• Updated test assertions to accommodate namespace attributes in entry elements
• Fixed accessor method syntax (getter methods → record accessors)

Benefits

• 100% Record Adoption: All 36 DTOs now use consistent record pattern
• Code Reduction: Eliminated 141 lines of boilerplate code (341 insertions, 482 deletions)
• Improved Maintainability: Simplified namespace handling with auto-computed attributes
• Full Compatibility: Maintains Jackson 3 XmlMapper and ESPI 4.0 compliance

Testing

✅ All tests passing (554/554)

• TimeConfigurationDtoTest: 11/11 tests
• Jackson3XmlMarshallingTest: 7/7 tests
• DtoExportServiceImplTest: 6/6 tests
• Full test suite: No regressions

Files Changed

• AtomEntryDto.java - Added dynamic namespace support
• TimeConfigurationDto.java - Converted to record
• UsagePointDto.java - Converted to record
• TimeConfigurationDtoTest.java - Updated test assertions
• Jackson3XmlMarshallingTest.java - Updated test assertions
• DtoExportServiceImplTest.java - Updated test assertions

🤖 Generated with Claude Code