Navigating layer files
By sandipchitale on Jun 02, 2007
If you develop NetBeans modules you must be aware of layer files. The layer files are the NetBeans module system's mechanism for declarative registration of almost all aspects of module's functionality. The overall functionality of a NetBeans Platform based application is derived by merging the layer files contributed by all the modules in the application.
The NetBeans modules can be developed using the NetBeans IDE itself, using the NetBeans module projects. The NetBeans module project's logical view has the following nodes related to the layer file(s) (see the first screen shot below).
- Important Files/XML Layer/<this layer> - This node's children display the structure of the current modules layer file content.
- Important Files/XML Layer/<this layer in context> - This node's children display the structure of the merged layer file that will be effective when the module runs inside the NetBeans Platform based application. The layer files of the other modules in the module's suite or the NetBeans platform against which it is being deverloped are used to build this structure.
Sometimes it is desirable to quickly find out which layer file(s) a particular node comes from. Starting with today's (6/2/2007) build there is a context menu action called Open Layer File(s) just for such a pupose (see the screenshot below).
When the Open Layer File(s) action is invoked on a particular node, the layer file(s) which declares that node is opened in the editor window. Please note that a particular node (such as Actions folder) may be declared in more than one file, in which case all the layer files will be opened in the editor window. The layer file may be read-only if it comes from a module's jar file in the NetBeans platform against which this module is being built.
In the above screen shot the layer file of the debuggercore module project was opened because the Actions/Debug/New Breakpoint... action is declared by it.
The layer file may be owned by other module's in this modules suite. For modules in the NetBeans workspace the layer file may be owned by other NetBeans modules. In those cases you can use the Select in > Projects action in the layer file editors context menu to quickly open the owner project and select the layer file in it's local view. If that module project is not already open you will be prompted to open it as shown in the screen shot below.
I hope this helps you with your NetBeans module development. Enjoy!