Debugging the Mule ESB 4.x
This article is not related to debugging a Mule Application in Anypoint Studio. Rather than that it's related to understand the internals of the MuleSoft ESB by debugging it. Unfortunately I couldn’t find too much information in the internet. So, I thought of writing some initial stuffs on it and later on explore in depth.
The easiest way to debug the ESB is to run the MuleSoft Enterprise Edition runtime in your localhost and debug it in IntelliJ. Below is the simplest approach I did.
Create a java project in IntelliJ and import the following libraries into it.
Below is my IntelliJ setup.
Next, you need to run the MuleESB in debug mode. It can be done easily by changing the configuration in the below configuration file.
Check the configuration below.
Entry-point of Mule ESB
Well, where is the entry-point (a main method) to the MuleESB? It's also simple to find it out. Check the same wrapper.conf.
It's the class,
Pretty cool. Huh!!
Browse to the class and you can see the beautiful main() method.
At line 80, you can see that it's calling a Wrapper called EEMuleContainerWrapper. So, when the line 80 is executed,
WrapperManager.start(new EEMuleContainerWrapper(), remainingArgs);
The whole initialization of the ESB takes place. Check how it happens.
Let’s look at the class definition of EEMuleContainerWrapper.
Check that it's super class is MuleContainerWrapper. Let's look at its content.
Voila!!! This is all we need at this moment to know from where exactly everything gets initialized. Check the line 28. The code initializes the below class through reflection.
And invokes its start() method at line 31 & 32. Now, let's check the MuleContainer class and its start() method and you can see the whole initialization of the Mule Runtime.
Pretty cool, right!
Now create a Remote debug configuration in IntelliJ as shown below. Note that I am using the port 5000 as I configured in the MuleESB wrapper.
Start the Mule ESB by running the below command:
You can see that the execution halts at the below point.
Now, put some debug point at the main() method of MuleContainerBootstrap and run your Remote Debug in the IntelliJ. You should be able to debug the ESB.
In this short article, I have explored how to debug the Mule ESB (EE). It's not even required in a day-to-day basis for a common MuleSoft user but if you want to go in depth to learn what goes on inside the ESB this is a good point of entry.
Happy learning. Thanks!!!