Skjelettprosjekt for TDT4100 prosjekt V2025

Dette repoet er et skjelettprosjekt for TDT4100 prosjektet våren 2025.

Vi har opprettet et eksempelprosjekt her, som er ment for at dere skal kunne komme raskt i gang med deres eget prosjekt.

TL;DR

Lag en ny mappe i src/main/java/ som er deres prosjekt. Opprett en startfil for appen, slik som ExampleProjectApp.java og en kontroller som ExampleProjectController.java i denne nye mappen. Lag så en mappe i src/main/resources/ med samme navn som prosjektet deres og et view som App.fxml i denne nye mappen.

Eventuelt: Endre navn på filer og mapper fra "ExampleProject" til deres prosjektnavn.

Litt rask info

Allerede nå er det mulig å kjøre filen ExampleProjectApp.java i VS Code for å få opp en liten kalkulator-app.

Denne filen er "startfilen" til applikasjonen. Her settes tittel på appen, hvilken FXML-fil som skal brukes, og den er ansvarlig for å starte selve applikasjonen:

primaryStage.setTitle("Example App"); // Setter tittel på vinduet
primaryStage.setScene(new Scene(FXMLLoader.load(getClass().getResource("App.fxml")))); // Sier at appen skal bruke "App.fxml"
primaryStage.show(); // Viser vinduet

Kontrolleren til applikasjonen er ExampleProjectController.java. Denne filen er "bindeleddet" mellom FXML-filen(e) og klassen(e) som skal brukes i applikasjonen. I dette eksempelprosjektet har den to metoder: initCalculator og handleButtonClick. I tillegg har den noen felter som er annotert med @FXML. Dette viser at de tilhører FXML-filen vår. Her er navnet på variablene viktige. F.eks er private Label result på linje 12 bundet til Label-feltet på linje 15 i FXML-filen, siden denne har en fx:id="result" og variabelen vår heter result:

@FXML
private Label result; // Fra ExampleProjectApp.java

<Label fx:id="result" layoutX="257.0" layoutY="244.0" /> // Fra App.fxml

Noe liknende skjer med metoden handleButtonClick, som også er annotert med @FXML. Dette gjøres slik at vi "får tak i" denne metoden fra FXML-filen. Button-feltet i FXML-filen har en onAction="#handleButtonClick", som vil si at metoden handleButtonClick, som er annotert med @FXML, blir kjørt når vi trykker på knappen:

<Button layoutX="271.0" layoutY="188.0" mnemonicParsing="false" onAction="#handleButtonClick" text="Kalkuler" /> <!-- Fra App.fxml -->

Det som gjør at kontrolleren og FXML-filen er koblet sammen er attributten fx:controller='exampleproject.ExampleProjectController' på det aller ytterste elementet i FXML-filen.

<AnchorPane fx:id="background" maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity" prefHeight="400.0" prefWidth="600.0" xmlns="http://javafx.com/javafx/8.0.171" xmlns:fx="http://javafx.com/fxml/1" fx:controller="exampleproject.ExampleProjectController"> <!-- Fra App.fxml -->

Så, når vi trykker på knappen i appen blir som sagt metoden handleButtonClick kjørt. Det som skjer inne i denne metoden er først at vi oppretter en ny kalkulator. Ved opprettelse av en kalkulator trenger vi en operator. Denne henter vi ut fra hva en bruker av appen har skrevet inn i TextField-feltet med fx:id="operator". Siden vi allerede har opprettet en variabel private TextField operator, som er annotert med @FXML, er denne allerede linket til dette TextField-feltet, og vi kan hente ut teksten som er skrevet inn med operator.getText().

initCalculator(operator.getText()); // Kaller på initCalculator som oppretter en ny kalkulator. Operator.getText() henter ut teksten som er skrevet inn i `operator`-feltet.

Det samme gjelder nedover i metoden; vi henter ut verdier fra firstNumber og secondNumber. Det som er verdt å merke seg her er at de blir hentet ut som Strings, men kalkulatoren vår krever ints. Derfor gjør vi de også om til integers. Her bør man og være litt forsiktige, da det ikke er gitt at brukere skriver inn gyldige tall. Derfor har vi wrappet dette inn i en try/catch, som sier ifra dersom tallet er ugyldig.

I tillegg til alt dette er det laget en liten eksempel-testfil. Ingenting spennende som skjer her - det er en test for konstruktøren til kalkulator-klassen vår, samt en test for metoden calculate som den har. Alle tester dere skriver til klassene deres legges altså inn i mappen src/test/java/<deres_prosjekt>/.

For å komme i gang med deres eget prosjekt

Lag et eget repo (repository) via templaten på GitHub. En mer detaljert oppskrift på dette finner dere på Blackboard under Prosjekt->FAQ.
Inviter gruppemedlemmene dine til dette repoet, og gi de minst en Developer-rolle (helst Maintain, men Admin funker også). Dette kan gjøres under Settings->Collaborators and teams->Add people.
Klon prosjektet et sted på maskinen deres.
Lag en ny mappe i src/main/java/ som er deres prosjekt.
Opprett en startfil for appen deres, slik som ExampleProjectApp.java og en kontroller som ExampleProjectController.java i deres nye prosjektmappe.
Opprett en ny mappe i src/main/resources/ som er deres prosjekt.
Opprett en FXML-fil, slik som App.fxml i deres nye prosjektmappe i src/main/resources/.
HUSK å legge inn fx:controller='<deres_prosjekt>.<deres_kontroller>' på det aller ytterste elementet i den nye FXML-filen deres, ellers vil ikke appen starte.

Eventuelt: Endre navn på filer og mapper fra "ExampleProject" til deres prosjektnavn.

Reminder av nøkkelpunkter

Nøkkelpunkt	Beskrivelse
Innleveringsfrist	11. april
Demonstrasjonsfrist hos læringsassistent	25. april
Gruppestørrelse	1 eller 2 personer

Anbefalte perioder å jobbe med prosjektet

Uke	Fra	Til	Beskrivelse
13	24/3	31/3	Grunnklasser og brukergrensesnitt
14	31/3	6/4	Lagring og filhåndtering
15	7/4	11/4	Fullføre appen med tilhørende dokumentasjon

LYKKE TIL

gurohr/Battleship

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages