Group Project - STIW3054-A182/Assignments GitHub Wiki

Guideline for Group Project

Due Date: 20 May 2019

INSTRUCTION:

You are required to develop a real-time system using the Java programming language (Maven). The system should be able to:

Check URLs:

  1. Read URLs from a text file. For the testing purposes, download the URL.txt from the link below:
    https://github.com/STIW3054-A182/Assignments/blob/master/URL.txt
  2. The path and filename MUST be read from the properties file.
  3. If the links did not exist (invalid link), all the error links must be stored in log files.
  4. Then display all the valid links.
  5. Each link will be validated using a thread (eg: 14 links = 14 threads).
  6. Assign the threads based on the number of processors in your machine.
  7. If the validating process takes more than 1 minute, that process will be terminated. The terminated links will be stored in log files.

Count the number of players:

  1. Count the total players for each category.
  2. If the player in each category less than 1, then the link is considered invalid and store the link into log files.
  3. Count all the players based on the valid links.

Example of the output is shown below:

| Category | Total |
|----------|-------|
| U8L      | 65    |
| U10L     | 100   |
| U12L     | 70    |
| ...      | ...   |
| TOTAL    | xxxx  |

Display statistics

  1. Count the total players for each state by category.
  2. Count the total players for each state.
  3. Count all the players.

Example of the output is shown below:

| State       | Category | Total |
|-------------|----------|-------|
| KEDAH       | U10L     | 1     |
| KEDAH       | U12L     | 2     |
| KEDAH       | U14L     | 2     |
| ...         | ...      | ...   |
|             | TOTAL    | XXX   |
| PERAK       | U10L     | 8     |
| PERAK       | U12L     | 15    |
| PERAK       | U14L     | 10    |
| ...         | ...      | ...   |
|             | TOTAL    | XXX   |
| GRAND TOTAL |          | XXX   |

Display all players from KEDAH:

  1. The KEDAH keyword MUST be read from the properties file.
  2. Sort the result based on the winning points and category.

Example of the output is shown below:

| Rk | SNo | Name                        | Rtg  | State | Pts | Category |
|----|-----|-----------------------------|------|-------|-----|----------|
| 19 | 17  | Rosli Iman Hasif            | 1031 | KEDAH | 5.0 | U10L     |
| 7  | 27  | Mohd Zamzuri Muhd Afiq Adam | 0    | KEDAH | 5.0 | U18L     |
| 9  | 24  | Ismadi Adzreal Haikal       | 0    | KEDAH | 5.0 | U18L     |
| 22 | 24  | Teh Rui Zhe                 | 1377 | KEDAH | 4.5 | U16L     |
| .. | ..  | ...                         | ..   | ..    | ..  | ..       |

Display all TOP 3 players from each category.

  1. The value of 3 MUST be read from the properties file.

Example of the output is shown below:

Final Ranking after 8 Rounds (U8L)

| Rk | SNo | Name          | Rtg  | State        | Pts | Category |
|----|-----|---------------|------|--------------|-----|----------|
| 1  | 2   | Kavin Mohan   | 1334 | KUALA LUMPUR | 8.0 | U8L      |
| 2  | 8   | Balan Praneal | 0    | N.SEMBILAN   | 6.0 | U8L      |
| 3  | 13  | Khaw Eu Ming  | 0    | PULAU PINANG | 6.0 | U8L      |

Final Ranking after 8 Rounds (U10L)

| Rk | SNo | Name                     | Rtg  | State        | Pts | Category |
|----|-----|--------------------------|------|--------------|-----|----------|
| 1  | 2   | Lai Hong Jun             | 1472 | PULAU PINANG | 7.5 | U10L     |
| 2  | 7   | Muhd Ridzuan Ariel Redza | 1216 | PAHANG       | 6.5 | U10L     |
| 3  | 4   | Yee Hao Loong            | 1300 | SELANGOR     | 6.5 | U10L     |

.....

Count the winning points:

  1. Count the total points for each state by category.
  2. Count the total points for each state.
  3. Count all the points.

Example of the output is shown below:

| State       | Category | Total |
|-------------|----------|-------|
| KEDAH       | U10L     | 1     |
| KEDAH       | U12L     | 2     |
| KEDAH       | U14L     | 2     |
| ...         | ...      | ...   |
|             | TOTAL    | XXX   |
| PERAK       | U10L     | 8     |
| PERAK       | U12L     | 15    |
| PERAK       | U14L     | 10    |
| ...         | ...      | ...   |
|             | TOTAL    | XXX   |
| GRAND TOTAL |          | XXX   |

Display a player result:

  1. The player's name MUST be read from the properties file.

Example of the output is shown below:

| Rk | SNo | Name                        | Rtg  | State | Pts | Category |
|----|-----|-----------------------------|------|-------|-----|----------|
| 19 | 17  | Rosli Iman Hasif            | 1031 | KEDAH | 5.0 | U10L     |

NOTES:

  1. Each category will be executed using a thread (eg: 14 links = 14 threads).
  2. Assign the threads based on the number of processors in your machine.

Example of properties file:

path=/Users/zhamricheani/Desktop/
textFile=URL.txt
state=KEDAH
top=3
player=Rosli Iman Hasif

You may add more properties if required.

Reference:

https://www.mkyong.com/java/java-properties-file-examples/

SUBMISSION:

The project must be submitted to the group’s repository based on the guideline below:

  1. Every group’s repository must have at least 6 branches namely master and 'MatricNumber' for every group member.
  2. All source codes must be uploaded to the mentioned repositories and the final version MUST be available at the master branch.
  3. Upload the user manual to your group’s wiki.
  4. Upload the example of the output to the group’s wiki.
  5. Generate JavaDoc and then upload to your group’s wiki.
  6. Generate UML Class Diagram using ObjectAid UML Explorer (http://www.objectaid.com/) and then add the diagram to your group’s wiki.
  7. Generate XML file using Metrics 1.3.8 (http://metrics2.sourceforge.net/) and then upload the file to your group's repository (the same repo with the source codes at the root directory same as Readme.md) using the following format:

RepoName.xml (Example: Group1.xml)

  1. Record the implementation of the system and upload to YouTube. The video presentation MUST be in English (without the music) and not more than 10 minutes. Then add the link to your group’s wiki.
  2. Write all references at your group’s wiki.
  3. To confirm the submission, every group leader must paste the Group-Project REPOSITORY link at the issue below:
    https://github.com/STIW3054-A182/Assignments/issues/4

Readme.md STRUCTURE

  1. Group Info
  2. Introduction
  3. Table of Content

Wiki STRUCTURE

  1. User manual
  2. Result/Output
  3. JavaDoc
  4. UML Class Diagram
  5. YouTube Presentation
  6. References

CONTENT OF THE PRESENTATION:

  1. Structure of your project.
  2. A quick review of the files.
  3. Step by step how to install, configure and run the program.
  4. Example of the output.

EVALUATION:

The marks will be given based on the:

  1. The quality of the system.
  2. The correctness of the results.
  3. User manual
  4. JavaDoc
  5. UML Class Diagram.
  6. Video Presentation.
  7. List of the references.

PLAGIARISM CHECK:

No mark will be given for plagiarism activities.

LATE SUBMISSION:

Penalties will be given of each late submission.

Guide for References Using APA Style:

https://sites.umuc.edu/library/libhow/apa_examples.cfm