To get started select one or more Java elements in a navigator window. A Java element includes any Java project, package, or Ò,javaÓ file. In different Eclipse views these are represented as files, class objects, and folders. JeSS works with items selected in the Navigator view, Package Explorer, and all views in the Java Browsing perspective. If an element that is of a type that cannot be scanned by JeSS an error message will appear when the scan is initiated.
Example Error Message: if an invalid selection is made an error will occur
This can be confusing in Eclipse as elements can be highlighted without having the actual focus of the workspace. Make sure that the element that is to be scanned is both highlighted and has the focus of the workspace.
Example Selection: in this view the Java Project ÒTestÓ is selected
The next step is to use either the JeSS scan button () in the task
bar at the top of the workspace or to select the ÒScan Current SelectionÓ item
from the JeSS menu.
Example Menu: Use the ÒScan Current SelectionÓ action
This starts the JeSS scan. The progress bar at the bottom of the workspace will show the progress of the JeSS scan. If more than one project is being scanned then this may take a few seconds.
After the JeSS scan is completed a dialog will appear saying how many problems were found during the scan. In addition to this the ÒProblemsÓ view will be brought to the front of the workspace. In this view, the problems discovered by the JeSS scan will be displayed.
Example problem: Unhandled Exception
IMPORTANT: if JeSS has found problems but they do not show up in the ÒProblemsÓ dialog then make sure that the filter on the problems view is not excluding JeSS problems from the view
Example Problem View Filter: make sure the ÒSecurity MarkerÓ is checked
These can be treated as any other problem in the view. For example, to jump to a problematic section of your code, simply double click on the problem in the view and an appropriate editor will appear with the code highlighted. JeSS does not supply any true resolutions to these problems, but you can choose to ignore the particular warning, ignore all warnings in that file, or ignore all warnings on the project. A better solution would be to modify your code to eliminate these problematic sections as outlined in the Concepts section of this users guide.