XDocletActionForms

1. Even after creating this task, I found that Hibernate doclet still seemed to need XDoclet's ejb module in the classpath. This is because the apache module has references to a bunch of tasks that depend on EjbDoclet. Removing these tasks when building is a workaround, but adding the xdoclet-ejb module to the classpath is the easiest solution.

2. If using Ant 1.5.x, and you're using Struts, you will get the following error when you run "ant compile" with 1.5.

compile-web: xdoclet (XDocletMain.start 47 ) Running xdoclet java.lang.NullPointerException xdoclet at java.util.StringTokenizer.(StringTokenizer.java:146) xdoclet at xdoclet.tagshandler.PackageTagsHandler.getPackageNameFor(Pack ageTagsHandler.java:61) xdoclet at xdoclet.modules.apache.struts.ActionFormTagsHandler.getAction FormClassFor(ActionFormTagsHandler.java:46) xdoclet at xdoclet.modules.apache.struts.ActionFormSubTask.getGeneratedF ileName(ActionFormSubTask.java:132) xdoclet at xdoclet.TemplateSubTask.generateForClass(TemplateSubTask.java :751)

3. If I define the "xdoclet" task inside the "compile-web" target, it will work, but only when I call that target explicitly. When I make another target depend on it, I get the following error with Ant 1.5.x.

file:c:/Source/appfuse/build.xml:779: Class xdoclet.modules.apache.struts.Action FormSubTask doesn't support the nested "packageSubstitution" element.

NOTE: The original reference e-mail for the above issues is on the XDoclet Developers mailing list at: http://article.gmane.org/gmane.comp.java.xdoclet.devel/15319

4. If I put the xdoclet outside of any targets it seems work fine, however the error "destDir attribute must be present" shows up every so often. More information in XDoclet's JIRA: http://opensource.atlassian.com/projects/xdoclet/browse/XDT-879

5. My final solution: Move the xdoclet/actionform task into it's own target and prevent it from executing if it doesn't need to.

Below is a list I created while comping up with a solution.