davsclaus opened a new pull request, #28026:
URL: https://github.com/apache/camel/pull/28026
Fourth part of CAMEL-25736: YAML examples for 37 more components whose
documentation had none. `camel_catalog_sample` reads its samples from the
documentation, so it had nothing to give for them.
The components:
- IoT and protocols: coap (with coaps, coap+tcp and coaps+tcp), milo-browse,
milo-client, milo-server, plc4x, mllp, as2, cometd, quickfix, pulsar, tahu-edge
and tahu-host.
- Databases and AI: duckdb, clickhouse, neo4j, qdrant, milvus, kudu, drill,
pinecone, weaviate, langchain4j-ingest, typesafe-ai and fhir.
- Cache, security and others: hazelcast-set, ignite-cache, ignite-compute,
ignite-idgen, ignite-queue, ignite-set, ignite-events, ignite-messaging, opa,
openfga, openfeature, citrus and rest-postman.
## What
- A Java example of a route gets a YAML tab next to it. Test code and Java
setup code (builders, processors, `ProducerTemplate` calls) stay Java-only.
- A page without a route example gets a short Usage section with one.
- Every example was checked in the code of the component. Most were run with
`camel run`, with embedded servers (coap, OPC UA, MLLP, AS2, CometD,
QuickFIX/J, DuckDB, Hazelcast, Ignite) or `camel infra` (Pulsar, Mosquitto,
ClickHouse, Neo4j, Qdrant, OPA, OpenFGA).
## What the runs found in the pages
- **neo4j:** the Java examples sent Cypher-style maps such as `{name:
'Alice'}` in the body and in the `CamelNeo4jMatchProperties` header. The
component parses both as JSON, so the examples failed with "Failed to parse
body as JSON". They use JSON now.
- **neo4j and milvus:** three examples called `.transform(new
DataType(...))`, which does not compile. The Java DSL method is
`transformDataType`.
- **coap:** the rule "GE" is GET, the Java example called
`setCconfigurationFile`, and a word was misspelled.
- **plc4x:** a sentence about a bucket was copied from another page.
- **hazelcast-set:** `removeAll` was listed twice and `removeValue` was
missing.
- **milo-client:** a read without `CamelMiloAwait` (or `defaultAwaitWrites`)
returns before the value arrives. The page now says so.
The catalog copies of the 37 pages are updated with them.
## Checks
- Every new example passes `camel_validate_source`, also as read back from
the page.
- Run with `camel run`: 29 of the 37 pages. Validated only: kudu, drill,
pinecone, milvus, langchain4j-ingest and typesafe-ai (they need a server or a
model that was not practical here), and ignite-compute, ignite-events and
ignite-messaging.
- On a full reactor build, the tests of camel-catalog (1101),
camel-yaml-dsl-validator (240), camel-jbang-core (2511) and camel-jbang-mcp
(503) pass, `CatalogDocExamplesTest` included.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
https://claude.ai/code/session_01STT6whBgK1AqsSsUKrnE8m
--
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]
