Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

SCA/SCA Component/SCA Java Run and Debug Platform

< SCA

Introduction

When you debug an SCA Java project on an SCA platform, it is also possible to debug the platform itself.
Obviously, the developers of the platform did not wait for us to provide such a solution. But we signal it on this wiki because it can be quite useful to see how to do that.
It also opens some perspectives to add breakpoints and debugging features for composite elements.

Notice: obviously, to ease the debugging, you should have both the binary and the source distribution of the SCA platform you are using.


Debugging from the main class

Find the main class file in your Eclipse.
You can find it either because you already have the source, or by using the Java search feature of Eclipse (Java > Search Java... and search the type you gave in the master launch configuration).

Go into the debug perspective: Window > Open perspective > Debug.
We are now going to add a breakpoint somewhere in your main.


Starting from the main source file...

Open the source file.

SCA Java Run and Debug Platform editor.gif


Make a right-click somewhere on the left margin of the editor and select Toggle breakpoint.
This breakpoint may not be visible in the editor, but it will be visible in the Breakpoints view.

SCA Java Run and Debug Platform breakpoints.gif


Now, right-click on your composite and select Debug as... > SCA application.
Select the configuration you want to debug and click OK.

If your main class is not in the workspace, the debug editor will show you an empty editor.

SCA Java Run and Debug Platform noSource.gif

You will have to associate the sources manually. In this case, click Edit Source Lookup Path....
Select Default and click Add.... In the second dialog, select the appropriate choice.
For this tutorial, since I have the source of TuscanyMain1x, I can select File System Directory and give the right location.

SCA Java Run and Debug Platform searchSource.gif


SCA Java Run and Debug Platform foundSource.gif


Click OK until you get back to the source. You have your source now.

SCA Java Run and Debug Platform withSource.gif


Starting from the main class file...

The editor should only show bytecode.
Click Attach Source..., select External File..., choose the source file on your disk. Then click OK until you are back to the editor. You should now see the main class code. In this source file, make a right-click somewhere on the left margin of the editor and select Toggle breakpoint (or make a double-click). This breakpoint should be visible in both the editor and the Breakpoints view.

Now, right-click on your composite and select Debug as... > SCA application. Select the configuration you want to debug and click OK.


Getting into the platform code

You are now moving into the main class code.
Use the Step Into, Step Over and Step Return buttons to navigate into the code.

SCA Java Run and Debug Platform debugView.gif


You should finally arrive to a runtime class. Once again, you will most likely have to associate the source code.

SCA Java Run and Debug Platform noSources.gif


Click Attach Source..., select External File.... On your disk, choose the source distribution of the platform.


SCA Java Run and Debug Platform foundSources.gif


Then click OK until you are back to the editor. You should now be in the platform code.

SCA Java Run and Debug Platform debugPlatformCode.gif


You can add breakpoints into this code, check the variables... in short, debug the platform code.

SCA Java Run and Debug Platform variables.gif


Debugging from a stack trace

Let's assume you deployed a project and that it failed.
You have a stack trace in the console, referencing some classes of the platform and lines indicating where it failed.

This case is even more simple than previously.
In the console, click the class link. It should be open in the editor and be displayed as bytecode.
Associate the source as described previously and then add breakpoints.
Run the composite once again in debug mode and check what went wrong.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.