A relatively small project fell in my lap recently. My adviser needed new judging software for her game conference, Indiecade, which had to do the following:
- 1.Developers needed to be able to register and upload games.
- 2.Jurors had to be to be invited and judge games.
- 3.Administrators had to be able to administrate.
- 4.There had to be a way to manage contact between jurors and developers for the purpose of technical support.
This, of course, includes all of the common hall marks of modern web apps (database storage, email notifications, security, etc). I am providing this and the next few posts as documentation of my experience with the hope it can serve as a reasonable reference for similar projects. The web app, Judy (after Judge Judy), will use Spring 3.0 (Core, MVC, and Security modules) and be built with Netbeans and Maven.
For these posts I will make the assumption that you have a passing familiarity with the technologies behind Spring, Maven, and Netbeans. As such, this series will be more functions by rote and iteration than long prose explaining behind the scenes details. Should you want such things, I suggest the official Spring project documentation and any books from Manning on the topic you wish to study.
First let’s create the project in Netbeans as a Maven Web Application. I named it “IndiecadeJudy” and left the other options as default.
Spring, Spring MVC, and Spring Security require the following maven dependencies which I added to my pom.xml
Next, I added the applicationContext.xml file to configure Spring. I created the following directory tree: src/main/resources/META-INF. Inside META-INF I saved my applicationContext.xml file. I used the Netbeans template from the “New File” dialog and did not create any beans. Finally, I created the web.xml file (Standard Deployment Descriptor (web.xml) in the “New File” dialog) in the WEB-INF directory.
Next, we add the Spring information to the web.xml file.
<!– Spring Config file setup –>
At this point I ran my project and made sure there were no errors. Now I had the basic structure developed and could begin implementation of some features. I chose to begin with logins and permissions as I had not had any experience with Spring Security since Acegi 1.0.
Judy needed three basic roles: ADMIN, DEVELOPER, and JUROR. I created the folders â€œadminâ€, â€œdeveloperâ€, and â€œjurorâ€ in â€œWeb Pagesâ€ for each role respectively. Then I copied the default index.jsp from the web root into each of these folders. Finally, I created a file “login.jsp” in the web root.
The source for login.jsp:
<%@page contentType="text/html" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<form action="j_spring_security_check/>" method="POST" >
<label for="j_username">User:</label><input type=’text’ name=’j_username’ />
<label for="j_password">Password:</label><input type=’password’ name=’j_password’/>
<button name="submit" type="submit">Submit</button>
I added the following lines to my web.xml file after the Spring Context Listener tag. This will put the Spring Security listeners into the web project and give us security.
<!– Spring Security setup –>
Finally, I had to wire the Security beans. This provided basic users, roles, and permissions to each of the namespaces in web root.
<?xml version="1.0" encoding="UTF-8"?>
<security:global-method-security secured-annotations="enabled" >
<security:intercept-url pattern="/developer/**" access="ROLE_DEVELOPER" />
<security:intercept-url pattern="/juror/**" access="ROLE_JUROR" />
<security:intercept-url pattern="/admin/**" access="ROLE_ADMIN" />
<security:intercept-url pattern="/public/**" access="IS_AUTHENTICATED_ANONYMOUSLY" />
<security:intercept-url pattern="/login.jsp" access="IS_AUTHENTICATED_ANONYMOUSLY" />
<security:intercept-url pattern="/index.jsp" access="IS_AUTHENTICATED_ANONYMOUSLY" />
<security:user name="developer" password="5f4dcc3b5aa765d61d8327deb882cf99" authorities="ROLE_DEVELOPER" />
<security:user name="juror" password="5f4dcc3b5aa765d61d8327deb882cf99" authorities="ROLE_JUROR" />
<security:user name="administrator" password="5f4dcc3b5aa765d61d8327deb882cf99" authorities="ROLE_ADMIN" />
With everything configured, I ran the application and saw the â€œHello World!â€ index.jsp. To test. I navigated to admin/index.jsp and was correctly redirected to the login.jsp page. I logged in as administrator with the credentials administrator and the password password. I could access the admin/index.jsp page correctly and received a 403 error if I tried the juror/index.jsp or the developer.jsp page.
What I was not expecting when I began this project was how my first few iterations of basic functions would not involved any Java coding. Spring Security has definantly come a long way since Acegi and the whole stack is much more conducive to prototype style development. Coming up next, I will show how I setup seed data and database backed users with permissions using Hibernate hbm2ddl and DBUnit.