CAMEL-23535: camel-api - batch 3: enhance class-level javadoc for endpoint/component/producer/consumer types

[ammachado]

Description

Batch 3 of the CAMEL-23535 javadoc enhancement series. This PR improves class-level javadoc for 24 types in the endpoint, component, producer, and consumer family in core/camel-api/src/main/java/org/apache/camel/.

Changes by type:

• Major rewrites (minimal or missing javadoc before): Producer, Consumer, AsyncProducer, AsyncEndpoint, BatchConsumer, DelegateEndpoint, DelegateProcessor, ApiEndpoint, ComponentAware, EndpointAware
• Moderate expansion (terse opener + added context): Component, DynamicPollingConsumer, ResolveEndpointFailedException, NoSuchEndpointException, FailedToCreateRouteFromTemplateException
• @see-tag additions only (already had rich prose): Endpoint, Processor, AsyncProcessor, AsyncCallback, PollingConsumer, Channel, MultipleConsumersSupport, ShutdownRoute, ShutdownRunningTask

This is a comment-only change. No production code, method signatures, or annotations are modified.

Related PRs in this series:

• Batch 1 (lifecycle & context): merged
• Batch 2 (messaging core): CAMEL-23535: camel-api - enhance class-level javadoc for messaging core types (batch 2) #23330

Claude Code on behalf of Adriano Machado

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 clean install -DskipTests locally from root folder and I have committed all auto-generated changes.

[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.

[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