Croway opened a new pull request, #30074:
URL: https://github.com/apache/camel/pull/30074

   User manual pages that say something the code does not do:
   
   - **stream-caching.adoc**: said "remember to enable" stream caching and that 
big payloads are spooled by default. Stream caching is on by default 
(`AbstractCamelContext.streamCache = TRUE`, since 3.17) and spooling needs 
`spoolEnabled=true`. The page now says how to turn it off, and has a section on 
reading the body twice in one processor: `StreamCachingAdvice` resets the cache 
before and after each step, not within one, so use 
`ExchangeHelper.getBodyAndResetStreamCache` or `MessageHelper.resetStreamCache`.
   - **bean-binding.adoc**: removed "the return type must be *void*" for a 
single `Exchange` parameter (contradicts the rule at the top of the page). 
Added what `MethodInfo`/`BeanInfo` do: an unquoted word is passed as that text, 
a quoted `'${header.x}'` is text (so binding to an object type fails), and 
`name` vs `name()` picks the overload with or without a parameter. One 
method-with-parameters example now has XML and YAML tabs.
   - **producertemplate.adoc**: said `sendBody`/`requestBody` do not rethrow. 
They throw `CamelExecutionException` with the cause 
(`ExchangeHelper.extractResultBody`); only `send`/`request` with an `Exchange` 
or `Processor` return the failed exchange.
   - **oncompletion.adoc**: said a route-scoped onCompletion runs in a separate 
thread, concurrently. Without `parallelProcessing`/`executorService` it runs 
synchronously in the completing thread (`OnCompletionProcessor`, 
`executorService == null`).
   - **using-propertyplaceholder.adoc**: taught the `prop:` placeholder 
namespace, removed in 3.1, which now fails XSD validation. Every XML DSL 
attribute is a string, so `stopOnException="{{stop}}"` works directly (as 
`SpringOptionalPropertiesDslTest.xml` does).
   - **Route policy pages**: `routeStopTimeUnit` is really `timeUnit` 
(`ScheduledRoutePolicy`); the XML example used a class that does not exist 
(`SimpleDate`); the simple policy example lacked `noAutoStartup` and its YAML 
had no bean; the Quartz cron format (seconds first, `?`) is now stated; the 
examples use a JMS/file consumer with a note that a policy never creates a 
message. `route-policy.adoc` gets a `ThrottlingExceptionRoutePolicy` section 
with its options and an example, and the `routePolictRef` typo is fixed.
   - **Testing pages**: `@UseAdviceWith` is only read with 
`@CamelSpringTest`/`@CamelSpringBootTest` (`CamelAnnotationsHandler`), not on a 
`CamelSpringTestSupport` subclass; the page now shows 
`testConfiguration().withUseAdviceWith(true)` (the method was also misnamed 
`isUsedAdviceWith`). `mock-component.adoc` names 
`org.apache.camel.component.mock.InterceptSendToMockEndpointStrategy` (the 
class moved in CAMEL-13469) and links the DataSet Test endpoint; `testing.adoc` 
labels the JUnit 6 modules correctly. Catalog copy of `mock-component.adoc` 
regenerated.
   
   _Claude Code on behalf of Federico Mariani_
   


-- 
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]

Reply via email to