(camel) branch main updated: chore(componenets): add a note to clarify design intents

[pc...@apache.org]

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

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


The following commit(s) were added to refs/heads/main by this push:
     new c217af315de9 chore(componenets): add a note to clarify design intents
c217af315de9 is described below

commit c217af315de9a954387538820b4af61363072c99
Author: Pasquale Congiusti <pa...@gmail.com>
AuthorDate: Thu Nov 27 10:22:28 2025 +0100

    chore(componenets): add a note to clarify design intents
---
 .../java/org/apache/camel/component/debug/CamelDebuggerFactory.java  | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/components/camel-debug/src/main/java/org/apache/camel/component/debug/CamelDebuggerFactory.java b/components/camel-debug/src/main/java/org/apache/camel/component/debug/CamelDebuggerFactory.java
index fb85af6fb1b1..a05a733da33c 100644
--- a/components/camel-debug/src/main/java/org/apache/camel/component/debug/CamelDebuggerFactory.java
+++ b/components/camel-debug/src/main/java/org/apache/camel/component/debug/CamelDebuggerFactory.java
@@ -29,11 +29,14 @@ import org.apache.camel.support.LifecycleStrategySupport;
 public class CamelDebuggerFactory implements DebuggerFactory {
 
     @Override
+    // Debugger is created and added as a service. This method always returns a null object.
     public Debugger createDebugger(CamelContext camelContext) throws Exception {
         // only create a debugger if none already exists
         if (camelContext.hasService(BacklogDebugger.class) == null) {
 
-            BacklogDebugger backlog = DefaultBacklogDebugger.createDebugger(camelContext);
+            // NOTE: the AutoCloseable object is added as a Service, hence it is closed by Camel context
+            // according to the object lifecycle.
+            BacklogDebugger backlog = DefaultBacklogDebugger.createDebugger(camelContext); // NOSONAR
             backlog.setStandby(camelContext.isDebugStandby());
 
             // must enable source location and history