S A M P L E   P R O J E C T  

The template uses the following tools, which you have to download before you can use it

2

: 

Ant 1.4.1 or higher: http://jakarta.apache.org/ant 

XDoclet 1.1.2 or higher: http://www.sf.net/projects/xdoclet 

JBoss 3.0 or higher: http://www.jboss.org 

Before going any further it is helpful to setup an environment variable pointing to the  ant  

home directory like  ANT_HOME  because you have to start the build file without a script. 

The  ant  script can be found in  ANT_HOME/bin/  directory and is name  ant . 

In order to create a new project take the template and copy it to your destination, rename it 

and then adjust the  .ant.properties  file: 

jboss.home: has to point to the root directory of your JBoss 3.0 installation 

xdoclet.home: has to point to the root directory of your XDoclet installation 

servlet lib.path: when you have a web application then uncomment it and adjust it to 

point to the servlet archive file 

adjust the other settings if necessary 

Whenever you need to adjust properties in the templates  build.xml  file please overwrite 

them in the  .ant.properties  instead. Just before we can start coding let us have a look at 

the directory structure. At the beginning there is only the  /src  directory which contains: 

 /etc : contains additional files 

 /bin : script files to run the Java client. The build file will later copy the file to 

the  /build/bin  directory and replace  jboss.home  and  java.home  according 

to its setting (see .ant.properties). Thus you can run it later without adjusting 

any directories. 

 /meta inf : contains not generated deployment descriptors and manifest files 

 /main : contains the Java source except resource files and JSP pages 

 /client : contains the client Java source files 

 /ejb : contains the EJBs source files 

2

 By the way, you do NOT need to download any of the Sun J2EE libraries to use JBoss   we save you this valuable download time. 

29