##McGill Fall 2015 - ECSE321 Team 7 Group Project
SocScore is a multi-platform soccer scoring system, written in Java.
About
This software system is subdivided into four sections:
- Framework
- Web App
- Android App
- JavaSwing App
####Framework
The framework is written purely in Java 7, and encapsulates all the control and model aspects of the respective applications. The JAR is located here, and is used in all other applications. The source code can be found here.
How to run the system
Web App
The web application is written in PHP, and uses a special server system called Quercus, which allows for the use of java classes and methods directly in PHP code. Though Quercus can be installed on any Java server (i.e. Tomcat), we recommend using Resin, as it implements Quercus natively.
Installation Guide
NOTE: Please ensure that no other servers are running on port 8080 before proceeding.
- Download Resin, and extract the tar.gz file.
- Using your terminal, navigate to the folder extracted from the download.
- Run
sudo ./configure
, followed bysudo make
andsudo make install
(if those last two commands don't work, then they aren't necessary). - Copy the following files in the following locations
- Copy all files in this repo's
lib/XStream folder
toYOUR_RESIN_FOLDER/webapp-jars
- Copy the file
build/lib/socscore-framework.jar
toYOUR_RESIN_FOLDER/webapp-jars
- Create a new folder in
YOUR_RESIN_FOLDER/webapps
calledSocScore
, and copy all contents fromsrc/com/SocScore/web
to that folder you just created.
- Copy all files in this repo's
- Then from the main Resin folder in terminal, run
bin/resin.sh start
to initialize the server. - To initialize the data for the app (required), navigate to htpp://localhost:8080/SocScore/test.php. If this loads a blank page, then the initialization has been successful.
- You will then be able to access the web-application by navigating to htpp://localhost:8080/SocScore/
- When you are done, you can shut down the server using the command
bin/resin.sh stop
Android App
This android application implements the SocScore framework into a standalone android application. Note that this app was optimized for mobile deployment, so you may experience layout issues if run on a tablet.
You can find the source code for this app here.
Installation Guide
The app apk is located here. Download it and run it directly on an android device or you can run it on an emulator available online such as bluestacks
Java Swing App
The Java Swing App uses the same framework as the Web App and Android App (see above for link to framework). The source code can be found in the following link src/com/SocScore/javaswing, the executable of the Java Swing App (SocScore-JavaSwing.jar) can be found here.