ammachado opened a new pull request, #23968: URL: https://github.com/apache/camel/pull/23968
# Description Continues [CAMEL-23535](https://issues.apache.org/jira/browse/CAMEL-23535) — systematic enhancement of class-level Javadoc across `core/camel-api`. This PR covers three batches: **Batch 10 — Data transformation SPIs** (`DataFormat`, `DataFormatFactory`, `DataFormatName`, `Transformer`, `TransformerRegistry`, `TransformerKey`, `Validator`, `ValidatorRegistry`) - Added architecture context linking marshal/unmarshal to the data format contract mechanism - Updated old-style URLs (`camel.apache.org/data-format.html`) to current `/manual/` path - Fixed malformed `@see {@link ...}` tag in `Validator.java` (mixed two Javadoc tag styles) **Batch 11 — Exchange processing and EIP storage SPIs** (`ExchangeFactory`, `ProcessorExchangeFactory`, `ExchangeFormatter`, `MessageHistoryFactory`, `StreamCachingStrategy`, `AggregationRepository`, `ClaimCheckRepository`, `IdempotentRepository`) - Documented the pooled vs. default exchange lifecycle strategies - Added Aggregator EIP lifecycle (get → add → remove → confirm) with persistent implementation pointers - Documented ClaimCheck keyed vs. stack access styles - Documented IdempotentRepository eager vs. non-eager processing modes - Updated old-style URLs (`stream-caching.html`, `claim-check.html`, `idempotent-consumer.html`) to current `/manual/` path **Batch 12 — Error handling and debugging SPIs** (`ErrorHandler`, `ExceptionHandler`, `BacklogDebugger`, `Debugger`, `Breakpoint`, `BacklogTracer`, `BacklogTracerEventMessage`) - Clarified `ErrorHandler` vs. `ExceptionHandler` distinction (route-level vs. consumer/async-level) - Documented `Debugger` → `BacklogDebugger` → `BacklogTracer` layering with cross-references - Added suspend-mode startup behavior for `BacklogDebugger` (CAMEL_DEBUGGER_SUSPEND env var) - Added first/last event pair semantics to `BacklogTracerEventMessage` All changes are Javadoc-only. No production logic was modified. _Claude Code on behalf of Adriano Machado_ # Target - [x] I checked that the commit is targeting the correct branch (Camel 4 uses the `main` branch) # Tracking - [x] If this is a large change, bug fix, or code improvement, I checked there is a [JIRA issue](https://issues.apache.org/jira/browse/CAMEL) filed for the change (usually before you start working on it). # Apache Camel coding standards and style - [x] I checked that each commit in the pull request has a meaningful subject line and body. - [x] I have run `mvn clean install -DskipTests` locally from root folder and I have committed all auto-generated changes. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
