Raible's Wiki

Raible Designs
Wiki Home
Recent Changes


  - Korean
  - Chinese
  - Italian
  - Japanese

QuickStart Guide
  - Chinese
  - French
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish
  - Japanese

User Guide
  - Korean
  - Chinese

  - Chinese
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish

  - Korean

Latest Downloads

Other Applications

Struts Resume
Security Example
Struts Menu

Set your name in

Edit this page

Referenced by

JSPWiki v2.2.33


Hide Menu


This is a list of questions that relate to AppFuse. You might also checkout the AppFuse Tutorials and StrutsResume Support pages. The Mailing List Archives or the AppFuse IRC channel might also be helpful.

Table of Contents

  • [1] Common Questions
  • [2] Development with AppFuse
  • [3] Security Questions
  • [4] Struts Specific HowTos
  • [5] JSF Specific HowTos
  • [6] Database Questions and HowTos
  • [7] Application Server Questions and HowTos
  • [8] Using Anthill and CruiseControl
  • [9] Hibernate Specific Questions
  • [10] Archived Questions

Common Questions [#1]

  • Where is UserForm.java?
The UserForm.java file is generated by XDoclet using Ant. If you run "ant compile" it gets generated into build/web/gen/org/appfuse/webapp/form.
This article explains it best.
  • Is this the right place to ask AppFuse questions?
Sure, but you'll probably get more visibility and input from the help forum or mailing list. Also, this wiki has recently been locked down b/c of spammers so you'll need to get a username/password from me to post anything. Don't forget that the mailing list archives are a great resources.
  • Why am I getting this error "Cannot create JDBC driver of class ' ' for connect URL 'null'"?
Chances are you forgot to run "ant setup-tomcat" (or "ant setup" if you need to set up the database as well). Also, if you're using Tomcat make sure you are using the latest recommended release.
  • Why do I get this error "build.xml:1037: taskdef class org.apache.catalina.ant.ReloadTask cannot be found"?
Ant cannot find the ReloadTask which is in $CATALINA_HOME\server\lib\catalina-ant.jar. You need to ensure env var CATALINA_HOME (Windows dir %CATALINA_HOME% or Unix ls $CATALINA_HOME) points to the tomcat install base directory. This error can also occur when you wrap the path in double quotes, (ie. if you have set CATALINA_HOME="c:\Tomcat 5.5" then remove the double quotes!).
  • How does build.properties and properties.xml fit together?
Ant has immutable properties. The first time a property is set, it cannot be changed. Here's the order of how properties are set in AppFuse.
command-line using -Dproperty=value
properties.xml (or build.xml) - wherever it's used''
  • When working on a team, how to run test of a specific POJO using db-load task only in that specific table as well?
First, instead of using all the sample-data.xml file, create another file say sample-person.xml and there put the data that you want insert. After that you can do this:
ant test-dao -Dtestcase=PersonDao -Dfile=metadata/sql/sample-person.xml

Development with AppFuse [#2]

  • HowTo setup your Development Environment. This is what I typically use when building a new machine. It includes environment variables, downloads, where to install applications, etc.
  • What are the major ant tasks? What do they do?
See AppFuseAntTasks.

Security Questions [#3]

  • HowTo use NTLM authentication with appfuse? Using the jCIFS, one can use the jcifs.http.NtlmHttpFilter to use the NTLM authentication in Tomcat. Matt can you give some pointers if this can be integrated with AppFuse?
Here is how I used Andy Armstrong's JAAS Login Modules to get Tomcat to talk to an NT Domain. It's been over a year since I tried it - but it worked quite well at the time. I have no experience with jCIFS - but if you get it working - please let me know. I'd be happy to help you write a howto on this wiki for it. ~ Matt

Struts Specific [#4]

  • Why is the JSTL keyword 'empty' not working all the time?
The empty keyword (pre JSP 2.0), only worked on java.util.List, java.util.Map, on Strings and arrays. Collections like java.util.Set were not supported. If you are using pre JSP 2.0 and want to test whether a Set is empty or not use: <c:if test="${mycollection['empty']}">.
The most reliable workaround to this problem I have found, is to use this notation:
  <c:forEach items="${mycollection}" var="element" varStatus="rowNum">

    <c:if test="${rowNum.count==1}">
        <tr> <th> Value Header </th> </tr>

          <c:out value="${element.value}"/>
      <c:if test="${rowNum.last}">
This article explains this in more detail. If you are using tomcat 5, this supports JSP 2.0 so you will not experience this problem.

JSF Specific [#5]

  • I get an "Couldn't find template: /home/mats/myapp/metadata/templates/struts_form.xdt" when I run "ant setup test-all" after specifying "jsf" as web framework when running "ant new".
This is caused by the failure of JSF to install. Start with a version that has JSF pre-installed.

Database Specific [#6]

  • I get an "access denied" error when trying to create the MySQL Database.
The issue is likely because you're on Unix or you've changed the root password. See this page for assistance.
  • I get an "Illegal mix of collations" when I try to run tests against a MySQL database.
MySQL 4.1.7+ requires you to add set the default character set to UTF-8 to get unicode support with AppFuse. To do this, add the following to your c:\Windows\my.ini or /etc/my.cnf file:
  • I'm have methods that throw exceptions in a Transaction and nothing is being rolled back. What gives?
MySQL's default tables (MyISAM) do not support transactions by default. Add or replace the following line in your c:\Windows\my.ini or /etc/my.cnf file. You could also use PostgreSQL.
NOTE: You may see default-storage-engine's synonym "default-table-type" in the configuration file. If so, set the value of that parameter to "innodb" instead.
BTW, MySQL Administrator is a nice tool for administering/monitoring MySQL.
  • I'm having trouble with MySQL on Suse 9.2.
Upgrading to the MySQL 3.1.5 JDBC Driver (or above) should fix this.
  • I get an "Could not synchronize database state with session" exception when I try to run test-dao.
If a class with a natural key does not declare a version or timestamp property, it's more dificult to get saveOrUpdate() and cascades to work correctly. You might use a custom Hibernate Interceptor as discussed in this chapter. (On the other hand, if you're happy to use explicit save() and explicit update() instead of saveOrUpdate() and cascades, Hibernate doesn't need to be able to distinguish between transient and detached instances; so you can safely ignore this advice.) Composite natural keys extend the same ideas. {Hibernate in Action: pag.:333}
  • How do I use a JNDI DataSource instead of a Spring-managed one (1.9+):
In metadata/conf/tomcat-context*.xml, uncomment the JNDI DataSource settings. Then in web/WEB-INF/applicationContext-resources.xml, uncomment the JNDI "dataSource" bean - and delete the active "dataSource" bean. If you decide to make this a permanent change in your project, you can delete commons-dbcp.jar and commons-pool.jar from lib/jakarta-commons.

Application Server Specific [#7]

See AppFuseOnOrion - Orion is the embedded server in Oracle AS.

Continuous Integration [#8]

Hibernate Specific Questions [#9]

See Karl Baum's writeup on Lazy Initialization. In particular, the Being Lazy in your Unit Tests section.
  • Do I have to use XDoclet to generate my *.hbm.xml files? Is it possible to override a single hbm.xml file and create it by hand?

If you have an @hibernate.class tag on a POJO - hibernatedoclet will generate the mapping file into build/dao/gen. If you have a mapping file (*.hbm.xml) file for your POJO in the src/dao/**/model/* directory, it will overwrite the generated version. If you don't want to worry about the two conflicting - just remove the @ sign from @hibernate.class in your POJO and put your hbm.xml file in the model directory.

No build.xml modification are need for this to work. The "package-dao" target will include these mapping files:

       <copy todir="${build.dir}/dao/gen">
           <fileset dir="src/dao" includes="**/*.xml" excludes="**/*-${dao.type}.xml"/>
           <filterset refid="variables.to.replace"/>

If you want to get rid of the hibernatedoclet process, you can do that- but make sure and run it first - and then copy all of the generated hbm.xml files into your model directory.

Archived Questions (no longer relevant) [#10]

Go to top   Edit this page   More info...   Attach file...
This page last changed on 06-Nov-2006 13:52:58 MST by MatsHenricson.