The supplied dates indicate when the API change was made, on the CVS trunk. From this you can generally tell whether the change should be present in a given build or not; for trunk builds, simply whether it was made before or after the change; for builds on a stabilization branch, whether the branch was made before or after the given date. In some cases corresponding API changes have been made both in the trunk and in an in-progress stabilization branch, if they were needed for a bug fix; this ought to be marked in this list.
release41
branch was made on Apr 03 '05 for use in the NetBeans 4.1 release.
Specification versions: 6.0 begins after this point.
release40
branch was made on Nov 01 '04 for use in the NetBeans 4.0 release.
Specification versions: 5.0 begins after this point.
Fuller descriptions of all changes can be found below (follow links).
Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.
Toolbar
Actions.forID
lazy
attribute to ActionRegistration
HIDE_WHEN_DISABLED
HtmlBrowser.dispose
SystemAction/Action
that causes it's icon not to be displayed in menu.
HtmlBrowser
org.openide.awt.Mnemonics
added
Toolbar
These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:
OpenIDE-Module-Module-Dependencies: org.openide.actions > 1.20
Actions.forID
lazy
attribute to ActionRegistration
HIDE_WHEN_DISABLED
HtmlBrowser.dispose
SystemAction/Action
that causes it's icon not to be displayed in menu.
HtmlBrowser
org.openide.awt.Mnemonics
added
org.netbeans.spi.actions.AbstractSavable
org.openide.awt.ActionID
org.openide.awt.ActionReference
org.openide.awt.ActionReferences
org.openide.awt.ActionRegistration
lazy
attribute to ActionRegistration
org.openide.awt.Actions
Actions.forID
org.openide.awt.Mnemonics
added
org.openide.awt.ActionState
org.openide.awt.awt
SystemAction/Action
that causes it's icon not to be displayed in menu.
org.openide.util.actions.CallableSystemAction
org.openide.awt.CheckForUpdatesProvider
org.netbeans.api.actions.Closable
org.openide.awt.CloseButtonFactory
org.openide.awt.ColorComboBox
org.openide.loaders.DataNode
org.openide.awt.DropDownButtonFactory
org.openide.awt.DynamicMenuContent
HIDE_WHEN_DISABLED
org.netbeans.api.actions.Editable
org.openide.awt.GraphicsUtils
org.openide.awt.HtmlBrowser
HtmlBrowser.dispose
HtmlBrowser
org.openide.awt.HtmlRenderer
org.openide.filesystems.FileSystem.HtmlStatus
org.openide.awt.JInlineMenu
org.openide.awt.JMenuPlus
org.openide.awt.JPopupMenuPlus
org.openide.awt.Mnemonics
org.openide.awt.Mnemonics
added
org.openide.nodes.Node
org.openide.awt.Notification
org.openide.awt.NotificationDisplayer
org.netbeans.api.actions.Openable
org.netbeans.api.actions.Printable
org.openide.awt.QuickSearch
org.netbeans.api.actions.Savable
org.openide.awt.SpinButton
org.openide.awt.StatusDisplayer
org.openide.awt.StatusLineElementProvider
org.openide.util.actions.SystemAction
org.openide.awt.TabbedPaneFactory
org.openide.awt.Toolbar
Toolbar
org.openide.awt.ToolbarPool
org.openide.awt.ToolbarWithOverflow
org.openide.windows.TopComponent
org.openide.awt.UndoRedo
org.netbeans.api.actions.Viewable
Actions
; made by: ebakke
The Actions.keyStrokeToString method has been added as a public API, to avoid duplication of the same logic in the editor.lib module. This method has identical semantics to the existing org.netbeans.editor.Utilities.Actions.keyStrokeToString method (which now delegates to the new Actions.keyStrokeToString), but is available without depending on the editor infrastructure.
GraphicsUtils
; made by: ebakke; issues: NETBEANS-5931
DropDownButtonFactory
; made by: ebakke; issues: NETBEANS-3581
Actions
ActionState
ActionReference
; made by: sdedic
Context Actions which provide Action.SELECTED_KEY
value will be presented as checkbox (menu) or toggle button (toolbar) and
will reflect the state of an underlying model bean property, tracking models in Lookup and updating to model changes. Similar support
was added for enabled
Action property.
All that was required to be implemented by individual Actions in their ContextAwareAction implementations, this allows to use just annotation for the same behaviour in most cases.
NotificationDisplayer
; made by: jpeska; issues:
#227690
Actions
; made by: jlahoda; issues:
#217978
HtmlBrowser
; made by: saubrecht; issues:
#217171
ToolbarWithOverflow
; made by: theofanis; issues:
#216175
ColorComboBox
; made by: saubrecht; issues:
#216013
QuickSearch
; made by: theofanis; issues:
#215833
TabbedPaneFactory
; made by: saubrecht; issues:
#215265
CheckForUpdatesProvider
; made by: jrechtacek; issues:
#212218
QuickSearch
; made by: mentlicher; issues:
#208794
Actions.forID
Actions
; made by: jglick; issues:
#205798
Added a utility method Actions.forID
.
Also moved AcceleratorBinding
down into the org.openide.awt
module (keeping the same FQN and signature).
Calls to FileUtil.getConfigObject
or similar should be reviewed.
Modules with a dependency only on org.openide.loaders
but not org.openide.awt
must add the latter dep in
order to use AcceleratorBinding
.
lazy
attribute to ActionRegistration
ActionRegistration
; made by: jglick; issues:
#206093
Added attribute explicitly controlling whether an action registration uses a lazy factory method or not.
New warnings will be issued for existing eager registrations.
The warning can be suppressed by explicitly setting lazy=false
,
but this is a good time to review whether the registration could
in fact be made lazy.
CloseButtonFactory
; made by: mkristofic; issues:
#201639
New close button factory to a create close button or a big close button.
New branding key for applications built on top of NetBeans Platform to turn mnemonics in popup menus on.
ActionRegistration
; made by: tstupka; issues:
#197789
New attributes (popupText, menuText) in @ActionRegistration annotation to provide text for menu items or popup menu items according to the Actions.connect method.
Actions
; made by: err; issues:
#197639
Handle _selected, _rolloverSelected and _disabledSelected icon resources in Actions.connect. Actions.checkbox on a Toolbar uses them if they are available.
Savable
AbstractSavable
; made by: jtulach; issues:
#77210
New interface for objects that can be saved. Old
SaveCookie
is retrofitted to implement the new Savable
interface.
Actions
; made by: jtulach; issues:
#77210
Action.context, when used from layer accepts "context"
attribute.
ActionReference
ActionReferences
; made by: jtulach; issues:
#189558
New annotation to register references to actions from layer.
ActionRegistration
ActionID
; made by: jtulach; issues:
#183794
Instead of registering actions in layer as advocated by various action factory methods one can use newly created annotations.
UndoRedo
; made by: jtulach; issues:
#180614
Undo and Redo actions now seek their context for implementation of UndoRedo.Provider. If found, it influences their enabled/disabled state. If there is no such provider, the implementation fallbacks to currently activated TopComponent.
HIDE_WHEN_DISABLED
DynamicMenuContent
; made by: jglick; issues:
#182488
New action property which makes it simple to conditionally hide, rather than merely grey out, a context menu item.
Actions formerly implementing DynamicMenuContent
solely to
conditionally hide an action are encouraged to use the new API.
NotificationDisplayer
; made by: jtulach; issues:
#174183
Actions
; made by: mmetelka; issues:
#166027
Actions
; made by: mmetelka; issues:
#166027
<attr name="PreferencesKey" stringvalue="boolean-key-name"/>
together with <attr name="PreferencesNode" stringvalue="prefstype:/nodepath"/>
where prefstype
can be
Preferences.systemRoot()
Preferences.userRoot()
NbPreferences.root()
Preferences
instance or it can be a Lookup
with the Preferences
instance in it.
The action will be represented by check box menu item in both menu and popup menu automatically.
HtmlBrowser
; made by: saubrecht; issues:
#169240
HtmlBrowser
; made by: saubrecht; issues:
#169241
Actions
; made by: jtulach; issues:
#168547
<attr name="asynchronous" boolvalue="true"/>
attribute. This extends these new factories with capabilities
already present in old SystemAction
, thus makes
it easier to migrate from old to new while retaining compatible
behaviour.
HtmlBrowser.dispose
HtmlBrowser
; made by: saubrecht; issues:
#167901
Actions
Openable
Closable
Editable
Viewable
Printable
; made by: jtulach; issues:
#166658
Two new factory methods for creating context and callback actions and bunch of context interfaces.
As part of introduction of the context interfaces, several already existing interfaces (usually carrying Cookie suffix in their name) were retrofitted to extend these new alternatives. This is binary and semantically compatible (as the methods closure remains the same) and the module providing cookies already had a runtime dependency on org.openide.awt module. However this change can cause problems during compilation. Those who compiled against Nodes API only and implemented one of the cookie interfaces need to add (compile time) dependency on org.openide.awt as well.
NotificationDisplayer
Notification
; made by: saubrecht; issues:
#159614
StatusDisplayer
; made by: saubrecht; issues:
#156357
Actions
; made by: jtulach
SpinButton
; made by: jtulach
rt
. The type of the field was a package private class.
As such the field was inaccessible to API users. Because this is not
checked as an error with our new
signature test infrastructure,
we made the type of the field visible.
DropDownButtonFactory
; made by: saubrecht; issues:
#102614
TabbedPaneFactory
; made by: saubrecht; issues:
#55845
JTabbedPane
that displays a small 'close' button in each tab.
When user clicks the close button a PropertyChangeEvent
is fired from the
tabbed pane.
Actions
; made by: dstrupl; issues:
#93519
DynamicMenuContent
JInlineMenu
JMenuPlus
JPopupMenuPlus
Actions
; made by: mkleint; issues:
#35827
JInlineMenu
, this new
interface was added that allows to handle dynamic content in Presenter.Menu
and Presenter.Popup.
If the instance returned by Presenter.Menu/Popup is an instance of DynamicMenuContent, it's methods are
consulted when creating/updating the menu.
JInlineMenu
rewritten to use this new approach in a backward compatible way, however changed during visibility of the menu are not supported.
JMenuPlus
and JPopupMenuPlus
are deprecated and behave exactly like their standard Swing counterparts.
Actions.Submenu
and Actions.MenuItem
now implement DynamicMenuContent
interface.
StatusLineElementProvider
; made by: mkleint; issues:
#55828
SystemAction/Action
that causes it's icon not to be displayed in menu.
org.openide.awt.awt
; made by: mkleint
SystemAction putValue("noIconInMenu", Boolean.TRUE)
influences the display of the action
in the main menu, the item will have no icon there. Works for Actions that don't define custom MenuPresenter.
This property is considered temporary, applications building on top of the platform that
don't want this functionality, have to patch the actions' code.
HtmlBrowser
HtmlBrowser
; made by: jglick
The methods getBrowserImpl
and
getBrowserComponent
were added to HtmlBrowser
for use by core.
org.openide.filesystems.FileSystem.HtmlStatus
org.openide.nodes.Node
HtmlRenderer
org.openide.loaders.DataNode
; made by: tboudreau; issues:
#29466
getHtmlDisplayName
. An interface,
HTMLStatus
has been created which extends
FileSystem.Status
, has been created, which allows
filesystems to supply HTML formatted status information, by
implementing it on their FileSystem.Status
implementation.
Filesystems which delegate to other filesystems my implement
FileSystem.HtmlStatus and simply return null for filesystems which
do not support it.
If one is present, DataNode will use it to supply HTML formatted
text to Explorer. The renderer itself can be found in
org.openide.awt.HtmlRenderer.
org.openide.util.actions.CallableSystemAction
; made by: jtulach; issues:
#39640
CallableSystemAction
that return true
from their asynchronous
method are executed outside of AWT thread.
However as most actions shall be executed synchronously, it is still required
for a subclass of CallableSystemAction
to override the method
with own implementation otherwise a warning is printed.
There is a special contract to allow asynchronous actions to be executed
synchronously, by using special ActionEvent
with waitFinished
as action command.
org.openide.util.actions.SystemAction
org.openide.awt.awt
; made by: dstrupl; issues:
#32256
org.openide.awt.Mnemonics
added
Mnemonics
Actions
; made by: jglick; issues:
#26640
org.openide.awt.Mnemonics
was introduced as a
centralized and convenient place to set localized text for a variety of
components while properly handling mnemonics in a variety of
international scripts.
org.openide.windows.TopComponent
; made by: pzavadsky; issues:
#30231
According to changes in action system (see the change 3.29),
also the method TopComponent.getSystemActions()
is replaced by TopComponent.getActions()
method.
org.openide.awt.awt
; made by: jtulach pzavadsky; issues:
#27868
Introduction of new action system, which generally means
move from usage of SystemAction
to Action
instances.
Further step would be declarative actions
usage which is not subject of current change, it will be part of later changes.
org.openide.awt.ToolbarPool
ToolbarPool
. Now any module can create its
own ToolbarPool
and use it.
HtmlBrowser
HtmlBrower.setFactory()
is deprecated and its functionality
can be obtained by registering HtmlBrowser.Impl
in Lookup
folder. This allows to register more browsers in IDE, create
customizable browsers and switch between them.
org.openide.awt.Toolbar
Toolbar(String name, String displayName)
Toolbar(String name, String displayName, boolean floatable)
setDisplayName(String displayName)
String getDisplayName()
Toolbar
org.openide.awt.Toolbar
DnDEvent
(dx
, dy
, name
, and
type
); public methods serving only to implement
MouseInputListener
have been removed (as well as the
implements-clause for this interface); BASIC_HEIGHT
now
final (it was static and only intended as a constant, so this is not
incompatible).
boston
. It is possible but unlikely that the first two
changes could cause incompatibilities; normally only the core
implementation uses the Toolbar
class anyway.
Actions
; made by: jglick
ButtonBridge
has protected method with which it is possible
to specify whether or not to use textual icons rather than empty ones if
an action has no icon.