The Project Skeleton

A walk through the default directory structure

Basic Setup

If you followed the quickstart instructions, your web.xml will contain two Spring DispatcherServlets. One is mapped to /riot/* and serves the Riot user interface.

Note:

If you point your browser to http://localhost:8080/[project-name]/riot you will see the Riot login screen. A default user is automatically created and you can log in using admin as both username and password.

The second servlet is mapped to *.html and handles the actual application requests. The servlet is called website-servlet and the configuration can be found at webapp/WEB-INF/riot-config/website-servlet.xml.

Both servlets share a common ApplicationContext which is configured in webapp/WEB-INF/application-context.xml.

The website-servlet configuration is split up into two files: website-servlet.xml and website-controllers.xml. The latter one contains only controllers and will change from project to project. Whereas website-servlet.xml contains Spring infrastructure beans like the HandlerMapping, the ViewResolver and a MessageSource which are less project specific.

Note:

This skeleton is only a suggestion. We have used this project layout in various projects and works very well for us. If you want, you can of course change everything to match your personal needs.