NetBeans Architecture Answers for Utilities module

WARNING: answering questions version 1.25 rather than the current 1.26.

Interfaces table

Group of java interfaces
Interface NameIn/OutStabilitySpecified in What Document?
UtilitiesAPIExportedOfficial .../org/openide/util/doc-files/api.html

LookupAPIExportedOfficial .../util/lookup/doc-files/lookup-api.html

allows the discovery

LookupSPIExportedOfficial .../util/lookup/doc-files/lookup-spi.html

simplifies creation and registration of own lookup objects

ProviderRegistrationMechanismImportedStandard ...//

ProviderRegistrationRemovalExportedUnder Development .../org/openide/util/doc-files/api.html

AWTBridgeExportedPrivate .../modules/openide/util/

a class that is looked up in Lookup.getDefault() and if registered can provide better UI elements for Actions.


XMLUtil class is loading a class from core/core.jar to initialize the correct parser factory. This is a fix for issue 68942.

SharedClassObject.setAccessibleExportedUnder Development .../org/openide/util/SharedClassObject.html

used to instantiate subclasses.

WeakListener.setAccessibleExportedUnder Development .../org/openide/util/WeakListeners.html

used to call the remove method using reflection

Lookups.metaInfServicesExportedUnder Development .../org/openide/util/lookup/Lookups.html

calls constructor of registered classes using reflection

Group of property interfaces
Interface NameIn/OutStabilitySpecified in What Document?

which is similar to localization but also supports changes of resorces for application build on top of NetBeans. This is handled by our class NbBundle which reimplements the JDK's standard ResourceBundle to to take branding into the consideration.


read from JComponent.getClientProperty to simulate the standard javahelp behaviour and extract the help id for given component.


SystemAction reacts to expected requests from UI Utilities module for iconBase property by returning value based on its result of its iconResource() method.


For purposes of
SystemOption the SharedClassObject handles getProperty ("org.openide.util.SharedClassObject.initialize") in a special way, by returning null if initialization is not running and Boolean.TRUE if it is.

OpenIDE-Transmodal-ActionExportedUnder Development

CallbackSystemAction checks whether action.getValue("OpenIDE-Transmodal-Action") returns Boolean.TRUE to enable it in dialogs, otherwise the action is disabled when there is an open dialog.


Influences results of Utilities.getUsableScreenBounds


Influences results of Utilities.getUsableScreenBounds


used on few places

org.openide.util.LookupExportedUnder Development

checked by the initialization of the
Lookup.getDefault() and can contain name of a class that extends org.openide.util.Lookup and has public constructor, that should be instantiated and returned from Lookup.getDefault() the class will be loaded by Thread.currentThread().getContextClassLoader() classloader the first time Lookup.getDefault is invoked.

The property can also contain value "-" which means to completely disable the lookup instantiation and return Lookup.EMPTY from Lookup.getDefault().

If the property is unspecified, the default MetaInfServicesLookup is constructed for Thread.currentThread().getContextclassLoader() that implements the JDK's standard. If, by a chance an instance of Lookup.Provider is found in there, its lookup is returned as result. Otherwise the MetaInfServicesLookup is the result of Lookup.getDefault().

Group of interfaces
Interface NameIn/OutStabilitySpecified in What Document?
FileLocationExportedUnder Development

the JAR file is located in platform cluster under lib/org-openide-util.jar


Utilities.translate reads META-INF/netbeans/translate.names files from JARs

Group of lookup interfaces
Interface NameIn/OutStabilitySpecified in What Document?

because of the API separation,
CallableSystemAction uses lookup for ActionsBridge provided by org-openide-actions module when looking for org.openide.actions.ActionManager implementation.

LookupInitializationLookupExportedUnder Development#property-org.openide.util.Lookup

during initialization of the Lookup.getDefault() the Lookup.Provider is being searched

LookupSharedClassObjectExportedUnder Development

singleton subclasses of
SharedClassObject are searched for using Lookup.


actionsGlobalContext searches for ContextGlobalProvider in Lookup.getDefault(). The provider is usually provided by window system implementation.

LookupEntityCatalogExportedUnder Development

EntityCatalog delegates its methods to all instances of EntityCatalogs found in Lookup

LookupErrorManagerExportedUnder Development

ErrorManager delegates its methods to all instances of ErrorManagers found in Lookup

LookupClassLoaderExportedUnder Development

Nearly all resource looking functions and reflective code uses
ClassLoader obtained from Lookup.getDefault() for loading system wide resources.

General Information

Project and platform dependencies


Compatibility with environment

Access to resources

Lookup of components

Execution Environment

Format of files and protocols

Performance and Scalability

Built on July 11 2007.  |  Portions Copyright 1997-2005 Sun Microsystems, Inc. All rights reserved.