JProfiler as a Netbeans 3.x /Sun ONE Studio module

JProfiler as a Netbeans 3.x /Sun ONE Studio module

With JProfiler integrated into Sun Microsystems' Netbeans(TM) or Sun ONE Studio(TM), JProfiler can be invoked from within the IDE without any further need for session configuration.
Requirements: The Netbeans 3.x plugin needs at least Netbeans 3.3 or Sun ONE Studio 4. In the following text, the IDE will always be called "Netbeans". For Netbeans 4, a different module with more capabilities is available.

The installation of the Netbeans module is started by selecting "Netbeans IDE 3.3 to 3.x" or "Sun ONE studio 4 to 9" on the
- IDE integration tab of JProfiler's setup wizard
- miscellaneous options tab of JProfiler's general settings (use Session->IDE integrations in JProfiler's main menu as a shortcut).
and clicking on [Integrate]

Reminder: Please close Netbeans while performing the module installation. If you are performing the installation from JProfiler's setup wizard, please complete the entire setup first before starting Netbeans.
A file selection box will then prompt you to locate the installation directory of Netbeans. In the next step, you are asked whether the installation should be performed globally, or for a single user only. A single user installation is mostly of interest in network installations where the user cannot write to the Netbeans installation directory. If you decide for a single user installation, another file selection box will then prompt you to locate your Netbeans user directory. This is a version-specific directory under .netbeans in your user home directory.
The Netbeans updater is then invoked and the module is installed. After acknowledging the completion message, you can start Netbeans and check whether the installation was successful. You should now see a menu entry JProfiler top-level menu in Netbeans' main menu.

To profile your application from Netbeans, choose one of the profiling commands in the Run menu or click on the corresponding toolbar button.

Main toolbar with "JProfiler" button

"JProfiler" menu

Explorer context menu with "JProfiler" action

The profiled application is then started just as with the usual "Run" commands. When a profiling session is started,
- in all versions except Netbeans 3.6
  the current workspace is switched to the Profiling workspace, which contains an output window, an execution task list and - once a profiling session is started - a tabbed JProfiler window with one tab for each profiling session.
- in Netbeans 3.6
  a new tab with a JProfiler window is created.
Profiling sessions are closed by closing the corresponding tab (in all versions except Netbeans 3.6 via its context menu). Apart from the excluded tool bar buttons for "Attach/Detach" and "Session settings", the JProfiler window and its views are exactly the same as in the standalone version.

All profiling settings and view settings changes are persistent across session restarts.

When JProfiler is used with the Netbeans integration, the "Show source" action for a class or a method in one of JProfiler's view will show the source element in Netbeans and not in JProfiler's integrated source code viewer.

The JProfiler menu in Netbeans' main menu bar contains all actions required to run JProfiler from within Netbeans:
- Profile file with JProfiler
  Start profiling the currently selected class.
- Profile project with JProfiler
  Start profiling the main class of the current project.
- Edit
  Contains the JProfiler's view specific View menu which is active only during profiling.
- General settings
  Brings up the general settings dialog that contains the Filter sets and Miscellaneous tabs of the standalone version. In addition, it contains a General profiling options tab. On that tab you can ask JProfiler to always use interpreted mode for profiling. A separate checkbox tells JProfiler to use the deprecated JVMPI interface when profiling with a 1.5 JRE. Both these settings are trouble-shooting options and should normally not be selected.
- Enter license key
  Allows you to enter your license key.
- Contact sales
  Brings up your default mail client to write an e-mail to ej-technologies' sales department.
- Contact support
  Brings up your default mail client to write an e-mail to ej-technologies' support department. The license key is automatically included in the subject of the e-mail.
- JProfiler on the web
  Connects to JProfiler's web site in the default web browser.
- About JProfiler
  Shows general information about your copy of JProfiler and its license status.