DomTrip Documentation

Welcome to the complete documentation for DomTrip, the lossless XML editing library for Java that preserves every detail of your XML documents during round-trip operations.

🚀 Getting Started

Perfect for developers new to DomTrip:

• Installation - Add DomTrip to your project in minutes
• Quick Start - Your first DomTrip program with examples
• Basic Concepts - Understanding DomTrip's unique approach

⭐ Core Features

Discover what makes DomTrip special:

• Lossless Parsing - Perfect round-trip preservation of all formatting
• Formatting Preservation - Maintaining original whitespace and style
• Stream Support - InputStream/OutputStream processing with encoding detection
• Namespace Support - Comprehensive XML namespace handling

🏗️ Advanced Topics

For power users and complex scenarios:

• Factory Methods - Object creation patterns and document factories
• Builder Patterns - Fluent APIs for creating complex XML structures
• Library Comparison - How DomTrip compares to DOM4J, JDOM, and others
• Migration Guide - Step-by-step migration from other XML libraries

📚 API Reference

Complete API documentation:

• Editor API - Main entry point for XML editing operations
• Configuration - Customizing DomTrip behavior and presets

📖 Examples & Use Cases

Real-world examples and patterns:

• Examples - Common XML editing scenarios with code samples

🎯 Quick Navigation

By Use Case

• Configuration File Editing → Quick Start + Examples
• Maven POM Manipulation → Examples + Factory Methods
• SOAP Message Processing → Namespace Support
• XML Transformation Tools → Lossless Parsing

By Experience Level

• New to DomTrip → Installation → Quick Start
• Migrating from other libraries → Library Comparison → Migration Guide
• Advanced usage → Factory Methods → Configuration

💡 Key Benefits

• 🔄 Perfect Round-Trip: Unmodified sections remain completely unchanged
• 📝 Format Preservation: Only modified sections are reformatted
• 🏗️ Modern API: Fluent builders, Stream navigation, Optional returns
• 🌐 Namespace Aware: Comprehensive namespace handling and resolution
• ⚙️ Configurable: Multiple serialization options and presets
• 🧪 Well Tested: 100% test coverage with 59 passing tests

🆘 Getting Help

• 🐛 Report Issues - Found a bug or have a feature request?
• 💬 Discussions - Ask questions and share ideas
• 📧 Contact - Direct support for enterprise users