CAMEL-23535: camel-api - batches 26-30: enhance class-level and method-level Javadoc for customizer, reload, data-type, marker, and interceptor SPIs

[ammachado]

Description

Continues CAMEL-23535.

This PR covers batches 26-30: 24 files in core/camel-api (package org.apache.camel.spi) received enhanced class-level and method-level Javadoc. The changes are documentation-only; no method signatures, annotations, or production code were altered.

Batch 26 — Customizer SPIs
CamelContextCustomizer, ComponentCustomizer, DataFormatCustomizer, LanguageCustomizer, CamelContextNameStrategy

Batch 27 — Context tracking and reload SPIs
CamelContextTracker (incl. the Filter interface and the static notify methods), ContextReloadStrategy, ReloadStrategy, BootstrapCloseable, StartupConditionStrategy

Batch 28 — Data type and transformation SPIs
Contract, DataTypeTransformer, and a user-manual link added to DataType

Batch 29 — Id/group marker SPIs
HasId, HasGroup, IdAware, RouteIdAware, StepIdAware, GroupAware

Batch 30 — Interceptor SPIs
InterceptStrategy, InterceptableProcessor, InterceptEndpointFactory, InterceptSendToEndpoint, AutoMockInterceptStrategy

Each file received:

• Class-level: an opening sentence naming its role, an architecture paragraph with {@link} references and explanation of callers/lifecycle, a user-manual <a href> link where a matching page exists (camelcontext-autoconfigure, context-reload, transformer), @see cross-references, and preserved @since tags.
• Method-level: documentation added for the public methods that were undocumented or terse (e.g. CamelContextTracker's Filter/static notify methods, Contract getters). Method Javadoc that was already adequate was left unchanged, per the agreed gaps-only approach.

Several types in these themes already had complete Javadoc (e.g. DataType, DataTypeAware, TransformerLoader, TransformerResolver, ContextServicePlugin, ContextServiceLoaderPluginResolver) and were intentionally left untouched. Marker/identity SPIs with no matching user-manual page intentionally omit an <a href>.

Verification for each batch: style matched against previously enhanced files, mvn formatter:format impsort:sort touched only the intended files, and mvn compile on core/camel-api passed. Class- and method-level Javadoc does not affect generated catalog files, so no generated changes were produced.

Target

• I checked that the commit is targeting the correct branch (Camel 4 uses the main branch)

Tracking

• If this is a large change, bug fix, or code improvement, I checked there is a JIRA issue filed for the change (usually before you start working on it).

Apache Camel coding standards and style

• I checked that each commit in the pull request has a meaningful subject line and body.
• I have run mvn formatter:format impsort:sort and mvn compile on core/camel-api locally and committed all changes. (Documentation-only change; no auto-generated files are affected.)

Claude Code on behalf of Adriano Machado

[github-actions]

🌟 Thank you for your contribution to the Apache Camel project! 🌟
🤖 CI automation will test this PR automatically.

🐫 Apache Camel Committers, please review the following items:

• First-time contributors require MANUAL approval for the GitHub Actions to run
• You can use the command /component-test (camel-)component-name1 (camel-)component-name2.. to request a test from the test bot although they are normally detected and executed by CI.
• You can label PRs using skip-tests and test-dependents to fine-tune the checks executed by this PR.
• Build and test logs are available in the summary page. Only Apache Camel committers have access to the summary.

⚠️ Be careful when sharing logs. Review their contents before sharing them publicly.

[davsclaus]

Clean Javadoc-only PR covering batches 26-30 of CAMEL-23535. All 24 files are documentation improvements with no production code or signature changes. <p/> style is consistent with the codebase, user-manual links resolve correctly, @since tags are preserved, and @see cross-references are bidirectional where appropriate. LGTM.

This review was generated by an AI agent and may contain inaccuracies. Please verify all suggestions before applying.

[github-actions]

🧪 CI tested the following changed modules:

• core/camel-api

ℹ️ Dependent modules were not tested because the total number of affected modules exceeded the threshold (50). Use the test-dependents label to force testing all dependents.

---

⚙️ View full build and test results