Export to GitHub

duedates-polu - DeveloperGuide.wiki


Introduction

DueDates 2.0 is a web application that allows us to access library database and access information of our own account.

Requirements

We need to download and install following tools.

| Tool | Version | Website | VAR | Description | |:---------|:------------|:------------|:--------|:----------------| | JDK | 6 | http://java.sun.com/javase/downloads/index.jsp | JAVA_HOME | Java! | | Ant | 1.7.1 | http://ant.apache.org/ | ANT_HOME| Build tool | | HttpUnit | 1.7 | http://httpunit.sourceforge.net/ | HTTPUNIT_HOME | For screen scraping | | Checkstyle | 5.0-beta01 | http://checkstyle.sourceforge.net/ | CHECKSTYLE_HOME | Checks the format of the code | | JUnit | 4.5 | http://www.junit.org/ | JUNIT_HOME | For test case | | PMD | 4.2.3 | http://pmd.sourceforge.net/ | PMD_HOME | For testing | | FindBugs | 1.3.5 | http://findbugs.sourceforge.net/ | FINDBUGS_HOME | For testing | | SCLC | 2.7.428 | http://code.google.com/p/sclc/ | SCLC_HOME | For testing | | Emma | 2.0.5212 | http://emma.sourceforge.net/ | EMMA_HOME | For coverage | | JAXB | 2.1.9 | https://jaxb.dev.java.net/ | JAXB_HOME | For xml binding | | JavaMail | 1.4.1 | http://java.sun.com/products/javamail/ | JAVAMAIL_HOME | For E-mail functionality | | JAF | 1.1 | http://java.sun.com/javase/technologies/desktop/javabeans/jaf/ | JAF_HOME | activation.jar is necessary for JavaMail support in FindBugs | | Jetty | 6.1.9 | http://www.mortbay.org/jetty/ | JETTY_HOME | Web server | | Wicket | 1.3.5 | http://wicket.apache.org/ | WICKET_HOME | Web application framework | | SLF4J | 1.5.0 | http://www.slf4j.org/ | SLF4J_HOME | For Jetty and Wicket |

You can set environment variables from following.

http://yasu-international.com/08/413/env01.jpg http://yasu-international.com/08/413/env02.jpg

Download source code

If you are Windows user, you can use Tortoise SVN to download the source code. After you install it, create and right click the folder, then put following as "URL of repository". http://duedates-polu.googlecode.com/svn/trunk/ http://yasu-international.com/08/413/svn2.jpg

Setup for Eclipse

  1. First, you need to File > Import to import the project.

http://yasu-international.com/08/413/import.jpg

  1. Then you go to Window > Preferences to set classpath variables.

http://yasu-international.com/08/413/classpath.jpg

  1. Run JAXB

Right click on jaxb.build.xml and run it, so that it will generate necessary files.

http://yasu-international.com/08/413/jaxb.jpg

Useful Commands

  1. Verify Code This command checks if the source code passes its criteria. After we checkout and before we commit, we should always do verify to double check. ant -f verify.build.xml

  2. Building an executable jar file for users. ant -f jar.build.xml

  3. Building a distribution version for developers. ant -f dist.build.xml

http://yasu-international.com/08/413/run2.jpg

Run the application

You will need to run Jetty.java to run this web application. After you execute it, you will go to following URL.

http://localhost:7070/duedates-polu-wicket/