------------ Introduction ------------ This is the source code for Frank, a simple Java Servlet that will query the OC Transpo (www.octranspo.com) GPS data API. Frank uses parts of QuanDocs, which is released under the GPL (GNU Public Licence version 3 or, at your option, any later version) and, thus, Frank is also available under GPLv3-or-later. Please see the file COPYING for the full terms of this licence. ------------ Dependencies ------------ Frank's production code depends on the following external libraries: - Jenkins-WinStone (LGPL, Debian package libjenkins-winstone-java) You could substitute a different servlet engine if you modif go.sh - Apache HttpComponents 4.3 (Apache Licence, packaged with Frank because as of this writing Debian stable doesn't yet provide it) The Unit Tests (invoked via cov.sh) rely on a couple of additional libraries: - JUnit 4 (Eclipse Public Licence, Debian package junit4) the same reason as HttpComponents 4.3) - Oracle jcov (GPLv2 + classpath exception, also packaged with Frank because Debian doesn't yet include it) If you are not building on Debian Linux, then you'll need to download WinStone and JUnit4 separately, and edit setcp.sh to point to the correct paths. --------------------- Compiling and Running --------------------- To build the source code, run its unit tests, and generate a code coverage report: $ . ./setcp.sh $ ./cov.sh $ www-browser ./report/index.html To build the source code and run it in the WinStone Servlet Engine: $ . ./setcp.sh $ ./go.sh Note that the OC Transpo server will refuse to answer unless you have a valid AppID + APIKey combination, but my APIKey is not included in this source distribution. You'll need to get your own from octranspo.com.