| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> |
| <head> |
| <meta name="copyright" content= |
| "Copyright (c) IBM Corporation and others 2000, 2017. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." /> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| <meta http-equiv="Content-Style-Type" content="text/css" /> |
| <link rel="stylesheet" href="../../../../book.css" charset="ISO-8859-1" |
| type="text/css" /> |
| <title> |
| Java Debug Preferences |
| </title> |
| <script language="JavaScript" src= |
| "PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> |
| |
| </script> |
| </head> |
| <body> |
| <h1> |
| Java Debug Preferences |
| </h1> |
| <p> |
| The following preferences can be set using the <a class="command-link" |
| href= |
| 'javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.jdt.debug.ui.JavaDebugPreferencePage)")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt= |
| "Opens the Java Debug preference page" /> <b>Java > Debug</b></a> |
| |
| preference page. |
| </p> |
| <p> |
| These options apply to java specific debuggers and have to do with |
| suspending options and hot code replace. |
| </p> |
| <table border="1" cellspacing="0" cellpadding="5"> |
| <thead> |
| <tr> |
| <th rowspan="1" colspan="1"> |
| <p> |
| |
| Option |
| </p> |
| </th> |
| <th rowspan="1" colspan="1"> |
| <p> |
| Description |
| </p> |
| </th> |
| <th rowspan="1" colspan="1"> |
| <p> |
| |
| Default |
| </p> |
| </th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Suspend execution on uncaught exceptions |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| This option controls if a program will suspend if an uncaught |
| exception is thrown. |
| <p> |
| For example if you try to call a method on a null object and a |
| NullPointerException is thrown, with this option on your program |
| will suspend at the location the exception was thrown |
| </p> |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Suspend execution on compilation errors |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if a program will suspend when a compilation |
| error is encountered |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Suspend for breakpoints during evaluations |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if breakpoints will suspend during an |
| evaluation of code containing a breakpoint. For more information |
| about evaluations go <a href= |
| "../../../../tasks/task-evaluating_expressions.htm">here</a> |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Open popup when suspended on exception |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if a popup window will be displayed when |
| execution of a program stops on an exception. The exception the |
| program suspended on is made available for inspection in the popup |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| Off |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Default suspend policy for new breakpoints |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option allows the default suspend policy to be set for new |
| breakpoints. The suspend policy is used by breakpoints to tell the |
| VM what to suspend, in this case either the thread the breakpoint |
| is active in or the entire running VM |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| Suspend Thread |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Default suspend policy for new watchpoints |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option allows the default suspend policy to be set for new |
| watchpoints. The suspend policy is used by watchpoints to tell the |
| VM what kind of field actions to suspend on - in this case either access and modification (both), access only or modification only |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| Suspend Thread |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Enable hot code replace |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if hot code replacement will be supported |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Show error when hot code replace fails |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if you will be presented with an error |
| dialog when a hot code replace fails |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Show error when hot code replace is not supported |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if you will be presented with an error |
| dialog when hot code replace is not supported. This can happen after you have |
| made and saved changes to currently running code. |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Show error when obsolete methods remain after hot code replace |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if you will be presented with an error |
| dialog when a hot code replace completed, but there were obsolete |
| methods left over |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Replace class files containing compilation errors |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls is class files containing compilation errors |
| will be replaced |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Debugger timeout |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option describes the length of time (in milliseconds) the |
| debugger will wait trying to communicate with a running VM before |
| giving up and disconnecting |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| 3000 |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Launch timeout |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option describes the length of time (in milliseconds) that a |
| launch will wait to complete the launching process before giving up |
| and terminating. This option has no bearing on the length of time a |
| program will run, only how long the process of <em>trying</em> to |
| run a program will wait |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| 20000 |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Warn when unable to install breakpoint due to missing line number |
| attributes |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if you will be notified when you try to |
| set a line breakpoint on a line that has invalid line information |
| </td> |
| |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Prompt for confirmation when deleting a conditional breakpoint from editor |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if you should be asked whether you really want to remove a breakpoint with a condition from the editor |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Do not install breakpoints from unrelated projects |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| Multiple versions of the same Java type can be available in a workspace, and each version can |
| have breakpoints configured at different source locations. When debugging, JDT tries to |
| determine the "right" set of breakpoints to install in the target VM. This analysis |
| now uses Java project dependencies by default. |
| <p> |
| To always install all enabled breakpoints, you can disable this option. |
| </p> |
| <p> |
| Note that not all projects use explicit Java project dependencies. E.g. OSGi bundles |
| typically use a dynamically computed classpath where project dependencies are computed |
| by PDE. |
| </p> |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| On |
| </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left"> |
| Only include exported classpath entries when launching |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| This option controls if only classpath entries marked as exported should be included in the classpath used for launching |
| </td> |
| <td colspan="1" valign="top" align="left"> |
| Off |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| <p> |
| <img src="../../../../images/ngrelc.png" alt="Related concepts" border= |
| "0" /> |
| </p> |
| |
| <p> |
| <a href="../../../../concepts/cdebugger.htm">Debugger</a><br /> |
| <a href="../../../../concepts/concept-java-perspective.htm">Java |
| perspectives</a><br /> |
| <a href="../../../../concepts/concept-java-views.htm">Java |
| views</a><br /> |
| <a href="../../../../concepts/clocdbug.htm">Local debugging</a><br /> |
| <a href="../../../../concepts/cremdbug.htm">Remote debugging</a> |
| |
| </p> |
| <p> |
| <img border="0" src="../../../../images/ngrelt.png" alt= |
| "Related tasks" /> |
| </p> |
| <p> |
| <a href="../../../../tasks/task-launching_java_program.htm">Launching a |
| Java program</a><br /> |
| <a href="../../../../tasks/task-running_and_debugging.htm">Running and |
| debugging</a> |
| </p> |
| |
| <p> |
| <img src="../../../../images/ngrelr.png" alt="Related reference" border= |
| "0" /> |
| </p> |
| <p> |
| <a href= |
| "../../../../reference/preferences/java/debug/ref-detail_formatters.htm">Detail |
| Formatters Preferences</a><br /> |
| <a href= |
| "../../../../reference/preferences/java/debug/ref-heap_walking.htm">Heap |
| Walking Preferences</a><br /> |
| <a href= |
| "../../../../reference/preferences/java/debug/ref-installed_jres.htm">Installed |
| JREs Preferences</a><br /> |
| |
| <a href= |
| "../../../../reference/preferences/java/debug/ref-logical_structures.htm"> |
| Logical Structures Preferences</a><br /> |
| <a href= |
| "../../../../reference/preferences/java/debug/ref-primitive_display_options.htm"> |
| Primitive Display Preferences</a><br /> |
| <a href= |
| "../../../../reference/preferences/run-debug/ref-run_debug.htm">Run/Debug |
| Preferences</a><br /> |
| <a href= |
| "../../../../reference/preferences/java/debug/ref-step_filtering.htm">Step |
| Filtering Preferences</a> |
| </p> |
| |
| </body> |
| </html> |