Raible's Wiki: AppFuseQuickStart

At line 3 removed 2 lines.

At line 10 changed 1 line.

# Run

# Run "ant new -Dapp.name=YOURAPPNAME -Ddb.name=YOURDBNAME". This will create a directory named YOURAPPNAME in the same directory as appfuse.

# Navigate to the new directory and run "ant setup-db setup-tomcat deploy" to setup your app on Tomcat. If you want to test and make sure everything works, run "ant test-all" - make sure Tomcat is stopped when you do this.

# Run "ant test-reports" - there will be a message after it runs telling you how you can view the generated reports.

''If you'd like to use [iBATIS|http://ibatis.com] as a persistence framework option, view the README.txt in {{contrib/ibatis}}.''

----

Usually, after you get all this to work - it's likely you'll want to change all your package names to "com.company" rather than "org.appfuse". I use Eclipse to rename packages. To do this, go to the package view, click on a package name and right click -> Refactor -> Rename. Type in "*.xml,*.properties,*.xdt" for File name patterns to search in.

;:''__NOTE:__ If you want to use iBATIS, I recommend you install it (instructions at contrib/ibatis/README.txt) before renaming all the packages. If you don't install it first, you can add the ibatis/src as a source directory and rename packages there. Make sure to edit/change all the package names in the .xml files (including build.xml). You will also need to manually change the package names in the *DAOiBatis files.''

By adding "*.xml,*.properties,*.xdt" to the ''File name patterns'' field in the Rename Package wizard, the following files should be changed as well. If you're not using Eclipse or something isn't working right - you might want to ensure the "org.appfuse" has been changed to "com.company" in the following files:

{{{

- metadata/web/global-exceptions.xml

- web/WEB-INF/tiles-config.xml

- web/WEB-INF/classes/log4j.properties

- web/WEB-INF/validator-rules-custom.xml

- src/service/com/company/service/applicationContext-service.xml

- src/dao/com/company/persistence/hibernate/applicationContext-hibernate.xml

- metadata/templates/struts_form.xdt

}}}

You'll need to manually change the location of the Hibernate mapping files in the {{{applicationContext-hibernate.xml}}} file (location listed above). Basically, "org/appfuse" needs to be changed to "com/company".

You'll also need to change a few targets in build.xml to refer to the new package names. These targets/changes are listed below:

{{{

- junitdoclet-module - change org.* to com.*

- javadoc - change org.* to com.

}}}

Raible's Wiki

AppFuse

Other Applications

AppFuseQuickStart