Claus Ibsen created CAMEL-25783:
-----------------------------------
Summary: camel-jms - the docs show how to connect to a broker: a
connection factory in YAML, application.properties and Java
Key: CAMEL-25783
URL: https://issues.apache.org/jira/browse/CAMEL-25783
Project: Camel
Issue Type: Improvement
Components: documentation, camel-jms
Reporter: Claus Ibsen
Assignee: Claus Ibsen
Fix For: 4.24.0
The jms page does not show how to connect to a broker in YAML,
application.properties or Java, and the AI tools have nothing to answer with.
In a benchmark of Oct 18-19 2026 (a local model building a JMS request-reply
example on ActiveMQ Artemis), the step that connects to the broker passed 0 of
8 times. The model spent all 25 tool calls searching: {{camel_catalog_doc jms}}
for connectionFactory, brokerUrl and broker, and {{camel_catalog_find}} for
"artemis", "infra jms" and "jms connectionFactory". Every find answered
"Nothing in the catalog matches".
What the page has today:
* No example of a connection factory in YAML or application.properties.
* The section "Configuring different JMS providers" says "You can configure
your JMS provider in Spring XML as follows:", and no example follows. The text
after it refers to "the preceding example".
* "Using ActiveMQ" is about Spring's JmsTemplate and ActiveMQ Classic.
What the example needed, which works with camel run as it is:
{noformat}
camel.beans.artemisCF =
#class:org.apache.activemq.artemis.jms.client.ActiveMQConnectionFactory
camel.beans.artemisCF.brokerURL = tcp://localhost:61616
camel.beans.artemisCF.user = artemis
camel.beans.artemisCF.password = artemis
camel.component.jms.connection-factory = #bean:artemisCF
{noformat}
The plan:
# A "Connecting to a broker" section near the start of Usage, as
camel_catalog_doc returns the start of a page: the connection factory in
application.properties, YAML ({{- beans:}}) and Java, for ActiveMQ Artemis (the
broker {{camel infra run artemis}} starts), and a line on other brokers (their
own ConnectionFactory class).
# The Spring XML section gets its example back, or goes.
# camel_catalog_find finds jms for "artemis" (and the other brokers the page
names).
Found while building connect-service/jms-request-reply
(apache/camel-jbang-examples#115).
_Claude Code on behalf of davsclaus_
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
