System properties can influence the behaviour of the running IDE in various ways. The most convenient place to specify them is in etc/netbeans.conf file. This page summarizes the list of such extension points defined by modules with API.
To get your API listed here, use
<api type='export' group='systemproperty' ... />
in
your module arch.xml document.
If a longer message is logged the ant logger will handle the message as plain text and will not try to hyperlink, color, fold, etc.
If not set by the user a default value of 3000 will be used.
VirtualMachine.setDebugTraceMode()
method. See the javadoc
of that method for the description and possible values.
Setting this property affects the associated module autoupdate.ui.
Setting it to true
results in the detailed view (all visible plugins) been selected
when Installed tab is opened in Plugin Manager.
Otherwise the simple view (high-level features) is selected.
-J-Dorg.netbeans.modules.editor.completion.slowness.report
property to more than 2000 ms (the default value).
If set to true
, displays a truncated version of Java package
names, usually in the Projects tab.
If a longer message is logged the ant logger will handle the message as plain text and will not try to hyperlink, color, fold, etc.
If not set by the user a default value of 3000 will be used.
If set to true
, displays a truncated version of Java package
names, usually in the Projects tab.
If a longer message is logged the ant logger will handle the message as plain text and will not try to hyperlink, color, fold, etc.
If not set by the user a default value of 3000 will be used.
ensure.built.source.roots
property is set during ant script execution,
the javac
task will not actually build the classfiles from scratch, but rather copy classfiles
produced by the Java infrastructure into the output folder. The content of the property will
be interpreted as list of source roots, for which the artifacts should be copied.
If set to true
,
*.class
files generated by external build processes
will not be overwritten by the IDE’s Java parser
when running in “compile-on-save” mode
unless the class files are older than the corresponding source file.
If defined, limits search for a parent project to a certain subtree. The property defines absolute path of a folder
where upwards search for a project in parent folders is terminated. Queries outside of the root will not find any project.
Currently used for tests so the tested runtime does not escape the workdir.
org.netbeans.modules.uihandler.Submit
property when invoking NetBeans.
org.netbeans.modules.uihandler.Submit
property when invoking NetBeans.
true
, changes default value of the
asynchronous()
method. Useful for unit tests
which would prefer to run all tested actions synchronously.
path
attribute. By default, when running inside NetBeans IDE,
apisupport.project
registers such class and provides
items representing valid paths in current project.
If true
, better diagnostic information will be available as to when file input or
output streams were opened that prevent a file from being deleted because they were not closed.
This information comes at a performance cost, however.
Since 7.25 the
The creation of real node is scheduled to background and as soon as
the
DataObject
and its
Node are
ready, the initial dummy node is replaced by the real one.
This whole system is slightly incompatible and may complicate creation
of filtered views over the node hierarchy (one needs to be ready to
really dynamics changes). That is why it is possible to disable
the new DataFolder.getNodeDelegate()
tries to prevent
creation of
DataObject
in AWT dispatch thread. Rather it creates dummy node with name
derived from the name of the file and simplified content of lookup:
delayed
system by starting the system with
-Dorg.openide.loaders.FolderChildren.delayedCreation=false
.
Use this property as a temporary fix for your problems, but consider
fixing your code to support the delayed mode
in the future.
DataObject.copy, move, createFromTemplate
are executed in insecure way. That means that other threads can access the
products of such operation before it finishes. This is a friend contract
with projects, that need to do such strange things. Will be removed when they
fix it.
ErrorManager
logging) to the console
from the module system.
Used to control the XML layer cache mechanism. Value may be a
fully-qualified class name to load as a manager (implement
org.netbeans.core.projects.cache.LayerCacheManager
),
or -
to disable caching and always parse the XML
layers directly. Current default is to use a binary cache
manager.
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().
org.openide.util.Lookup.paths=Folder1:Folder2:Folder3
.
If this property is set prior to first call to
Lookup.getDefault(),
it is split into pieces (separator is ':'
) and individual
parts are then used to construct Lookups.forPath("Folder1")
,
etc. All these lookups then become part of the
Lookup.getDefault()
one. This property works since version 7.24
-J-Dnetbeans.winsys.imageSource=org/netbeans/core/resources/splash.gif
-J-Dnetbeans.winsys.fade.on=true
-J-Dnetbeans.winsys.disable_dnd=true
TopComponent
S between editor(document) and view
which is restricte otherwise.
It is experimental now.
-J-Dnetbeans.winsys.allow.dock.anywhere=true
-J-Dnetbeans.winsys.hideEmptyDocArea=true
-J-Dnetbeans.winsys.statusLine.in.menuBar=true
-J-Dnetbeans.winsys.no_toolbars=true
org.openide.awt.MenuBar
.
This alternative menu bar will be used instead of the default one.
-J-Dnetbeans.winsys.menu_bar.path=foo/bar.instance
javax.swing.JComponent
.
This alternative status line will be used instead of the default one.
-J-Dnetbeans.winsys.status_line.path=foo/bar.instance
-J-Dnetbeans.winsys.no_help_in_dialogs=true
If set to false
, windows opened (e.g. TopComponent.open
) using the
dummy fallback window manager will not really be set to be visible. Useful for unit tests which
must incidentally use the Window System API but for which actual display of windows is undesirable.