ammachado opened a new pull request, #23823: URL: https://github.com/apache/camel/pull/23823
# Description Continues the systematic Javadoc enhancement of `core/camel-api` started in [CAMEL-23535](https://issues.apache.org/jira/browse/CAMEL-23535). **Batch 8 — Registry and dependency injection SPIs (9 files):** - `BeanRepository` — pluggable bean lookup contract, foundation of Camel's Registry - `BeanIntrospection` — reflection-based property read/write, internal to property binding - `BeanProcessorFactory` — creates processors that invoke bean methods via `.bean()` DSL - `BeanProxyFactory` — creates dynamic proxies that route method calls to Camel endpoints - `ComponentResolver` — lazy-loads components by URI scheme from META-INF service files - `ComponentNameResolver` — enumerates available component names without instantiating them - `Configurer` — annotation triggering build-time `PropertyConfigurer` code generation - `ConfigurerResolver` — resolves generated `PropertyConfigurer` by type name - `ConfigurerStrategy` — manages bootstrap-phase configurers and post-startup memory reclamation **Batch 9 — Route lifecycle and control SPIs (10 files):** - `RouteController` — central SPI for start/stop/suspend/resume/reload of all routes - `SupervisingRouteController` — adds backoff-retry startup supervision and health-check integration - `RoutePolicy` — per-route lifecycle hook for dynamic runtime control (throttling, scheduling, etc.) - `RoutePolicyFactory` — global factory that assigns policies to every route at startup - `ShutdownStrategy` — performs the graceful shutdown sequence; SPI for framework integrators - `ShutdownRoute` — per-route enum: stop immediately (`Default`) or defer (`Defer`) - `ShutdownRunningTask` — per-consumer policy: finish current task only or drain the full batch - `StartupCondition` — pluggable gate that pauses context startup until a prerequisite is met - `StartupStepRecorder` — records named startup spans for JFR/tooling diagnostics - `RouteStartupOrder` — carries ordered startup metadata used by `ShutdownStrategy` Each file received: a clear opening sentence naming the type's role, an architecture-context paragraph, `{@link}` cross-references, at least one user-manual URL where applicable, and `@see` tags for sibling types. _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-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. -- 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]
