erikbjo / tds

Train Dispatch System to manage train departures. Exam project for IDATG1003.

Train Dispatch System 🚂

Project description 📝

Train Dispatch System is a Java application made to manage train departures. The application is made with Spring Boot and Maven, and uses Derby as a database. The user-interface is made with Spring Shell. Exam project for the course IDATG1003 at NTNU Gjøvik.

The project is finished and archived.

How to run the project 🚀

1. Clone the repository with:

git clone [email protected]:erikbjo/tds.git

2. Run the program with:

./mvnw clean spring-boot:run

or

1. Download the jar file from git releases
2. Run the program with:

java -jar tds-3.jar

How to run the tests 🧪

1. Clone the repository
2. Run the tests with:

./mvnw clean test

How to use the program 🖥

When the program is running, you can use the following command to get help:

help

Contact 📧

If you have any questions, you can contact me here

Project structure 📁

root
├── src
│   ├── main
│   │   ├── java
│   │   │   └── no
│   │   │       └── ntnu
│   │   │           └── erbj
│   │   │               └── tds
│   │   │                   ├── dao
│   │   │                   │   ├──Dao.java
│   │   │                   │   ├──DepartureDao.java
│   │   │                   │   ├──StationDao.java
│   │   │                   │   ├──TrainDao.java
│   │   │                   │   └──WagonDao.java
│   │   │                   │
│   │   │                   ├── model
│   │   │                   │   ├── departures
│   │   │                   │   │   ├── Departure.java
│   │   │                   │   │   └── DepartureBuilder.java
│   │   │                   │   │
│   │   │                   │   ├── Station.java
│   │   │                   │   ├── Train.java
│   │   │                   │   ├── Wagon.java
│   │   │                   │   └── WagonType.java
│   │   │                   │
│   │   │                   ├── shared
│   │   │                   │   └── utilites
│   │   │                   │       ├── StringValidator.java
│   │   │                   │       └── TimeParser.java
│   │   │                   │
│   │   │                   ├── ui
│   │   │                   │   ├── commands
│   │   │                   │   │   ├── CreateCommands.java
│   │   │                   │   │   ├── DepartureCommands.java
│   │   │                   │   │   ├── HelperCommands.java
│   │   │                   │   │   ├── TimeCommands.java
│   │   │                   │   │   ├── TrainCommands.java
│   │   │                   │   │   └── WagonCommands.java
│   │   │                   │   │
│   │   │                   │   ├── controllers
│   │   │                   │   │   └── TimeController.java
│   │   │                   │   │
│   │   │                   │   └── utilites
│   │   │                   │       ├── AnsiColors.java
│   │   │                   │       ├── Colorize.java
│   │   │                   │       ├── Printer.java
│   │   │                   │       ├── SortUtility.java
│   │   │                   │       ├── TablePrinter.java
│   │   │                   │       └── TdsLogger.java
│   │   │                   │
│   │   │                   └── TdsApplication.java (main class)
│   │   └── resources
│   │       ├── logback.xml
│   │       └── application.properties
│   │
│   └── test
│       └── java
│           └── no
│               └── ntnu
│                   └── erbj   
│                       └── tds
│                           └── model
│                               ├── DepartureBuilderTest.java
│                               ├── DepartureTest.java
│                               ├── StationTest.java
│                               ├── TrainTest.java
│                               └── WagonTest.java
├── .gitignore
├── LICENSE
├── mvnw
├── mvnw.cmd
├── pom.xml
└── README.md

Troubleshooting 🛠

If you get any persistence errors, try to delete the tdsDB directory and run the program again.

tds's Issues

Create tests for new station/register methods, from task description

Søke etter en togavgang basert på Tognummer

Det må være mulig for brukeren av applikasjonen din å oppgi dette unike tognummeret, så ikke la applikasjonen din automatisk generere det unike tognummeret

Unikt tognummer?

Spor (engelsk: "track") - Et heltall som angir hvilket spor toget er satt opp på. Dersom toget ikke har fått tildelt spor ennå, settes spor til -1.

add delay to departure table

Register: En metode som fjerner togavgang(er) som har avreisetidspunkt tidligere enn et gitt klokkeslett. Husk å også ta med forsinkelse i vurderingen om avgangen skal fjernes.

dobbelsjekke del 2

En metode for å legge til en togavgang i registeret. Dersom det allerede finnes en togavgang med samme tog-nummer som den avgangen som forsøkes lagt til, skal togavgangen ikke legges til registeret og metoden bør gi en eller annen form for tilbakemelding (NB! IKKE til brukeren) til koden som kaller metoden

Register: En metode som returnerer alle togavganger som en sortert liste av togavganger sortert stigende på avreisetidspunkt. Her skal du ikke ta hensyn til eventuell forsinkelse. Merk at vi ikke ber om at registeret i seg selv nødvendigvis må være sortert til enhver tid, men at denne metoden skal returnere en sortert samling (eller en iterator til en sortert samling) basert på togavgangene i registeret ditt.

Lage Informasjonstavlen

Du velger selv hvordan du vil presentere din informasjonstavle (tilsvarende den i Figur 1), men
tavlen skal vise følgende informasjon (i følgende rekkefølge):
• Avgangstid på formatet "hh:mm"
• Linje
• Tognummer
• Destinasjon
• Eventuell forsinkelse. Hvis ingen forsinkelse skal det ikke vises noe (heller ikke "00:00")
• Spor. Hvis ingen spor tildelt, skal ingen ting vises.

Søke etter togavgang basert på destinasjon

Legg inn forsinkelse på en togavgang – ved å først søke etter en gitt togavgang basert på tognummer, og deretter legge til forsinkelse.

Tildele spor til en togavgang – ved først å søke opp togavgang basert på tognummer, og så sette spor

Søke etter togavgang basert på destinasjon

Register: En metode for å søke opp en togavgang basert på det unike tog-nummeret.

dobbelsjekke sensurveil

Create wagon commands

Tildele spor til en togavgang – ved først å søke opp togavgang basert på tognummer, og så sette spor.

Make trainnumber unique

Register: En metode for å søke opp togavgang(er) med en gitt destinasjon.

eksportere klassediagram etter fp

dobbelsjekke del 1

Forsinkelse (engelsk: "delay") - Angir hvor mye toget er forsinket i timer og minutter. Hvis ingen forsinkelse, settes 00:00.

Create tests for train class

fix departure table, see desc

Time=00:01, should be 20:12 or 20:13
INFO : +----------+------------+------------+----------------+------------------------------------------+
INFO : | Time | Line | Track | Train number | Destination |
INFO : +----------+------------+------------+----------------+------------------------------------------+
INFO : | 00:01 | L312 | 3 | 123 | Gjøvik |
INFO : +----------+------------+------------+----------------+------------------------------------------+

dobbelsjekke del 3

Spor. Hvis ingen spor tildelt, skal ingen ting vises. (-1)

Create tests for current classes, positive and negative

exit at wrong time, see desc

shell:>new departure
INFO : +-----------------+------------+------------------------------------------+
INFO : | Train number | Seats | Wagons |
INFO : +-----------------+------------+------------------------------------------+
INFO : | 932 | 0 | 0 |
INFO : | 3212 | 0 | 0 |
INFO : +-----------------+------------+------------------------------------------+
INFO : Enter train number:
032
INFO : Exiting object creation.

Should say "No train with that number blabla try again, exit to exit"

Eventuell forsinkelse. Hvis ingen forsinkelse skal det ikke vises noe (heller ikke "00:00")

Tognummer (engelsk: "train number") - en tekst med et unikt nummer innenfor samme dag på formen 602, 45, 1951 etc. Nummeret er unikt innenfor et 24-timers vindu

En togavgang skal automatisk fjernes fra oversikten dersom avreisetidspunktet (pluss eventuell forsinkelse) er tidligere enn klokken (tidspunktet på dagen). Eksempel: har et tog avreisetidspunkt kl 12:35 og er 5 minutter forsinket, skal togavgangen vises i oversikten så lenge klokken (tidspunktet på dagen) er tidligere enn 12:40. I det øyeblikket klokken passerer 12:40, skal togavgangen fjernes fra oversikten.

Det må være mulig for brukeren av applikasjonen din å oppgi dette unike tognummeret, så ikke la applikasjonen din automatisk generere det unike tognummeret

Søke etter en togavgang basert på Tognummer

did not catch invalid train, see desc

shell:>new departure
INFO : +-----------------+------------+------------------------------------------+
INFO : | Train number | Seats | Wagons |
INFO : +-----------------+------------+------------------------------------------+
INFO : | 3212 | 0 | 0 |
INFO : +-----------------+------------+------------------------------------------+
INFO : Enter train number: (exit to cancel)
0321321
INFO : Train is occupied or invalid. Please try again.
INFO : Enter train number: (exit to cancel)
123
INFO : Train is occupied or invalid. Please try again.
INFO : Enter departure time (HH:mm):

Register over togavganger

Vise/skrive ut oversikt over togavgangene, sortert etter avreisetidspunkt (informasjonstavle).

Oppdatere klokken (tidspunktet på dagen) – ved å spørre bruker etter nytt klokkeslett.

Create DAO classes for entity persistance

Create function to print all info in one station to a file

Legge inn en ny togavgang – det skal ikke være mulig å legge inn et tog med tognummer tilsvarende eksisterende tog i listen.