[
https://issues.apache.org/jira/browse/CAMEL-25182?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18121156#comment-18121156
]
Claus Ibsen commented on CAMEL-25182:
-------------------------------------
PR: https://github.com/apache/camel/pull/27130
Adds CatalogDocJavaExamplesTest, which replays the Java route examples of the
docs (catalog pages and user manual) through LwJavaParser. Also: about 30 doc
example fixes, univocityCsv/Fixed/Tsv() and yaml() on the data format clause,
and parser improvements found by the check.
_Claude Code on behalf of davsclaus_
> Check the Java DSL examples of the documentation with the Java DSL parser
> -------------------------------------------------------------------------
>
> Key: CAMEL-25182
> URL: https://issues.apache.org/jira/browse/CAMEL-25182
> Project: Camel
> Issue Type: Improvement
> Components: documentation
> Reporter: Claus Ibsen
> Assignee: Claus Ibsen
> Priority: Minor
>
> The YAML and XML route examples of the documentation are validated in the
> build, but the Java examples are only import-checked (CAMEL-24774).
> The Java DSL parser of CAMEL-25148 (LwJavaParser in camel-java-io) reads Java
> DSL source into the model without compiling it. Running it over the docs:
> 4182 Java blocks, 2882 with route DSL, 2150 read completely. Most of the rest
> is by design (lambdas, helper methods, variables). About 60 examples call a
> DSL method that does not exist or with arguments it does not take, for
> example:
> * setBody("Ciao") instead of setBody(constant("Ciao")) (aws2-translate,
> hwcloud, jdbc)
> * filter("${header.login} == true") (aws2-sqs), thread(5) (seda, disruptor),
> onException(ValidationException)
> * .marshal().univocityCsv() / univocityTsv() / univocityFixed() and
> .marshal().yaml(): the data format clause has no such methods (only the
> dataFormat() builder factory has them)
> * doCatch after policy(...) without end(), missing parentheses, removed API
> (exceptionPolicyStrategy, jq with header name, resumable(...).intermittent)
> This issue:
> * adds a build test that parses the Java examples of the catalog docs and
> fails on calls the Java DSL does not have;
> * fixes the documentation examples;
> * adds the missing Java DSL convenience methods;
> * improves the parser where the examples show a gap (char literals,
> Map.of/List.of, a few JDK constants).
> _Claude Code on behalf of davsclaus_
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
