WARNING: The dojo and json jars have been renamed in the current workspace and hence the milestone 10 build will no longer work with our latest nightly woodstock jars.

NetBeans Visual Web Pack (VWP) has several sets of built-in components. One of these is a built-in version of Project Woodstock components designed to be used with Java EE 5 containers. This note describes how to update these components with a different version. Please send comments to the dev@woodstock.dev.java.net email list.

Update 2007-07-02: these instructions should work with a current version of the NetBeans 6 trunk around milestone M10. Feel free to report issues to the dev@woodstock.dev.java.net email list. Unfortunately, I was not able to find simpler steps. Please let me know if you find any.

All code having to do with IDEs are under the top-level "ide-plugins" directory. This code needs to be linked in with certain IDE-specific libraries and cannot be built without them.

Updation of woodstock components in Netbeans:-

The is procedure works only for JDK5, we have an issue with JDK6 which is under fixing process. You should have an account in CVS woodstock-dev-java-net https://woodstock.dev.java.net/source/browse/woodstock/.

Install Procedure

1. Set JAVA_HOME to jdk5's installed path

2. Install the Netbeans6 Milestone build http://bits.netbeans.org/netbeans/6.0/.

3. Check out a version of the Project Woodstock tree(cvs->woodstock). Currently, only the main trunk of the Woodstock tree has been tested so other branches may not work. There should not be any space in between the checked out path like C:\Program Files\ or C:\Documents and Settings. Sometimes it creates problem while building the project.So Checkout project woodstock in a path where spaces can be avoided.

4. In NetBeans6 , Goto File-> Open Project Now goto the path where you have checked out woodstock and open "woodstock/ide-plugins/netbeans/woodstock-suite" project.

5. Set woodstock-suite as the main project(File-> Set as main project). Now build the project(build->Build Main project). Here you will get some annotation error's, but this will not affect the build.

6. After building the project woodstock suite. Go to the Projects Window and execute "Create NBMs" (Rightclick on "woodstock suite"-> click "create NBMs")from the context menu.

7. Now a directory called updates will be created(woodstock/ide-plugins/netbeans/woodstock-suite/build/updates) This has two generated NBMs files in the woodstock suite build directory.("woodstock/ide-plugins/netbeans/woodstock-suite/build/updates/*.nbms". )

8. Execute the project : Run->Run Main Project which will run another instance of the IDE using a different userdir

9. Goto Tools->Plugins->Downloaded Tab->Add Plugins in the new netbeans IDE. NetBeans6 has a new Plugin installation dialog.

10. Browse to location of built NBMs(woodstock/ide-plugins/netbeans/woodstock-suite/build/updates/*.nbms) and use multi-select to add both of them. Two selected modules should appear in the left pane.

11. Then Press "Install" and follow the instructions

12. Click on finish and now restart the IDE(two options will be there 1.restart now,2. Restart later, select option1 it will restart the ide automatically)

13. Now in the new IDE goto Tools->Plugins to check that the new modules were installed. On the "Settings" tab, select "View->NetBeans Modules". Switch to "Installed" tab and search for "project woodstock". Check that the installed version is correct.

14. Create a webapplication in the new IDE. The palette in the new ide contains the updated components.

Undo Install Procedure

Unfortunately, the Plugin UI does not allow one to undo the install. I have found a workaround, though. If you installed using the procedure above, then the new modules will be installed locally in the test userdir. For example, "woodstock/ide-plugins/netbeans/woodstock-suite/build/testuserdir". The original modules will still exist globally in the NetBeans install directory. So to uninstall, you can exit the test IDE, go into the test userdir and remove files there. If you don't have any other local modules installed, then you can simply delete the "modules" directory and restart the IDE. You may also need to delete the "update_tracking" subdirectory.

Iterative Development Procedure

If you are developing design-time code for a component, one simple way is to always build everything. However, this takes a while. For example, if you are changing a BeanInfo class, then you need to run the "dist" target in the "master" directory to create a new design-time jar. Then you can perform the build and install steps above and test your code. If you find a bug, then you need to undo your install and then fix the code and start over. It is possible to take shortcuts but requires more knowledge. For example, if you are only fixing problems in the palette, then only the code under "ide-plugins" needs to be rebuilt.

Often times is is useful to debug code running in a test IDE. One way to do this is to attach to it using a remote debugger of a separate IDE. As I understand it, if you are developing with NetBeans, you can use the "Debug Main Project" action instead of "Run Main Project" to debug the test IDE.

Adding Components to the Palette

For the Woodstock components to appear on the palette, the project must be a Java EE 5 project. Java EE 1.4 projects use a different set of components. In addition, any new components must have a corresponding palette item file in the NetBeans system filesystem. For examples, see the layer.xml file in the "woodstock/ide-plugins/netbeans/woodstock-suite/components" project source code and other files in the "resources" subdirectory.

Other Notes

As of 2007-04-04, the current woodstock trunk does not build using Java SE 6 because of a bug. So I used Java 5.
As of 2007-07-02, the code under "visual-web-nbsuite" is obsolete and will be removed in the future.

Updates

2007-08-01 Updated the instructions- done by Bharathi Hemanth Kumar
2007-07-20 Updated info to emphasize that Java 5 must be used to compile.
2007-07-02 Updated instructions to work with NetBeans 6 trunk around milestone M10.
2007-05-29 Added update about problems.
2007-04-04 Updated info with latest tested configuration
2007-03-22 Added info about trunk and branches
2007-03-14 Added info about palette
2007-03-09 Initial version.

-- EdwinGoei

Topic InstallingWoodstockComponentsInNetBeans . { Edit | Ref-By | Printable | Diffs r24 < r23 < r22 < r21 < r20 | More }

java.net RSS

Revision r24 - 2007-10-09 - 19:16:37 - mlaut05 Parents: People > EdwinGoei	TWiki (TM) Copyright ©