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 ...//java.sun.com/j2se/1.3/docs/guide/jar/jar.html

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

AWTBridgeExportedPrivate .../modules/openide/util/AWTBridge.java

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

ParserFactoryImportedPrivate

The
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?
BrandingSupportExportedOfficialorg/openide/util/NbBundle.html

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.

HelpIDExportedStandardorg/openide/util/HelpCtx.html

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

iconBaseImportedStandard

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

org.openide.util.SharedClassObject.initializeExportedPrivate

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.

netbeans.screen.insetsExportedPrivate

Influences results of Utilities.getUsableScreenBounds

netbeans.taskbar.heightExportedPrivate

Influences results of Utilities.getUsableScreenBounds

line.separatorImportedStandard

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 java.io.File interfaces
Interface NameIn/OutStabilitySpecified in What Document?
FileLocationExportedUnder Development

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

TranslateNamesExportedOfficialorg/openide/util/Utilities.html

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

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

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.

LookupContextGlobalProviderExportedStable

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


Deployment


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.