I like xdoclet but ...

midas · **Joined:** Wed Sep 03, 2003 8:04 am **Posts:** 55

xdoclet still can NOT work well. I used HibernateXdocletTask to produce *.hbm.xml and it indeed do it. However what it produced is not what i want :(
for example,

Code:

  .i have no 'name' property but xdoclet produced a 'name' property
  .my ID is 'native' but xdoclet produced a 'assigned'
  ...

it seems xdoclet doesnot care about my attribute tags in java source file,and do a default operation ?

any suggestion is appreciated !

david · **Posted:** Wed Dec 01, 2004 7:07 pm

I use it, so do many users. I assure you its not (as) broken as you are suggesting. Could be your doing something wrong? Maybe.

Look at some of the examples linked from the wiki as many are based on Xdoclet.

midas · **Joined:** Wed Sep 03, 2003 8:04 am **Posts:** 55

thanks for your answer firt. here is ant target used to produce hibernate mapping files:

Code:

   <target name="hbm" depends="compile">
      <taskdef name="hibernatedoclet" classname="xdoclet.modules.hibernate.HibernateDocletTask">
         <classpath>
            <fileset dir="${xdoclet.lib.dir}">
               <include name="*.jar"/>
            </fileset>
         </classpath>
      </taskdef>

      <hibernatedoclet destdir="${classes.dir}" excludedtags="@version,@author,@todo"
            force="true" verbose="true" mergedir="${classes.dir}">
         <fileset dir="${src.dir}">
            <include name="**/dos/*.java"/>
         </fileset>
         <hibernate version="2.0"/>
      </hibernatedoclet>
   </target>

. Question.java

Code:

public class Question
{
   private Long _id;
   private String _subject;

   
   public Question() {}

   /**
    *   @hibernate.id   column="id" generator-class="native"
    */
   public Long getId() {
      return _id;
   }
   public void setId(Long id) {
      _id = id;
   }

   /**
    *   @hibernate.property
    *      column="subject" lenght="30" not-null="true"
    */
   public String getSubject() {
      return _subject;
   }
   public void setSubject(String subject) {
      _subject = subject;
   }
......

When using xdoclet-1.2.2. and run "ant hbm", no output generated :(

it seems xdoclet doesnot see Question.java ?!

khote · **Posted:** Fri Dec 03, 2004 12:54 pm

Code:

/**
 * @hibernate.class
 *
 */
public class Question 
{ 
   private Long _id; 
   private String _subject; 

    
   public Question() {} 

   /** 
    *   @hibernate.id   column="id" generator-class="native" 
    */ 
   public Long getId() { 
      return _id; 
   } 
   public void setId(Long id) { 
      _id = id; 
   } 

   /** 
    *   @hibernate.property 
    *      column="subject" lenght="30" not-null="true" 
    */ 
   public String getSubject() { 
      return _subject; 
   } 
   public void setSubject(String subject) { 
      _subject = subject; 
   } 
...... 

You must tell XDoclet that it is a hibernated class, or subclass.
Look at the difference between class-level and method-level tags.[/quote]

midas · **Joined:** Wed Sep 03, 2003 8:04 am **Posts:** 55

The folllowing is relativly complete code:

Code:

package com.zsoft.dos;

/**
 *   @hibernate.class table="question"
 */
public class Question
{
   private Long _id;
   private String _subject;
   
   public Question() {}

   /**
    *   @hibernate.id   generator-class="sequence" column="id"
    *   @generator-parameter-name="sequence" generator-parameter-value="GEN_POST"
    *      
    */
   public Long getId() {
      return _id;
   }
   public void setId(Long id) {
      _id = id;
   }

   /**
    *   @hibernate.property
    *      column="subject" lenght="30" not-null="true"
    */
   public String getSubject() {
      return _subject;
   }
   public void setSubject(String subject) {
      _subject = subject;
   }

}

d:\ant hbm

Code:

Buildfile: build.xml

init:

compile:
    [javac] Compiling 9 source files to F:\z\usr\src\qa-china\build\WEB-INF\clas
ses

hbm:
[hibernatedoclet] (XDocletMain.start                   47  ) Running <hibernate/
>

BUILD SUCCESSFUL
Total time: 1 minute 15 seconds

but no Question.hbm.xml generated !!!
[/b]

david · **Posted:** Sat Dec 04, 2004 7:19 pm

Two things:

1) You have not configured XDoclet correctly. It is missing the location to use for the output.
For example:

Code:

   <target name="hibernate.xdoclet"
        description="Generates Hibernate mapping files with XDoclet.">

        <hibernatedoclet
            destdir="${src.dir}"
            excludedtags="@version,@author,@todo"
            force="true"
            mergedir="${build.dir}"
            verbose="false">

            <fileset dir="${src.dir}">
                <include name="**/*.java"/>
            </fileset>

            <hibernate version="2.0"/>

        </hibernatedoclet>

    </target>

See destdir attribute.

2) Less importantly, your markup has spelling errors.

Quote:

/**
* @hibernate.property
* column="subject" lenght="30" not-null="true"
*/

The length attribute is not correct. I have not looked that closely, it just jumped out at me.

midas · **Joined:** Wed Sep 03, 2003 8:04 am **Posts:** 55

Code:

<hibernatedoclet 
[b]destdir="${classes.dir}" [/b]
excludedtags="@version,@author,@todo"
            force="true" verbose="true" mergedir="${classes.dir}">
         <fileset dir="${src.dir}">
            <include name="**/dos/*.java"/>
         </fileset>
         <hibernate version="2.0"/>
/hibernatedoclet>

i indeed include destdir attribute ?!

david · **Posted:** Sun Dec 05, 2004 10:05 pm

OK so you did. I missed it due to the formating.
Why is the destination directory in the class.dir (build location) rather than the source directory?
Is a build operation deleting this directory or the contents of it?

Anyway, I suggest you download the tools example package and try it out. It does cover XDoclet and it should provide a working example from which you can explorer and compare with your own installation.

midas · **Joined:** Wed Sep 03, 2003 8:04 am **Posts:** 55

sorry to disturb you ! it is a foolish question :(

The *.hbm.xml has been generated successfully but i cannot find it before.
because hbm.xml is put into ${dest-dir}/com/zsoft/dos/ not ${dest-dir}

clever xdoclet ,right ?

david · **Posted:** Wed Dec 08, 2004 6:43 am

Yes the dist directory is the base directory as XDoclet does a recursive search for all *.java files from the fileset.

ko5tik · **Posted:** Wed Dec 08, 2004 9:34 am

midas wrote:

sorry to disturb you ! it is a foolish question :(

The *.hbm.xml has been generated successfully but i cannot find it before.
because hbm.xml is put into ${dest-dir}/com/zsoft/dos/ not ${dest-dir}

clever xdoclet ,right ?

Yep. pretty clever :) It respects your package structure and places generated mapping alongside with class file ( where hibernate will look for it, if you register classes in confuguration )

If you are plagued by typos in xdoclet tags, go for xdoclet-2. It validates them...