[camel-website] branch main updated: Blogpost:Adding configuration on how to debug Apache Camel with Emacs (#914)

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-website.git


The following commit(s) were added to refs/heads/main by this push:
     new 3714ae9c Blogpost:Adding configuration on how to debug Apache Camel with Emacs (#914)
3714ae9c is described below

commit 3714ae9c4b0d8f4098a25dde18447f13fe2543b5
Author: Navyashree <89...@users.noreply.github.com>
AuthorDate: Sat Oct 8 12:30:14 2022 +0530

    Blogpost:Adding configuration on how to debug Apache Camel with Emacs (#914)
---
 content/blog/2022/10/Emacsdap/images/Emacs-dap.gif | Bin 0 -> 266639 bytes
 content/blog/2022/10/Emacsdap/index.md             | 128 +++++++++++++++++++++
 2 files changed, 128 insertions(+)

diff --git a/content/blog/2022/10/Emacsdap/images/Emacs-dap.gif b/content/blog/2022/10/Emacsdap/images/Emacs-dap.gif
new file mode 100644
index 00000000..46da0781
Binary files /dev/null and b/content/blog/2022/10/Emacsdap/images/Emacs-dap.gif differ
diff --git a/content/blog/2022/10/Emacsdap/index.md b/content/blog/2022/10/Emacsdap/index.md
new file mode 100644
index 00000000..f0ba970e
--- /dev/null
+++ b/content/blog/2022/10/Emacsdap/index.md
@@ -0,0 +1,128 @@
+---
+title: "Camel Textual Route debugging in Emacs"
+date: 2022-10-07
+authors: [Navyashree0923]
+categories: ["Tooling"]
+preview: "Camel Textual Route debugging in Emacs"
+---
+
+A month before it became easier to provide debug adapter support inside Vim -[See this blog post](/blog/2022/09/vimdap/). It is now time to use Camel Debug Adapter in Emacs[camel-tooling/camel-dap-client-emacs](https://github.com/camel-tooling/camel-dap-client-emacs).
+
+# EMACS Debug Adapter client for Apache Camel
+
+![A breakpoint hit on a Camel route endpoint](./images/Emacs-dap.gif)
+
+# How to debug Camel with emacs
+I just got the debug integration for camel in emacs running using (https://emacs-lsp.github.io/dap-mode/page/adding-debug-server/). In order to not forget the config, I decided to quickly compile this readme.
+
+## Prerequisites
+ - Camel version 3.18+
+ - camel-debug is available on the classpath
+ - have JMX enabled
+
+# How to configure Emacs
+
+In a `~/.emacs.d/dap-camel.el` file:
+
+```lisp
+(dap-register-debug-provider
+ "camel"
+ (lambda (conf)
+   (plist-put conf :host "localhost")
+   conf))
+
+(dap-register-debug-template "Camel Attach"
+                             (list :type "camel"
+                                   :request "attach"
+                                   :port 1099
+                                   :dap-server-path '("java" "-jar" "PATH/TO/camel-dap-server-0.4.0.jar")
+                                   :name "Run Configuration"))
+```
+<kbd>M-x</kbd> `eval-buffer`
+
+# How to get Camel Debug Adapter server.jar file?
+- To get a jar file either you can compile the source or download from the Maven Central repository.
+- To download from Maven Central repository
+```sh
+cd /home
+curl -LO https://repo1.maven.org/maven2/com/github/camel-tooling/camel-dap-server/0.4.0/camel-dap-server-0.4.0.jar
+  ```
+
+# How to attach camel application to emacs for debugging
+
+* To test the camel application debugging need a working example. Lot of good examples are provided in this repo, [camel-examples](https://github.com/apache/camel-examples).
+
+* To enable Camel Textual Route debugging, you need to launch this examples with `mvn camel:debug`.
+
+* I have specifically used [example-main](https://github.com/apache/camel-examples/tree/main/examples/main) in this setup.
+
+## In Terminal
+```sh
+  cd ~/camel-examples/examples/main
+```
+- vim src/main/java/org/apache/camel/example/MyBean.java
+- Add the following content inside `MyBean.java` file:
+```java
+package org.apache.camel.example;
+
+public class MyBean {
+
+    private String hi;
+
+    public MyBean(String hi) {
+        this.hi = hi;
+    }
+
+    public String hello() {
+        return hi + " Begin ? ";
+
+    }
+     public String bye() {
+        return hi + " End ? ";
+}
+}
+```
+* Compile the source to reflect the new changes
+ ```sh
+ mvn compile
+ ```
+* Launch this example with the profile `camel.debug`
+```sh
+ mvn camel:run -Pcamel.debug
+```
+
+## Make the following changes and run your camel application
+
+- <kbd>M-x</kbd> `load-file`
+- Load file: ~/camel-examples/examples/main/src/main/java/org/apache/camel/example/MyRouteBuilder.
+             java
+- Inside `MyRouteBuilder.java` file:
+```java
+package org.apache.camel.example;
+
+import org.apache.camel.builder.RouteBuilder;
+
+public class MyRouteBuilder extends RouteBuilder {
+
+    @Override
+    public void configure() throws Exception {
+        from("timer:foo").routeId("foo")
+            .bean("myBean", "hello")
+            .log("${body}")
+            .bean("myBean", "bye")
+            .log("${body}");
+    }
+}
+```
+# Debug It
+
+### To set the breakpoints
+<kbd>M-x</kbd> `dap-breakpoint-add`
+
+Now everything is in place. Open the main MyRouteBuilder file and start debugging by:
+
+<kbd>M-x</kbd> `dap-debug`
+
+<kbd>Select configuration template: </kbd> `Camel Attach`
+
+### Enjoy the Debug Adapter for Apache Camel in Emacs.