[Xdoclet-user] Abstract struts Action & LexicalError

[Kyle K. <kko...@ya...>]

(We are using Ant v1.6.1, XDoclet v1.2.1, & Struts v1.1)

Sorry if this seems like a newbie question...

NOTE: We have already asked this question on the Ant Users list, but
the consensus was that it is most likely an issue with XJavaDoc and not
Ant specifically and should be addressed here.

We are using the Webdoclet task to build our struts-config.xml file,
but are having some problems using a FileSet to select the files that
contain XDoclet tags for processing.

Brief overview...

- Several classes named ...\form\*Form.java
- Several classes named ...\action\*Action.java that are all children
of ...\action\FooBase.java (several helper methods common to all of our
struts Action classes)
- When we run the webdoclet task, we get a lexical error for the
FooBase.java file and the resulting struts-config.xml file is missing
tag data from other Action & Form classes

========== BEGIN: build.xml snippet ====================

<webdoclet force="true"
        destdir="${meta-data.home}" 
        mergedir="${meta-data.home}">
    <fileset dir="${src.home}">
        <include name="**/*Form.java" />
        <include name="**/*Action.java" />
    </fileset>
			
    <!-- build the deployment descriptor -->
    <deploymentdescriptor servletspec="2.3"
        destDir="${build.home}/WEB-INF"
        displayname="${webapp.name}"
        validateXML="true" />
			
    <!-- build the Struts Config file -->
    <strutsconfigxml version="1.1" 
        destDir="${build.home}/WEB-INF/conf"
        validateXML="true" />

</webdoclet>

========== END: build.xml snippet ====================

========== BEGIN: Ant output ====================

webdoclet:
[webdoclet] (XDocletMain.start                   47  ) Running
<deploymentdescriptor/>
[webdoclet] Generating web.xml.
[webdoclet] Error parsing File
C:\<...snip...>\action\FooBase.java:Lexical error:
xjavadoc.TokenMgrError: Lexical error at line 191, column 17. 
Encountered: <EOF> after : ""
[webdoclet] (XDocletMain.start                   47  ) Running
<strutsconfigxml/>
[webdoclet] (TemplateSubTask.engineStarted       794 ) Generating
output 'struts-config.xml' using template file
'jar:file:C:\<...snip...>\lib\XDoclet-v1.2.1\xdoclet-apache-module-1.2.1.jar!/xdoclet/modules/apache/struts/resources/struts_config_xml.xdt'.

========== END: Ant output ====================

It looks like the FooBase.java file is being included (even though it
doesn't match the FileSet) because it is the parent of all the Action
classes. Is there some sort-of tag that should be placed in the
FooBase.java class to let XJavaDoc know to skip it or is there
something else that I'm missing?

The strange part is that about 5% of the time we don't get this error
at all and all of the config files are generated correctly! The other
95% of the time we get the lexical error (even if nothing has changed
in the environment or in the files).

Thanks in advance for any help that can be given!


		
__________________________________
Do you Yahoo!?
Yahoo! Mail is new and improved - Check it out!
http://promotions.yahoo.com/new_mail