Debugger and Custom Java classes

wrknotts

When debugging a report containing JavaScript event handlers, where should custom (not core Java or BIRT-provided) classes that are referenced within an event handler be placed so that the debugger can reference them? I am working with version 2.5.1 of the Designer All-in-one distribution.

The attached .zip contains a project where the report executes successfully using 'Preview' from the Designer.

When I place a breakpoint on the code attached to ReportDesign.initialize and choose "Run -> Debug Report" in the Report Design perspective, I see the following error when I step over the line (line #11) that attempts to create a new instance of my custom class.


"Caused by: org.mozilla.javascript.EcmaError: ReferenceError: "SimplePojo" is not defined. (/report/method[@name="initialize"]#11)"

Regards,
Bill

wrknotts

Discovered the answer, posting here in case it may help others.

The steps below are for a typical 'Java Project', not a 'Report Project'. Both the custom Java classes and the Report Design are contained within the same project:

After creating your custom Java classes and your Report Design, then adding code to the desired event handler that references your custom Java classes:

1. Switch to the Debug perspective
2. Choose 'Debug Configurations' from the options offered by the 'Debug' button on the toolbar
3. Right-click the 'Report' type from the list of available launch settings, choose 'New'
4. Provide a name for the launch configuration
5. Ensure the report design you wish to test is listed in the 'Report file name' text box, using the 'Search' button to locate the .rptdesign file if necessary
6. Review the remaining options on the 'Main' tab to ensure they meet your needs
7. Click the 'Classpath' tab
8. Click 'User Entries' in the 'Classpath' section of the dialog, the option buttons on the right should now be enabled
9. Click the 'Advanced' option button
10. Choose the appropriate option listed under the 'Advanced Options' dialog (I chose 'Add Folders', YMMV depending on your project setup)
11. Choose the location where the compiled versions of your custom Java class are located within the project (Since this was a standard 'Java Project' type with all default folders selected, mine were located under the 'bin' folder)
12. Click OK
13. Click 'Apply'
14. Click 'Debug'
15. Assuming you had already placed a breakpoint within the event handler you wish to debug, the report should begin executing with the debugger stopping at your breakpoint

If you've previously tried the 'Debug Report' option, a launch configuration should already exist. You can then start at step 7 above, after having selected the existing launch configuration.