ammachado opened a new pull request, #24060: URL: https://github.com/apache/camel/pull/24060
# Description Continues the systematic Javadoc improvement of `core/camel-api` started in CAMEL-23535. This PR adds comprehensive class-level Javadoc to 19 SPI types across three logical batches: **Batch 13 — JMX Management SPIs** `ManagementAgent`, `ManagementStrategy`, `ManagementStrategyFactory`, `ManagementNameStrategy`, `ManagementObjectStrategy`, `ManagementObjectNameStrategy`, `ManagementMBeanAssembler`, `ManagementInterceptStrategy` Documents the two-level management design (strategy = high-level coordinator, agent = low-level JMX bridge), the ObjectName construction pipeline, and the instrumentation wrapping used for EIP statistics collection. **Batch 14 — Threading and Scheduling SPIs** `ExecutorServiceManager`, `ThreadPoolProfile`, `ThreadPoolFactory`, `BackOffTimerFactory`, `ScheduledPollConsumerScheduler`, `ReactiveExecutor` Documents the layering between the high-level manager (Camel concepts: profiles, naming, lifecycle) and the low-level factory (pure JDK types, designed for JEE WorkManager substitution), plus the reactive executor's async dispatch model. **Batch 15 — Observability SPIs** `EventNotifier`, `EventFactory`, `Tracer`, `CamelLogger`, `CamelMDCService` Documents the producer/consumer split between `EventFactory` (mints event objects) and `EventNotifier` (reacts to them), the `Tracer` before/after node interception model and standby mode, and `CamelMDCService`'s role in propagating MDC context across async continuation threads. All types now include at least one link to the relevant Camel user manual page and `@see` cross-references to related sibling types. No method signatures, annotations, or non-Javadoc code were changed. # 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-23535) 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. _Claude Code on behalf of Adriano Machado_ -- 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]
