Sample RSF apps#
These sample applications are meant to help get a developer who is new to RSF get up to speed quickly. You are welcome to take these apps and use them as starting points for your own more complex applications.
Sample apps which include detailed explanations in the wiki#
- Hello World - absolute basics
- LogonTest - basic form submission and EL
- ComponentTest - file uploads, reskinning
- SpringMVCStep - integrating with Spring Web MVC
- Hibernate Cookbook - OTP and RSF ORM
- NumberGuessing - simple flows and xml component trees
- PhonebookSWFSample - Spring Web Flow Phonebook sample app in RSF
- SellItemSWFSample - Spring Web Flow SellItem sample app in RSF
Sample apps without extra explanations#
- AJAX Autocomplete Simple - using AJAX and UVB
- Tasklist OTP - using OTP and RSF ORM
- AJAX AHAH Dynamic forms and links - using AJAX and UVB with AHAH to dynamically change form submissions and links
All RSF Sample apps can be found in the public SVN#
Working with the RSF sample applications#
Each RSF sample app uses a standard Maven build process, which should build and deploy it to a local Tomcat. This varies depending on whether you are using maven1 or maven2. Most projects should have a readme.txt file which explains how to build them. For the ones that do not, you can use the following instructions.
From within the main directory of the project (should have the pom.xml file) run mvn install cargo:deploy. This should build the project and deploy it to your tomcat webapps folder.
Make sure you have a settings.xml file in $YOUR_USER_HOME/.m2 directory, here is a sample one
Set the <appserver.home>c:\opt\tomcat</appserver.home> to point to your $TOMCAT_HOME directory.
Build this project and deploy it in tomcat by running the following from this directory (the one with the readme):
mvn install rsf:deploy
More information on the Maven 2 Setup page.
Adjust the configuration in the Maven 1 project.properties file, which by default looks like this:
The only critical change is to edit maven.tomcat.home to be the path to your tomcat home.
Build this project and deploy it in tomcat by running the following from the main directory of the project (should have the project.xml and project.properties files) (the one with the readme):
Maven troubleshooting#If you are getting download errors from trying to build the sample applications, make sure you have not overridden the remote repository setting maven.repo.remote inside your personal build.properties file (by default in $HOME/build.properties). You will need to reference the CARET Maven repository as in the sample project.properties file shown above.
Verbose logging#You may wish to edit the log4j.properties file held in src/webapp/WEB-INF/classes of the various sample apps, and set the following line log4j.logger.PonderUtilCore=info to the warn level. However, RSF is not yet at full release status and the verbose logs can sometimes be helpful.
Try the RSF Community links to things like the forums in the left bar.