To maintain binary compatibility, method implementations may be injected at runtime, in a form of a superclass in the class' inheritance hierarchy. Modules compiled against older version of APIs which contains MethodReferences to methods removed from the oficial APIs will be then linked according to JVM Resolution algorithm to a matching method present in the superclass of the referenced type.
Annotations are used to instruct the ClassLoader to make transformations to the API classes. PatchFor causes the annotated class to be injected as a superclass of the API class identified by the annotation's value. ConstructorDelegate marks a method, which is called as constructor implementation in the case that it is necessary to preserve a constructor for binary compatibility.Question (arch-time): What are the time estimates of the work? WARNING: Question with id="arch-time" has not been answered! Question (arch-quality): How will the quality of your code be tested and how are future regressions going to be prevented? WARNING: Question with id="arch-quality" has not been answered! Question (arch-where): Where one can find sources for your module? WARNING: Question with id="arch-where" has not been answered!
The default answer to this question is:
These modules are required in project.xml:
The entire API is one public package. ModulesAPI
The implementation is in another package and is not considered
public, though it is made available to
apisupport as these special modules deal directly with
the module system at a deeper level than the API provides for.
Yes, module JARs and associated resource JARs must be real files. They are loaded as defined by module enablement XML files.
Module enablement XML files are loaded via Filesystems. The public
API (partially) specifies them only in these terms.
autoupdate uses Filesystems to manipulate them when
necessary, though it relies on some additional
implementation-specific knowledge of their format (which is fairly
stable, especially since changes are limited by compatibility
constraints on old user directories). The NetBeans build scripts use
some additional implementation knowledge to pregenerate suitable XML
files for modules included in the application distribution.
org.openide.util.Lookupor any similar technology to find any components to communicate with? Which ones? Answer: All registered
InstalledFileLocatorinstances are queried and used to implement
InstalledFileLocator.getDefault(). Question (lookup-register): Do you register anything into lookup for other code to find? Answer:
TestModuleDeployer(from META-INF), used by apisupport
InstalledFileLocator(from META-INF), used by its public default method
ModuleInfo, via a custom lookup insertion (specified in API)
ClassLoader, via a custom lookup insertion (used broadly)
System.getProperty) property? On a similar note, is there something interesting that you pass to
java.util.logging.Logger? Or do you observe what others log? Answer: netbeans.home - NetBeans installation directory. netbeans.user - User directory. netbeans.dirs - Additional installation component directories. netbeans.systemclassloader.patches - Classpath appended to the system class loader. Used for automated testing infrastructure. netbeans.classpath - May be used to prepend items to the same class loader as is used for openide.jar and core.jar, similarly to JARs found in lib/patches/. netbeans.cache.manifests - By default true, may be turned off to disable manifest caching. netbeans.patches.MODULE.CODE.NAME.BASE - Patch directories or JARs to add to the class loader for a module, besides patches/MODULE-CODE-NAME-BASE/*.jar. netbeans.preresolve.classes - If true, all module classes are forcibly loaded at startup, to help detect possible linkage errors. org.netbeans.core.modules.NbInstaller.noAutoDeps - Disables automatic module dependency upgrades. org.netbeans.core.modules - If set to 0, enables logging for the module system. org.netbeans.core.modules.NbInstaller.NO_COMPAT_AUTO_TRANSITIVE_DEPS - Disabled automatic transitive class loader dependencies for old modules. netbeans.modules.quiet - Avoids text messaging (other than
ErrorManagerlogging) to the console from the module system. netbeans.moduleitem.dontverifyclassloader - Suppresses checks to ensure that module section classes are actually loaded from the module itself. netbeans.full.hack - Avoids using GUI when user-visible error conditions occur. netbeans.mainclass - Name of class from core.jar which will handle most of the startup sequence; by default, org.netbeans.core.Main. netbeans.security.nocheck - Suppress security checks in the VM, even from "untrusted" code. netbeans.classloader.verbose - Prints messages when resources or classes are loaded from JARs. netbeans.cache.layers -
Used to control the XML layer cache mechanism. Value may be a
fully-qualified class name to load as a manager (implement
- to disable caching and always parse the XML
layers directly. Current default is to use a binary cache
instanceof, work with
java.lang.Class, etc.)? WARNING: Question with id="exec-introspection" has not been answered! Question (exec-threading): What threading models, if any, does your module adhere to? How the project behaves with respect to threading? WARNING: Question with id="exec-threading" has not been answered! Question (security-policy): Does your functionality require modifications to the standard policy file? WARNING: Question with id="security-policy" has not been answered! Question (security-grant): Does your code grant additional rights to some other code? WARNING: Question with id="security-grant" has not been answered!
java.awt.datatransfer.Transferable? Answer: N/A
org.netbeans.core.ui.ModuleBeanis a Swing-safe bean that serves as a nonblocking wrapper for all module system modifications and is used e.g. in the Modules node. Question (perf-huge_dialogs): Does your module contain any dialogs or wizards with a large number of GUI controls such as combo boxes, lists, trees, or text areas? Answer: No. Occasionally small dialogs only. Question (perf-menus): Does your module use dynamically updated context menus, or context-sensitive actions with complicated and slow enablement logic? Answer: No. Question (perf-spi): How the performance of the plugged in code will be enforced? WARNING: Question with id="perf-spi" has not been answered!