blob: 2b660b2a7ba6e6214e1c659e54d3b202a6329549 [file] [log] [blame]
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Author" content="IBM">
<meta name="GENERATOR" content="Mozilla/4.75 [en] (WinNT; U) [Netscape]">
<title>Java Debug Release Notes</title>
<h1>Eclipse 3.4 Java Debug Build Notes</h1>
<h2>Summary of API changes in 3.4</h2>
<h3>Java Launch Shortcuts</h3>
The core Java launch shortcuts are available to be extended/reused.
The following classes are provided as API in the package <code>org.eclipse.jdt.debug.ui.launchConfigurations</code>:
<li><code>JavaAppletLaunchShortcut</code> - the standard implementation for Java applets, used in the platform</li>
<li><code>JavaApplicationLaunchShortcut</code> - the standard implementation for Java application, used in the platform</li>
<li><code>JavaLaunchShortcut</code> - an abstract implementation of a shortcut to launch Java artifacts, used as the parent class to the two aforementioned classes</li>
The methods exposed to consumers from the parent class <code>JavaLaunchShortcut</code> and through the
two subclasses are:
<li> <code>getConfigurationType()</code> - returns the type of configuration this shortcut creates</li>
<li> <code>createConfiguration(IType type)</code> - creates a launch configuration for the specified <code>IType</code></li>
<li> <code>chooseType(IType[] types, String title)</code> - allows an <code>IType</code> to be selected from the given list</li>
<li> <code>findTypes(Object[] elements, IRunnableContext context)</code> - searches for specific <code>IType</code>s from the given list of elements</li>
<li> <code>getTypeSelectionTitle()</code> - returns the title for the type selection dialog used by the shortcuts for user input</li>
<li> <code>getEditorEmptyMessage()</code> - returns the error message displayed to users who try to use one of the shortcuts on an empty editor</li>
<li> <code>getSelectionEmptyMessage()</code> - returns the error message displayed to users who try to use the shortcut on an empty selection</li>
<li> <code>findLaunchConfiguration(IType type, ILaunchConfigurationType configType)</code> - searches for a launch configuration associated with the specified <code>IType</code> and configuration type</li>
<li> <code>chooseConfiguration(List configList)</code> - selects a specific configuration from the specified listing</li>
<li> <code>getShell()</code> - returns the shell used for the Java launch shortcuts</li>
<h3>Support for Execution Environment Descriptions</h3>
<p>An installed JRE can be defined by an <a href="">execution
environment description file</a>. A new 'Execution Environment Description'
VM install type shipped with the Eclipse SDK supports standard &quot;.ee&quot;
<p>API has been added to <code>JavaRuntime</code> to create a VM from an execution
environment description file. A name and unique identifier must be provided
to create a new JRE.</p>
<li><code>public VMStandin createVMFromDefinitionFile(File eeFile, String name,
String id)</code></li>
<p>A new method has been added to <code>AbstractVMInstallType</code> to allow
default arguments to be provided for newly created VM installs. Ideally, this
method would be added to <code>IVMInstallType</code>, but to support binary
compatibility, the method has only been added to <code>AbstractVMInstallType</code>.
Existing subclasses may override as required. The method is consulted to initialize
VM arguments when a new Installed JRE is created by the user. This new method
accepts a home directory or definition file as an argument.</p>
<li><code>public String getDefaultVMArguments(File installLocation)</code></li>
<h3>Support for custom wizard pages used to edit VM installs</h3>
<p>An new extension point (<code>org.eclipse.jdt.debug.ui.vmInstallPages</code>)
allows a wizard page to be contributed for editing the properties of an <code>IVMInstall</code>.
The page is used when adding or editing an installed JRE via user preference.
A standard page is provided based on the <code>IVMInstallType</code> and <code>IVMInstall</code>
interfaces. JDT contributes a page for editing a JRE based on an execution environment
description file.</p>
<h3>Support for setting a range of values in array objects</h3>
<p>API has been added to <code>IJavaArray</code> to support setting ranges of
values in the arrays. It is more efficient to set a range of values at once
than setting each value in an array individually as it uses fewer communications
with the virtual machine being debugger. The following methods have been added
to <code>IJavaArray</code>.</p>
<li><code>public void setValues(IJavaValue[] values)</code></li>
<li><code>public void setValues(int offset, int length, IJavaValue[] values,
int startOffset)</code></li>
<h3>New API methods on IJavaDebugTarget</h3>
<p>The following API methods have been added to IJavaDebugTarget.</p>
<li><code>public boolean supportsSelectiveGarbageCollection()</code></li>
<li><code>public String getVMName()</code></li>
<li><code>public String getVersion()</code></li>
<h2>Nov 27, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 210759</a>: debug tests don't compile after changes in refactoring<br>
<h2>Nov 20, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 209943</a>: LaunchConfigurationQueryParticipant does not respect search scope<br>
<a href="">Bug 210126</a>: Unable to open Snippet editor in I20071113-0800<br>
<h2>Nov 13, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 209978</a>: NPE clicking stack trace in console<br>
<a href="">Bug 208410</a>: [jre] the new JRE wizard should be consistent<br>
<h2>3.4 M3 - Nov 2, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 208036</a>: Detail pane in inspect popup dialog is too small<br>
<a href="">Bug 208119</a>: renaming main type deletes associated launch configuration<br>
<a href="">Bug 206270</a>: project or launcher classpath dialog shows blank lines for unavailable projects<br>
<a href="">Bug 206747</a>: CCE in LaunchConfigurationQueryParticipant when searching for references to method<br>
<a href="">Bug 207497</a>: Instance Breakpoint Dialog from Variables View is confusing<br>
<a href="">Bug 207740</a>: LaunchConfigurationQueryParticipant should only be active for types<br>
<h2>Oct 23, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 206693</a>: JRE location looks wrong after installing j9 using ee description file<br>
<h2>Oct 16, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 205481</a>: VMTypePage could be improved<br>
<a href="">Bug 206067</a>: NullPointerException @ ASTInstructionCompiler.visit<br>
<a href="">Bug 202818</a>: support for variables in vm definition files<br>
<a href="">Bug 57515</a>: [search] java search participant for launch configs<br>
<h2>Oct 9, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 203468</a>: Unable to add watchpoint from Variables View if selected variable is not IField<br>
<a href="">Bug 204670</a>: Improve wording on the JRE container page<br>
<a href="">Bug 201758</a>: Breaking change in IVMInstall.getInstallLocation()<br>
<a href="">Bug 205511</a>: javadoc warning in N20071004-0010<br>
<h2>Oct 2, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 204137</a>: Properties page for JRE System Library does not use dialog font everywhere<br>
<a href="">Bug 204455</a>: ConnectionType not remembered in Remote Java Application Launch Config<br>
<a href="">Bug 204023</a>: Debug tests sometimes DNF<br>
<h2>3.4 M2 - Sept 21, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 201440</a>: Improve Debug Manual Test Suite<br>
<a href="">Bug 202806</a>: Expression evaluation error when debugging.<br>
<a href="">Bug 203687</a>: unable to launch last launched debug session<br>
<h2>Sept 11, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 202158</a>: NPE in org.eclipse.jdt.internal.debug.ui.JavaHotCodeReplaceListener.hotCodeReplaceFailed<br>
<a href="">Bug 201194</a>: org.eclipse.jdt.doc.user question about &quot;Show Static Fields&quot;<br>
<a href="">Bug 74709</a>: [expressions] Watch action should work on an empty selection<br>
<a href="">Bug 54072</a>: [java launching] Provide API to extend launch shortcuts with different modes<br>
<h2>Sept 4, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 200946</a>: Support socket listening connector for Remote Java Application<br>
<a href="">Bug 201560</a>: coding error in LibraryStandin<br>
<a href="">Bug 201264</a>: several files not indexing correctly in help<br>
<h2>Aug 28, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 200728</a>: Expansion/selection state for Java variables shared between frames<br>
<a href="">Bug 200462</a>: Edit JRE definition: NullPointerException<br>
<h2>Aug 21, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 197282</a>: org.eclipse.jdt.debug.test.stepping.ForceReturnTests depend on VM-specific behaviour.<br>
<a href="">Bug 198864</a>: Can't remove a breakpoint within inner class<br>
<a href="">Bug 177193</a>: Setting range of values in array objects in one request<br>
<a href="">Bug 199163</a>: Installed JRE Copy button should be named Duplicate<br>
<a href="">Bug 200049</a>: "NLS missing message" in "Installed JREs" preference page<br>
<a href="">Bug 181026</a>: support for adding JREs from definition files<br>
<a href="">Bug 199942</a>: EE definition file test failures<br>
<a href="">Bug 200198</a>: Unable to set method breakpoint on method with type variable<br>
<a href="">Bug 198737</a>: API for vm name and version<br>
<a href="">Bug 197866</a>: Installed JRE Wizard creates duplicate system libraries when drive letter is lower case<br>
<h2>3.4 M1 - August 10, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 94134</a>: API spec reference to org.eclipse.jdt.launching.vmType extension point<br>
<a href="">Bug 125673</a>: [evaluation] Improve error message for method invocation on manually suspended threads<br>
<a href="">Bug 198404</a>: compilation errors in refactoring tests<br>
<a href="">Bug 177556</a>: [messages] remove internal error messages from translations<br>
<h2>July 31, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">Bug 196835</a>: variable id not shown for String variables<br>
<a href="">183800</a>: [launching] Discard changes question dialog on run dialog does give no real choice<br>
<a href="">197011</a>: Add JRE fails to retain system library modifications.<br>
<a href="">196940</a>: Add Watchpoint: NPE encountered<br>
<a href="">195848</a>: Add Java Exception Breakpoint dialog should use JavaUI#createTypeDialog(..)<br>
<a href="">188676</a>: [breakpoints] BreakpointMarkerUpdater moves line breakpoint to wrong position<br>
<a href="">195185</a>: Cannot debug java class<br>
<a href="">129066</a>: [breakpoints] Breakpoint view shows multiple breakpoints with same line number<br>
<a href="">140660</a>: Debug View Actions (such as Show System Threads) should be Java-specific<br>
<h2>July 17, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">42173</a>: [jres] Bad generated name for JREs<br>
<a href="">79529</a>: [java debug] Step Into Outermost method invocation<br>
<a href="">177556</a>: [messages] remove internal error messages from translations<br>
<a href="">181003</a>: Default watchpoint settings should be configurable<br>
<h2>July 10, 2007</h2>
<h3>Problem Reports Fixed</h3>
<a href="">64663</a>: [variables] &quot;Variables&gt;Change Value&quot; should accept hex value<br>
<a href="">33452</a>: [evaluation] [README] ObjectCollectedException evaluating conditional breakpoint<br>
<a href="">132764</a>: [jres] VM type element with unknown id message in the log using I0321-1210<br>
<a href="">193488</a>: org.eclipse.jdt.debug.test.stepping.StepIntoSelectionTests depend on VM behavior<br>
<a href="">85780</a>: SWT support &quot;hidden&quot; widgets<br>
<a href="">191559</a>: TVT33:TCT623: pl: Instance Breakpoint Filter Selection window<br>
<a href="">29855</a>: [jres] Ampersands in file name create mnemonics when scanning for JREs<br>
<a href="">33714</a>: [evaluation] AstEvaluationEngine cache<br>
<a href="">191486</a>: [breakpoints] Alt+Enter for java breakpoint properties command is throws exceptions<br>
<a href="">28304</a>: [variables] UnsupportedOperationException report to user on toString on WTK<br>
<a href="">190875</a>: help id associated with wrong widget on two pref pages<br>
<a href="">191389</a>: TVT33:TCT636: ja: No mnemonic for &quot;Step through filters&quot;<br>
<a href="">191486</a>: [breakpoints] Alt+Enter for java breakpoint properties command is throws exceptions<br>
<a href="">193783</a>: JDT Launching duplicates method newDocument from DebugPlugin<br>
<a href="">193835</a>: Should not attempt to select filtered stack frame<br>
<a href="">46991</a>: Failing debug test<br>
<a href="">191387</a>: TVT33:TCT626: pl: functional: Up button does not work correctly<br>
<a href="">173890</a>: [launching] can't debug premain<br>
<a href="">188555</a>: Go to source action is disabled for exception breakpoints added from console<br>
<a href="">190492</a>: JRE preference page does not scale correctly<br>