Claus Ibsen created CAMEL-25264:
-----------------------------------
Summary: docs, camel-jbang - samples for the HTTP rungs: REST
status codes, JsonPath YAML, calling a rest-openapi operation, the call-service
intent
Key: CAMEL-25264
URL: https://issues.apache.org/jira/browse/CAMEL-25264
Project: Camel
Issue Type: Improvement
Components: camel-jbang
Reporter: Claus Ibsen
Fix For: 4.23.0
Found while preparing the HTTP rungs for a local model (CAMEL-24886). The
samples and docs the authoring tools serve ({{camel_catalog_sample}},
{{camel_catalog_doc}}) either have nothing to copy for these rungs or show a
broken form:
# rest-dsl.adoc: five YAML examples have {{path: "/{id}}"}}, with a stray
closing brace. {{camel_catalog_sample rest}} serves one of them.
# The REST DSL page does not show how to return an HTTP status code from a rest
route ({{CamelHttpResponseCode}}). The model needs it for the 404 of stock-api
and the 409 of openapi-server.
# jsonpath-language.adoc: the examples have no YAML tab, so the only JsonPath
sample is the {{${jsonpath()}}} Simple function. There is no {{jsonpath:}}
filter expression with an inlined {{${header.x}}} and a {{resultType}}.
# rest-openapi-component.adoc: no example of calling an operation from a route
(producer). The only one is a Spring Boot ProducerTemplate.
# {{camel_catalog_sample}} maps "call service", "call" and "http call" to the
enrich EIP, whose first sample needs a custom aggregation-strategy bean.
Calling an HTTP service is a {{to:}}/{{toD:}} to {{http:}}.
The doc examples are validated in the build and become the served samples.
_Claude Code on behalf of davsclaus_
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
