On Tue, 2007-05-29 at 22:37 +0800, hitdemo2002hitdemo2002 wrote:
> i am newbie to xdoclet, now i am using xdoclet to generate hibernate's
> hbm file.
>
> <hibernatedoclet destdir="${src.dir}"
> excludedtags="@version,@author,@todo" force="false"
> mergedir="${src.dir}" verbose="false">
>
> but i don't know the detail meaning of excludedTags/force/verbose
> attribute,
> there are no more explain on them at document, such as
> excludedTags="@version,@author", document say that there should not
> include @version information at generated file,does it mean, if my
> class annotation like this
> /**
> * @hibernate.class table="exampletable"
> * @author hitdemo
> * @version 1.5
> */
> public class ExampleBean extends BaseObject implements Serializable {
> ......
>
> 1.5 and hitdemo will not appear in generated ExampleBean.hbm.xml?
>
> in fact,even i get rid of @version,@author from excludedtags,there are
> no "1.5" and "hitdemo" appear in ExampleBean.hbm.xml,so i was
> confused.
>
> so the force and verbose, does anyone give me a detail explain or
> example?
excludedtags may not apply to the hibernate subtask. I think it's
related to the <XDtClass:classComment/>, <XDtClass:classCommentText/>
and <XDtClass:classCommentTags/> template tags, which some of the
subtasks (mainly the ejb one, I think) use to copy the javadocs from a
user-maintained class into a generated class. Since certain javadoc
@tags don't really apply in this situation (e.g. the "author" of the
generated class is XDoclet itself), the excludedtags setting specifies
those tags that should not be copied. If this setting was implemented
in the base XDoclet task or some common subtask ancestor, it would also
have been inherited by the hibernate subtask. However, if the hibernate
templates don't use the same template tags (which is likely if it's not
a class file that's being generated) then the excludedtags setting will
appear to have no effect.
force is used to make XDoclet regenerate all generated files even if it
thinks they are up to date (i.e. the timestamps on the generated files
are all newer than the timestamps of the source files they are based
on).
Not sure about verbose, as I would have thought the level of logging
would be determined by the log4j settings.
Andrew.
--
http://pseudoq.sourceforge.net/ Open source Java Sudoku application
-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
xdoclet-user mailing list
xdoclet-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/xdoclet-user
