This is an automated email from the ASF dual-hosted git repository. davsclaus pushed a commit to branch faq2 in repository https://gitbox.apache.org/repos/asf/camel.git
commit ac01343cb92697e18260ca31ee027b8576b72526 Author: Claus Ibsen <[email protected]> AuthorDate: Sat Mar 7 12:04:07 2026 +0100 CAMEL-16861: Cleanup docs --- .../camel-ftp/src/main/docs/ftp-component.adoc | 5 +++ docs/user-manual/modules/ROOT/pages/jmx.adoc | 16 ++++++++ .../modules/ROOT/pages/producertemplate.adoc | 19 +++++++++ .../management/ManagedCustomProcessorTest.java | 1 - docs/user-manual/modules/faq/nav.adoc | 19 --------- .../modules/faq/pages/how-do-i-use-log4j.adoc | 46 ---------------------- ...how-does-camel-look-up-beans-and-endpoints.adoc | 20 ---------- .../modules/faq/pages/how-does-camel-work.adoc | 4 -- .../faq/pages/how-does-the-website-work.adoc | 5 --- ...hould-i-invoke-my-pojos-or-spring-services.adoc | 15 ------- .../how-to-create-executable-jar-camel-main.adoc | 41 ------------------- ...end-the-same-message-to-multiple-endpoints.adoc | 33 ---------------- docs/user-manual/modules/faq/pages/index.adoc | 36 +---------------- .../modules/faq/pages/is-there-an-ide.adoc | 12 ------ ...when-adding-and-removing-routes-at-runtime.adoc | 9 ----- .../modules/faq/pages/what-is-a-router.adoc | 22 ----------- .../modules/faq/pages/what-is-the-license.adoc | 5 --- .../faq/pages/what-platforms-are-supported.adoc | 5 --- .../pages/why-cant-i-use-sign-in-my-password.adoc | 9 ----- ...my-message-lose-its-headers-during-routing.adoc | 3 -- ...use-too-many-threads-with-producertemplate.adoc | 28 ------------- ...-does-ftp-component-not-download-any-files.adoc | 7 ---- .../why-does-maven-not-download-dependencies.adoc | 9 ----- ...jms-route-only-consume-one-message-at-once.adoc | 16 -------- ...is-my-processor-not-showing-up-in-jconsole.adoc | 32 --------------- .../faq/pages/why-use-multiple-camelcontext.adoc | 14 ------- 26 files changed, 41 insertions(+), 390 deletions(-) diff --git a/components/camel-ftp/src/main/docs/ftp-component.adoc b/components/camel-ftp/src/main/docs/ftp-component.adoc index 8722b4f3c49e..81e475d39103 100644 --- a/components/camel-ftp/src/main/docs/ftp-component.adoc +++ b/components/camel-ftp/src/main/docs/ftp-component.adoc @@ -544,6 +544,11 @@ String data = template.retrieveBodyNoWait("ftp://admin@localhost:21/nolist/?pass This component has log level *TRACE* that can be helpful if you have problems. +=== Why does FTP component not download any files? + +The xref:components::ftp-component.adoc[FTP] component has many options. So make sure you have configured it properly. +Also, a common issue is that you have to use either active or passive mode. So you may have to set `passiveMode=true` on the endpoint configuration. + == Examples In the sample below, we set up Camel to download all the reports from the diff --git a/docs/user-manual/modules/ROOT/pages/jmx.adoc b/docs/user-manual/modules/ROOT/pages/jmx.adoc index fae600c4d003..9918110fdf56 100644 --- a/docs/user-manual/modules/ROOT/pages/jmx.adoc +++ b/docs/user-manual/modules/ROOT/pages/jmx.adoc @@ -146,6 +146,22 @@ due to the increasing number of MBeans in the registry from its associated services/producers. Keep in mind that an MBean is not a lightweight object and consumes memory. +=== Why is my processor not showing up in JMX? + +Not every processor is managed, and thus not all are visible in JMX, +such as when browsing JConsole. + +A `Processor` must implement the `org.apache.camel.Service` to be managed. + +All EIP that are implemented in `Processor` are a `Service`. + +Your custom `Processor` can implement `Service` or extend `ServiceSupport`, +and information that should be exposed in JMX can be marked up with the following annotations from `camel-management` JAR: + +- `@ManagedResource` - on class level for general information +- `@ManagedAttribute` - for JMX attributes +- `@ManagedOperation` - for JMX operations + == Management naming pattern You can configure a naming pattern for the MBeans names that Camel creates. diff --git a/docs/user-manual/modules/ROOT/pages/producertemplate.adoc b/docs/user-manual/modules/ROOT/pages/producertemplate.adoc index 783a9d684857..13b03f29e680 100644 --- a/docs/user-manual/modules/ROOT/pages/producertemplate.adoc +++ b/docs/user-manual/modules/ROOT/pages/producertemplate.adoc @@ -184,6 +184,25 @@ camel.main.producerTemplateCacheSize = 50 The default maximum cache size is 1000. +== Reusing ProducerTemplate + +When you use a `ProducerTemplate` you should ideally reuse the template for the duration of the lifecycle +of your Camel application. + +A common reason is creating a new `ProducerTemplate` inside a `Processor` or +xref:ROOT:bean-integration.adoc[bean method invocation]. + +You are not meant to create a `ProducerTemplate` for each message +invocation; you are meant to create a single instance on startup and +keep it around. + +When you have finished using the `ProducerTemplate` you should call +the `stop()` method to close down all the resources it has been using. + +If you fail to do so then the Camel application can create more and more resources (threads etc.) + +It's better to either explicitly create one on startup and inject +the `ProducerTemplate` into your `Processor` or bean, for the template to be reused. == See Also diff --git a/docs/user-manual/modules/faq/examples/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java b/docs/user-manual/modules/faq/examples/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java deleted file mode 120000 index e976af7636ff..000000000000 --- a/docs/user-manual/modules/faq/examples/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java +++ /dev/null @@ -1 +0,0 @@ -../../../../../../../../../../../../../../core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java \ No newline at end of file diff --git a/docs/user-manual/modules/faq/nav.adoc b/docs/user-manual/modules/faq/nav.adoc index d39c2d9c0eab..082415cfa567 100644 --- a/docs/user-manual/modules/faq/nav.adoc +++ b/docs/user-manual/modules/faq/nav.adoc @@ -2,40 +2,21 @@ ** xref:can-i-get-commercial-support.adoc[Can I get commercial support?] ** link:/community/support/[How can I get help?] ** xref:how-can-i-get-the-source-code.adoc[How can I get the source code?] -** xref:how-does-camel-work.adoc[How does Camel work?] -** xref:how-does-the-website-work.adoc[How does the website work?] ** xref:how-do-i-become-a-committer.adoc[How do I become a committer?] ** xref:how-do-i-edit-the-website.adoc[How do I edit the website?] ** xref:running-camel-standalone.adoc[Running Camel standalone] -** xref:what-is-a-router.adoc[What is a router?] ** xref:what-is-camel.adoc[What is Camel?] -** xref:what-is-the-license.adoc[What is the license?] ** xref:ROOT:languages.adoc[What languages are supported?] -** xref:what-platforms-are-supported.adoc[What platforms are supported?] ** xref:why-the-name-camel.adoc[Why the name Camel?] -** xref:how-does-camel-look-up-beans-and-endpoints.adoc[How does Camel look up beans and endpoints?] -** xref:how-should-i-invoke-my-pojos-or-spring-services.adoc[How should I invoke my POJOs or Spring Services?] ** xref:how-to-avoid-sending-some-or-all-message-headers.adoc[How to avoid sending some or all message headers?] ** xref:how-to-remove-the-http-protocol-headers-in-the-camel-message.adoc[How to remove the http protocol headers in the camel message?] -** xref:how-to-send-the-same-message-to-multiple-endpoints.adoc[How to send the same message to multiple endpoints?] ** xref:how-to-switch-the-cxf-consumer-between-http-and-https-without-touching-the-spring-configuration.adoc[How to switch the CXF consumer between HTTP and HTTPS without touching the Spring configuration?] ** xref:how-to-use-a-dynamic-uri-in-to.adoc[How to use a dynamic URI in to()?] -** xref:is-there-an-ide.adoc[Is there an IDE?] ** xref:using-getin-or-getout-methods-on-exchange.adoc[Using getIn or getOut methods on Exchange] -** xref:why-cant-i-use-sign-in-my-password.adoc[Why can't I use + sign in my password?] ** xref:why-can-i-not-use-when-or-otherwise-in-a-java-camel-route.adoc[Why can I not use when or otherwise in a Java Camel route?] -** xref:why-does-ftp-component-not-download-any-files.adoc[Why does FTP component not download any files?] ** xref:why-does-my-file-consumer-not-pick-up-the-file-and-how-do-i-let-the-file-consumer-use-the-camel-error-handler.adoc[Why does my file consumer not pick up the file, and how do I let the file consumer use the Camel error handler?] ** xref:why-does-useoriginalmessage-with-error-handler-not-work-as-expected.adoc[Why does useOriginalMessage with error handler not work as expected?] -** xref:why-do-my-message-lose-its-headers-during-routing.adoc[Why do my message lose its headers during routing?] ** xref:why-is-my-message-body-empty.adoc[Why is my message body empty?] -** xref:why-is-my-processor-not-showing-up-in-jconsole.adoc[Why is my processor not showing up in JConsole?] ** xref:why-is-the-exception-null-when-i-use-onexception.adoc[Why is the exception null when I use onException?] -** xref:why-use-multiple-camelcontext.adoc[Why use multiple CamelContext?] -** xref:how-do-i-use-log4j.adoc[How do I use log4j?] -** xref:why-does-my-jms-route-only-consume-one-message-at-once.adoc[Why does my JMS route only consume one message at once?] ** xref:exception-orgapachecamelnosuchendpointexception.adoc[Exception - org.apache.camel.NoSuchEndpointException] ** xref:exception-orgxmlsaxsaxparseexception.adoc[Exception - org.xml.sax.SAXParseException] -** xref:memory-leak-when-adding-and-removing-routes-at-runtime.adoc[Memory leak when adding and removing routes at runtime] -** xref:why-does-camel-use-too-many-threads-with-producertemplate.adoc[Why does Camel use too many threads with ProducerTemplate?] -** xref:why-does-maven-not-download-dependencies.adoc[Why does maven not download dependencies?] diff --git a/docs/user-manual/modules/faq/pages/how-do-i-use-log4j.adoc b/docs/user-manual/modules/faq/pages/how-do-i-use-log4j.adoc deleted file mode 100644 index c6928223b560..000000000000 --- a/docs/user-manual/modules/faq/pages/how-do-i-use-log4j.adoc +++ /dev/null @@ -1,46 +0,0 @@ -= How do I use Log4j? - -Camel uses http://www.slf4j.org/[sfl4j] which allows you to configure -logging via, among others: - -* http://logging.apache.org/log4j/[Log4j] -* http://logback.qos.ch/[Logback] -* https://docs.oracle.com/javase/8/docs/api/java/util/logging/package-summary.html[JDK Util Logging logging] - -The quick way to enable Log4j is to add log4j to your classpath or maven -`pom.xml`. For example the following in your `pom.xml` should do the trick: - -[source,xml] ----- - <dependencies> - <dependency> - <groupId>commons-logging</groupId> - <artifactId>commons-logging</artifactId> - </dependency> - <dependency> - <groupId>log4j</groupId> - <artifactId>log4j</artifactId> - </dependency> - </dependencies> ----- - -Then to configure log4j you need to add a `log4j.properties` or -`log4j.xml` to your classpath (so they go in a directory which is on -your classpath). - -Here's an example `log4j.properties` file: - -[source,java] ----- -log4j.rootLogger=INFO, out - -# -# uncomment the following line to enable debugging of Camel -# -#log4j.logger.org.apache.camel=DEBUG - -log4j.appender.out=org.apache.log4j.ConsoleAppender -log4j.appender.out.layout=org.apache.log4j.PatternLayout -log4j.appender.out.layout.ConversionPattern=[%30.30t] %-30.30c{1} %-5p %m%n -#log4j.appender.out.layout.ConversionPattern=%d [%-15.15t] %-5p %-30.30c{1} - %m%n ----- diff --git a/docs/user-manual/modules/faq/pages/how-does-camel-look-up-beans-and-endpoints.adoc b/docs/user-manual/modules/faq/pages/how-does-camel-look-up-beans-and-endpoints.adoc deleted file mode 100644 index 6d64bb78424e..000000000000 --- a/docs/user-manual/modules/faq/pages/how-does-camel-look-up-beans-and-endpoints.adoc +++ /dev/null @@ -1,20 +0,0 @@ -= How does Camel look up beans, components or endpoints? - -There are many times using Camel that a name is used for a bean such as -using the xref:components::bean-component.adoc[Bean] endpoint or using the -xref:components:languages:bean-language.adoc[Bean Language] to create a -xref:ROOT:expression.adoc[Expression] or xref:ROOT:predicate.adoc[Predicate] or -referring to any xref:ROOT:component.adoc[Component] or -xref:ROOT:endpoint.adoc[Endpoint]. - -Camel uses the xref:ROOT:registry.adoc[Registry] to resolve names when -looking up beans or components or endpoints. - -Lots of test cases in the camel-core module don't use Spring (as -camel-core explicitly doesn't depend on spring) - though test cases in -camel-spring do. - -So you can just define beans, components or endpoints in your -xref:ROOT:registry.adoc[Registry] implementation then you can refer to them -by name in the xref:ROOT:endpoint.adoc[Endpoint] URIs or xref:components::bean-component.adoc[Bean] -endpoints or xref:components:languages:bean-language.adoc[Bean Language] expressions. diff --git a/docs/user-manual/modules/faq/pages/how-does-camel-work.adoc b/docs/user-manual/modules/faq/pages/how-does-camel-work.adoc deleted file mode 100644 index 51ea079d62da..000000000000 --- a/docs/user-manual/modules/faq/pages/how-does-camel-work.adoc +++ /dev/null @@ -1,4 +0,0 @@ -= How does Camel work? - -Please see the xref:ROOT:architecture.adoc[Architecture] for details of how -things work. diff --git a/docs/user-manual/modules/faq/pages/how-does-the-website-work.adoc b/docs/user-manual/modules/faq/pages/how-does-the-website-work.adoc deleted file mode 100644 index 99184fb32365..000000000000 --- a/docs/user-manual/modules/faq/pages/how-does-the-website-work.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= How does the website work? - -The website content sources are distributed across all the camel repositories, and assembled using the Antora and Hugo static site generators, configured in the https://github.com/apache/camel-website repository. - -See xref:how-do-i-edit-the-website.adoc[] for instructions for simple website edits and xref:ROOT:improving-the-documentation.adoc[] for more detailed information and instructions for more complicated edits. diff --git a/docs/user-manual/modules/faq/pages/how-should-i-invoke-my-pojos-or-spring-services.adoc b/docs/user-manual/modules/faq/pages/how-should-i-invoke-my-pojos-or-spring-services.adoc deleted file mode 100644 index 68c48ef1014c..000000000000 --- a/docs/user-manual/modules/faq/pages/how-should-i-invoke-my-pojos-or-spring-services.adoc +++ /dev/null @@ -1,15 +0,0 @@ -= How should I invoke my POJOs or Spring Services? - -The various options are described in detail in -xref:ROOT:bean-integration.adoc[Bean Integration], in particular the -xref:ROOT:bean-binding.adoc[Bean Binding] describes how we invoke a bean -inside a route. - -See the xref:ROOT:pojo-consuming.adoc[POJO Consuming] for examples using -either the `@Consume` annotation or using the routing DSL: - -[source,java] ----- -from("jms:someQueue").bean(MyBean.class, "someMethod"); ----- - diff --git a/docs/user-manual/modules/faq/pages/how-to-create-executable-jar-camel-main.adoc b/docs/user-manual/modules/faq/pages/how-to-create-executable-jar-camel-main.adoc deleted file mode 100644 index fa79582a818a..000000000000 --- a/docs/user-manual/modules/faq/pages/how-to-create-executable-jar-camel-main.adoc +++ /dev/null @@ -1,41 +0,0 @@ -= How to create executable JAR for camel-main project - -== Fat jar with camel-maven-plugin - -In Camel 3.10 onwards you can use the camel-maven-plugin to -(https://github.com/apache/camel/blob/main/tooling/maven/camel-maven-plugin/src/main/docs/camel-maven-plugin.adoc#camelprepare-fatjar)[prepare a fat jar]. - -== Using maven-shade-plugin - -You need to use `maven-shade-plugin` to create executable JAR. -Be aware that uber jar is not fully tested feature and it is Your responsibility to ensure all services are fully functional. -You might need some modifications, depending on Your project structure. - -[source] ----- -<plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-shade-plugin</artifactId> - <version>3.2.1</version> - <executions> - <execution> - <phase>package</phase> - <goals> - <goal>shade</goal> - </goals> - <configuration> - <shadedArtifactAttached>true</shadedArtifactAttached> - <shadedClassifierName>executable-jar</shadedClassifierName> - <transformers> - <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> - <mainClass>my.package.MainClass</mainClass> - </transformer> - <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer"> - <resource>META-INF/services/org/apache/camel/TypeConverterLoader</resource> - </transformer> - </transformers> - </configuration> - </execution> - </executions> -</plugin> ----- diff --git a/docs/user-manual/modules/faq/pages/how-to-send-the-same-message-to-multiple-endpoints.adoc b/docs/user-manual/modules/faq/pages/how-to-send-the-same-message-to-multiple-endpoints.adoc deleted file mode 100644 index 4a32b14b5dc3..000000000000 --- a/docs/user-manual/modules/faq/pages/how-to-send-the-same-message-to-multiple-endpoints.adoc +++ /dev/null @@ -1,33 +0,0 @@ -= How to send the same message to multiple endpoints? - -When you need to send the *same* message to multiple endpoints then you -should use xref:components:eips:multicast-eip.adoc[Multicast]. - -In the sample below we consume messages from the activemq queue `foo` -and want to send the *same message* to both `seda:foo` and `seda:bar`. -Sending the same message requires that we use -xref:components:eips:multicast-eip.adoc[Multicast]. This is done by adding the `multicast()` -before the to type: - -[source,java] ----- -from("activemq:queue:foo").multicast().to("seda:foo", "seda:bar"); ----- - -[NOTE] -==== -**Pipeline is default in Camel** - -If you have a route such as: - -[source,java] ----- -from("activemq:queue:foo").to("seda:foo", "seda:bar"); ----- - -It is by default a xref:components:eips:pipeline-eip.adoc[pipeline] in Camel (that is -the opposite to xref:components:eips:multicast-eip.adoc[Multicast]). In the above example -using pipes and filters then the result from seda:foo is sent to -seda:bar, ie. its not the *same* message sent to multiple destinations, -but a sent through a chain (the pipes and the filters). -==== diff --git a/docs/user-manual/modules/faq/pages/index.adoc b/docs/user-manual/modules/faq/pages/index.adoc index 34ce1fafece0..93d14ebd7776 100644 --- a/docs/user-manual/modules/faq/pages/index.adoc +++ b/docs/user-manual/modules/faq/pages/index.adoc @@ -5,8 +5,7 @@ questions which are not on this list, please talk to us on the link:/community/mailing-list/[Mailing Lists]. We link:/community/contributing/[welcome contributions] and -this entire website is in -xref:how-does-the-website-work.adoc[the GitHub repository you can send a pull request], +this entire website is in the GitHub repository you can send a pull request, so please join in and help us make the documentation better! [[FAQ-GeneralQuestions]] @@ -17,16 +16,11 @@ General questions about Camel * xref:can-i-get-commercial-support.adoc[Can I get commercial support?] * link:/community/support/[How can I get help?] * xref:how-can-i-get-the-source-code.adoc[How can I get the source code?] -* xref:how-does-camel-work.adoc[How does Camel work?] -* xref:how-does-the-website-work.adoc[How does the website work?] * xref:how-do-i-become-a-committer.adoc[How do I become a committer?] * xref:how-do-i-edit-the-website.adoc[How do I edit the website?] * xref:running-camel-standalone.adoc[Running Camel standalone] -* xref:what-is-a-router.adoc[What is a router?] * xref:what-is-camel.adoc[What is Camel?] -* xref:what-is-the-license.adoc[What is the license?] * xref:ROOT:languages.adoc[What languages are supported?] -* xref:what-platforms-are-supported.adoc[What platforms are supported?] * xref:why-the-name-camel.adoc[Why the name Camel?] [[FAQ-UsingCamelQuestions]] @@ -34,41 +28,16 @@ General questions about Camel Questions on using Apache Camel -* xref:how-does-camel-look-up-beans-and-endpoints.adoc[How does Camel look up beans and endpoints?] -* xref:how-should-i-invoke-my-pojos-or-spring-services.adoc[How should I invoke my POJOs or Spring Services?] * xref:how-to-avoid-sending-some-or-all-message-headers.adoc[How to avoid sending some or all message headers?] -* xref:how-to-create-executable-jar-camel-main.adoc[How to create executable JAR for camel-main project?] * xref:how-to-remove-the-http-protocol-headers-in-the-camel-message.adoc[How to remove the http protocol headers in the camel message?] -* xref:how-to-send-the-same-message-to-multiple-endpoints.adoc[How to send the same message to multiple endpoints?] * xref:how-to-switch-the-cxf-consumer-between-http-and-https-without-touching-the-spring-configuration.adoc[How to switch the CXF consumer between HTTP and HTTPS without touching the Spring configuration?] * xref:how-to-use-a-dynamic-uri-in-to.adoc[How to use a dynamic URI in to()?] -* xref:is-there-an-ide.adoc[Is there an IDE?] * xref:using-getin-or-getout-methods-on-exchange.adoc[Using getIn or getOut methods on Exchange] -* xref:why-cant-i-use-sign-in-my-password.adoc[Why can't I use + sign in my password?] * xref:why-can-i-not-use-when-or-otherwise-in-a-java-camel-route.adoc[Why can I not use when or otherwise in a Java Camel route?] -* xref:why-does-ftp-component-not-download-any-files.adoc[Why does FTP component not download any files?] * xref:why-does-my-file-consumer-not-pick-up-the-file-and-how-do-i-let-the-file-consumer-use-the-camel-error-handler.adoc[Why does my file consumer not pick up the file, and how do I let the file consumer use the Camel error handler?] * xref:why-does-useoriginalmessage-with-error-handler-not-work-as-expected.adoc[Why does useOriginalMessage with error handler not work as expected?] -* xref:why-do-my-message-lose-its-headers-during-routing.adoc[Why do my message lose its headers during routing?] * xref:why-is-my-message-body-empty.adoc[Why is my message body empty?] -* xref:why-is-my-processor-not-showing-up-in-jconsole.adoc[Why is my processor not showing up in JConsole?] * xref:why-is-the-exception-null-when-i-use-onexception.adoc[Why is the exception null when I use onException?] -* xref:why-use-multiple-camelcontext.adoc[Why use multiple CamelContext?] - -[[FAQ-LoggingQuestions]] -== Logging Questions - -Questions on logging output from Camel to a console, using the -xref:components::log-component.adoc[Log] endpoint or JDK 1.4 logging or Log4j etc - -* xref:how-do-i-use-log4j.adoc[How do I use log4j?] - -[[FAQ-JMSQuestions]] -=== JMS Questions - -Questions on using the xref:components::jms-component.adoc[JMS] endpoints in Camel - -* xref:why-does-my-jms-route-only-consume-one-message-at-once.adoc[Why does my JMS route only consume one message at once?] [[FAQ-CommonProblems]] == Common Problems @@ -77,6 +46,3 @@ Common Problems that people have when riding the Camel * xref:exception-orgapachecamelnosuchendpointexception.adoc[Exception - org.apache.camel.NoSuchEndpointException] * xref:exception-orgxmlsaxsaxparseexception.adoc[Exception - org.xml.sax.SAXParseException] -* xref:memory-leak-when-adding-and-removing-routes-at-runtime.adoc[Memory leak when adding and removing routes at runtime] -* xref:why-does-camel-use-too-many-threads-with-producertemplate.adoc[Why does Camel use too many threads with ProducerTemplate?] -* xref:why-does-maven-not-download-dependencies.adoc[Why does maven not download dependencies?] diff --git a/docs/user-manual/modules/faq/pages/is-there-an-ide.adoc b/docs/user-manual/modules/faq/pages/is-there-an-ide.adoc deleted file mode 100644 index ccaf261bea86..000000000000 --- a/docs/user-manual/modules/faq/pages/is-there-an-ide.adoc +++ /dev/null @@ -1,12 +0,0 @@ -= Is there an IDE for editing Camel routes? - -Apache Camel offers no IDE out of the box. - -You could use your Java IDE for smart completion when creating -xref:ROOT:routes.adoc[Java routing rules] via the xref:ROOT:dsl.adoc[DSL] which -will give you smart completion in Java code. -Or you can use your XML IDE (with XSD smart completion) to edit the -xref:ROOT:spring.adoc[routing rules in XML] using Spring XML files. - -Some of the xref:ROOT:commercial-camel-offerings.adoc[Commercial Companies] -offers IDE's and other tooling for Camel. diff --git a/docs/user-manual/modules/faq/pages/memory-leak-when-adding-and-removing-routes-at-runtime.adoc b/docs/user-manual/modules/faq/pages/memory-leak-when-adding-and-removing-routes-at-runtime.adoc deleted file mode 100644 index 1d6c3f9fcbd4..000000000000 --- a/docs/user-manual/modules/faq/pages/memory-leak-when-adding-and-removing-routes-at-runtime.adoc +++ /dev/null @@ -1,9 +0,0 @@ -= Memory leak when adding and removing routes at runtime - -If you add and remove many routes at runtime, then take notice that -xref:components::jmx-component.adoc[JMX] may take up memory when routes is added. -As Camel cannot 100% reclaim all MBeans when removing a route (some -resources may be shared by other routes, etc.). - -Therefore it's advised to disable JMX for new routes, by setting -`registerNewRoutes=false`. See details at xref:components::jmx-component.adoc[JMX]. diff --git a/docs/user-manual/modules/faq/pages/what-is-a-router.adoc b/docs/user-manual/modules/faq/pages/what-is-a-router.adoc deleted file mode 100644 index 0c937c2bf221..000000000000 --- a/docs/user-manual/modules/faq/pages/what-is-a-router.adoc +++ /dev/null @@ -1,22 +0,0 @@ -= What is a router? - -We often talk about that Camel is a mediation and routing framework; so -what exactly is a router and what does it do? - -Basically a router just consumes xref:components:eips:message.adoc[Message] exchanges -from some xref:ROOT:endpoint.adoc[Endpoint], then sends them on to some other -xref:ROOT:endpoint.adoc[Endpoint] using some kind of -xref:components:eips:enterprise-integration-patterns.adoc[Enterprise Integration -Patterns]. - -For example a router could implement the -xref:components:eips:choice-eip.adoc[Content Based Router] pattern, to route -from an endpoint to one or more destination endpoints using a -xref:ROOT:predicate.adoc[Predicate] based on the message content. - -Typically a route or router consists of one or more consumers; either an -xref:components:eips:eventDrivenConsumer-eip.adoc[Event Driven Consumer] or a -xref:components:eips:polling-consumer.adoc[Polling Consumer] or possibly a -xref:components:eips:transactional-client.adoc[Transactional Client]. Then there are one -or more xref:ROOT:processor.adoc[Processor] instances which could send the -message to one or more endpoints. diff --git a/docs/user-manual/modules/faq/pages/what-is-the-license.adoc b/docs/user-manual/modules/faq/pages/what-is-the-license.adoc deleted file mode 100644 index 6802fb300a1c..000000000000 --- a/docs/user-manual/modules/faq/pages/what-is-the-license.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= What is the license? - -This software is open source using the -http://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 licence] (a -liberal BSD style license which is very commercial friendly). diff --git a/docs/user-manual/modules/faq/pages/what-platforms-are-supported.adoc b/docs/user-manual/modules/faq/pages/what-platforms-are-supported.adoc deleted file mode 100644 index 8afcfad4bead..000000000000 --- a/docs/user-manual/modules/faq/pages/what-platforms-are-supported.adoc +++ /dev/null @@ -1,5 +0,0 @@ -= What platforms are supported? - -- Java 8 Support until 3.14.x -- Java 11 Support for all 3.x version -- Java 17 Support starting with 3.17.0 diff --git a/docs/user-manual/modules/faq/pages/why-cant-i-use-sign-in-my-password.adoc b/docs/user-manual/modules/faq/pages/why-cant-i-use-sign-in-my-password.adoc deleted file mode 100644 index 77194f3bfd86..000000000000 --- a/docs/user-manual/modules/faq/pages/why-cant-i-use-sign-in-my-password.adoc +++ /dev/null @@ -1,9 +0,0 @@ -= Why can't I use `+` sign in my password? - -How do I configure password options on Camel endpoints without the value being encoded? - -When you configure Camel endpoints using xref:ROOT:uris.adoc[URIs] then the -parameter values gets url encoded by default. -This can be a problem when you want to configure passwords _as is_. - - diff --git a/docs/user-manual/modules/faq/pages/why-do-my-message-lose-its-headers-during-routing.adoc b/docs/user-manual/modules/faq/pages/why-do-my-message-lose-its-headers-during-routing.adoc deleted file mode 100644 index 58e57e3f6f29..000000000000 --- a/docs/user-manual/modules/faq/pages/why-do-my-message-lose-its-headers-during-routing.adoc +++ /dev/null @@ -1,3 +0,0 @@ -= Why do my message lose its headers during routing? - -See this xref:using-getin-or-getout-methods-on-exchange.adoc[FAQ entry]. diff --git a/docs/user-manual/modules/faq/pages/why-does-camel-use-too-many-threads-with-producertemplate.adoc b/docs/user-manual/modules/faq/pages/why-does-camel-use-too-many-threads-with-producertemplate.adoc deleted file mode 100644 index 1503ad4548e9..000000000000 --- a/docs/user-manual/modules/faq/pages/why-does-camel-use-too-many-threads-with-producertemplate.adoc +++ /dev/null @@ -1,28 +0,0 @@ -= Why does Camel use too many threads with `ProducerTemplate`? - -A common reason is creating a new `ProducerTemplate` inside a `Processor` or -xref:ROOT:bean-integration.adoc[bean method invocation]. - -You are not meant to create a `ProducerTemplate` for each message -invocation; you are meant to create a single instance on startup and -keep it around. - -Also when you have finished using the `ProducerTemplate` you should call -the `stop()` method to close down all the resources it has been using. - -It's better to either explicitly create one on startup or get your IoC -container (xref:ROOT:spring.adoc[Spring]) to inject -it into your `Processor` or bean then it can take care of creating it and -destroying all the resources when you have finished with it. - -For instance using xref:ROOT:spring.adoc[Spring] you can define a template -and have Spring handle the lifecycle of it: - -[source,java] ----- - <camelContext xmlns="http://activemq.apache.org/camel/schema/spring";> - <template id="template"/> - </camelContext> ----- - -Then you can refer to the ProducerTemplate with the id `template`. diff --git a/docs/user-manual/modules/faq/pages/why-does-ftp-component-not-download-any-files.adoc b/docs/user-manual/modules/faq/pages/why-does-ftp-component-not-download-any-files.adoc deleted file mode 100644 index 346859b2305e..000000000000 --- a/docs/user-manual/modules/faq/pages/why-does-ftp-component-not-download-any-files.adoc +++ /dev/null @@ -1,7 +0,0 @@ -= Why does FTP component not download any files? - -The xref:components::ftp-component.adoc[FTP] component has many options. So make sure you -have configured it properly. -Also a common issue is that you have to use either active or passive -mode. So you may have to set `passiveMode=true` on the endpoint -configuration. diff --git a/docs/user-manual/modules/faq/pages/why-does-maven-not-download-dependencies.adoc b/docs/user-manual/modules/faq/pages/why-does-maven-not-download-dependencies.adoc deleted file mode 100644 index 99d677af7bfc..000000000000 --- a/docs/user-manual/modules/faq/pages/why-does-maven-not-download-dependencies.adoc +++ /dev/null @@ -1,9 +0,0 @@ -= Why does Maven not download dependencies? - -Maven uses HTTP to download its dependencies along with the dependencies -of the Maven project (such as Camel). - -If you run Maven and it fails to download your required dependencies it's -likely to be caused by your local firewall & HTTP proxy configurations. - -See the http://maven.apache.org/guides/mini/guide-proxies.html[Maven documentation for details of how to configure the HTTP proxy]. diff --git a/docs/user-manual/modules/faq/pages/why-does-my-jms-route-only-consume-one-message-at-once.adoc b/docs/user-manual/modules/faq/pages/why-does-my-jms-route-only-consume-one-message-at-once.adoc deleted file mode 100644 index 9389d3a90b6b..000000000000 --- a/docs/user-manual/modules/faq/pages/why-does-my-jms-route-only-consume-one-message-at-once.adoc +++ /dev/null @@ -1,16 +0,0 @@ -= Why does my JMS route only consume one message at once? - -The default xref:components::jms-component.adoc[JMS] endpoint configuration defines -*concurrentConsumers* to be 1 so only 1 message is processed -concurrently at any point in time. To change this to make things more -concurrent, just configure this value; either at the JMS component level -or endpoint level. - -E.g. - -[source,java] ----- -from("activemq:SomeQueue?concurrentConsumers=25"). - bean(SomeCode.class); ----- - diff --git a/docs/user-manual/modules/faq/pages/why-is-my-processor-not-showing-up-in-jconsole.adoc b/docs/user-manual/modules/faq/pages/why-is-my-processor-not-showing-up-in-jconsole.adoc deleted file mode 100644 index 15708b3d77e2..000000000000 --- a/docs/user-manual/modules/faq/pages/why-is-my-processor-not-showing-up-in-jconsole.adoc +++ /dev/null @@ -1,32 +0,0 @@ -= Why is my processor not showing up in JConsole? - -Not every processor is managed, and thus not all are visible in -JConsole. - -A processor must implement the `org.apache.camel.Service` to be managed. -Most EIP processors do this. -For example, the minor ones such as `setHeader` do not and thus are not -visible in JConsole. - -From *Camel 2.6* onwards your custom `Processor` should use the Spring -JMX annotations (for *Camel 2.9* onwards see the tip box below). Just -add `@ManagedResource` to the class, and the other annotations for the -attributes and operations. Then Camel will automatically use those when -the processor is being registered in JMX. - -\{snippet:id=e1|lang=java|title=Custom -processor|url=camel/trunk/camel-core/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java} - -The same applies when using beans in your routes. - -[source,java] ----- -include::{examplesdir}/core/camel-management/src/test/java/org/apache/camel/management/ManagedCustomProcessorTest.java[tags=e1] ----- - -Camel 2.9 onwards provides Camel's own JMX annotations - -Notice that from Camel 2.9 onwards its encouraged to use the -`@ManagedResource`, `@ManagedAttribute` and `@ManagedOperation` from the -`org.apache.camel.api.management` package. This allows your custom code -to not depend on Spring JARs anymore. diff --git a/docs/user-manual/modules/faq/pages/why-use-multiple-camelcontext.adoc b/docs/user-manual/modules/faq/pages/why-use-multiple-camelcontext.adoc deleted file mode 100644 index 9f2adaab8cb9..000000000000 --- a/docs/user-manual/modules/faq/pages/why-use-multiple-camelcontext.adoc +++ /dev/null @@ -1,14 +0,0 @@ -= Why use multiple CamelContext? - -In general, you don't tend to want multiple camel contexts in your -application, if you're running Camel as a standalone Java instance. -However, if you're deploying Camel routes as OSGi bundles, or WARs in an -application server, then you can end up having multiple routes being -deployed, each in it's own, isolated camel context, in the same JVM. -This makes sense: you want each Camel application to be deployable in -isolation, in it's own Application Context, and not affected by the -other Camel applications. - -If you want the endpoints or producers in different camel contexts to -communicate with another, there are a number of solutions. You can use -xref:components::jms-component.adoc[JMS].
