[jira] [Created] (CAMEL-25865) camel-jbang - the tools and the Simple docs say how to read a data file: constant with resource:file:, and load() under camel run

["Claus Ibsen (Jira)" <ji...@apache.org>]

Claus Ibsen created CAMEL-25865:
-----------------------------------

             Summary: camel-jbang - the tools and the Simple docs say how to read a data file: constant with resource:file:, and load() under camel run
                 Key: CAMEL-25865
                 URL: https://issues.apache.org/jira/browse/CAMEL-25865
             Project: Camel
          Issue Type: Improvement
          Components: camel-jbang, camel-core
            Reporter: Claus Ibsen
             Fix For: 4.24.0


A route that needs a data file, such as a lookup table (stock.json), reads it with the constant language: {{resource:file:stock.json}}, for example in a {{setVariable}}. That recipe is only on the page of the constant language. The tools point elsewhere:
* {{camel_catalog_doc file}} says "to consume one message in the middle of a route use the poll EIP (poll: {uri: ...}), or pollEnrich";
* a consumer option on a {{to: file:...}} (such as fileName with noop) gets "to read from an endpoint in the middle of a route use the poll EIP, or pollEnrich".
The poll EIP consumes the file (it is moved away without noop), which is not what a lookup needs.

The Simple docs say that {{load()}} "can only load from classpath; and not the file-system". That is so, but with Camel JBang, {{camel run}} puts the files of the project on the classpath ("Additional files added to classpath: ..."), so {{${load(stock.json)}}} reads a stock.json next to the routes. The docs do not say it.

Found in a benchmark of Oct 19-20 2026: in a JMS example, 7 of 12 runs tried to load stock.json and failed; no run opened the constant page.

Proposal:
* For the file component, both hints add: to read a data file the route needs, such as a lookup table, use the constant language with resource:file: (such as setVariable with constant: resource:file:stock.json). Other components keep their hint.
* The Simple docs say that camel run puts the files of the project on the classpath, and point to resource:file: of the constant language to read a file of the file system in any runtime.

_Claude Code on behalf of davsclaus_



--
This message was sent by Atlassian Jira
(v8.20.10#820010)