davsclaus opened a new pull request, #29174: URL: https://github.com/apache/camel/pull/29174
https://issues.apache.org/jira/browse/CAMEL-26592 Two documentation fixes, text only. **apiContextPath** - The description was "Sets a leading context-path the REST API will be using.", which does not say what the option does. In the local-model benchmark (rest-code-first step 3: serve the OpenAPI document), the models looked up this option 6 and 23 times and did not use it. - Now: "The path, such as /api-doc, where the REST DSL serves the API documentation of the REST services, as an OpenAPI document. The API documentation is only served when this option is set. This requires camel-openapi-java on the classpath. The document is JSON by default, or YAML when the request path ends with .yaml. The path is relative to contextPath, when that option is set." - Checked on a running app: with contextPath /api and apiContextPath /api-doc, /api/api-doc serves JSON and /api-doc gives 404; /api/api-doc.yaml gives YAML; without camel-openapi-java the route fails to start ("Cannot find RestApiProcessorFactory ..."). - The same text is now on restConfiguration in the model (and its builder javadoc), on camel.rest.apiContextPath in camel-main and camel-api's RestConfiguration (whose javadoc repeated the contextPath text), and in the options table of rest-dsl-binding.adoc. The generated copies (catalog, XML and YAML schemas, YAML deserializers, main metadata, eip-samples.json) come from the build. **pollEnrich: read the same file again** - "Poll Enrich with Dynamic Endpoints" reads a file per customer with `noop=true`. With `noop=true` alone the file endpoint turns on `idempotent`, so the next order of the same customer does not find the file again. Checked on a running route: orders 2 and 3 got null after the timeout, and FileEndpoint logs "forcing endpoint to be idempotent". - The Java, XML and YAML tabs now add `idempotent=false`, and the text says why both options are needed and what the timeout does. 20 files, +52/-35. Each file changes only these texts. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_016Y4dDi5iQNgtHrDdz2NpwF -- 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]
