Development-Logs on Nana Yaw Kyei Antwi | Portfolio

Uge 1 – JPA Basics

Mon, 01 Jan 0001 00:00:00 +0000

Opsumering

Denne uge begyndte jeg på Cyber Incident Tracker og opbyggede fundamentet til projektets backend med Java, JPA/Hibernate og PostgreSQL.

Fokus var at kunne oprette hændelser som Java-objekter, gemme dem i databasen og hente dem igen.

Hvad jeg har implementeret?

Jeg oprettede projektets packages og en Incident-entity med ID, titel og beskrivelse. Med JPA-annotationer koblede jeg klassen til tabellen incidents i min database.

Derefter implementerede jeg CRUD i IncidentDAO med metoder til at:

Uge 2 – JPA Relations

Mon, 01 Jan 0001 00:00:00 +0000

Hvad har jeg implementeret?

Jeg har implementeret relationer mellem brugere, hændelser og kommentarer med JPA. En hændelse har en rapportør, og en kommentar tilhører både en bruger og en hændelse.

Implementering

User, Incident og Comment med ManyToOne-relationer.
DAO-klasser og interfaces til databaseoperationer.
JPQL til brugeropslag, rapportør filtrering og kommentarer til en hændelse.
IncidentService med validering og håndtering af hændelser.

Test og læring

Der er implementeret databasetests med JUnit og Testcontainers for CRUD, relationer, brugeropslag og filtrering.

Uge 3 – Dataintegration med et eksternt API

Mon, 01 Jan 0001 00:00:00 +0000

Ugeopsummering

Denne uge har jeg arbejdet med dataintegration ved at hente oplysninger om kendte sikkerhedssårbarheder fra NVD’s CVE-API.

Formålet er at lære at hente eksterne data i Java og omdanne dem til objekter, som projektet kan bruge. På længere sigt kan oplysningerne supplere en hændelse i CIT, hvis den vedrører en kendt sårbarhed.

Hvad jeg har implementeret

CveClient, som sender GET-requests med Java HttpClient.
JSON-mapping med Jackson og ObjectMapper.
CveDTO med CVE-ID og engelsk beskrivelse.
CveDemo, som udfører et opslag og viser resultatet i konsollen.

I CveClient henter fetchJson() API-svaret som tekst. Metoden fetchById() læser derefter JSON-strukturen og returnerer en CveDTO med de relevante oplysninger.

Uge 4 – Concurrency

Mon, 01 Jan 0001 00:00:00 +0000

Ugeopsummering

Denne uge har jeg arbejdet med concurrency ved at lave en statistikdemo til Cyber Incident Tracker.

Programmet henter hændelser fra databasen og sender to tælleopgaver til en ExecutorService med to worker-thread:

Tæl alle åbne hændelser.
Tæl åbne hændelser med MEDIUM severity.

Hvad jeg har implementeret

Hver opgave er en Callable<Integer>, som returnerer et antal. Begge opgaver indsendes med submit(), før resultaterne hentes med Future.get(). Det giver opgaverne mulighed for at køre samtidigt.

Uge 5 – REST API intro

Mon, 01 Jan 0001 00:00:00 +0000

Hvad jeg har implementeret

Denne uge har jeg lavet et REST API til CIT med Javalin. Før testede jeg funktionerne direkte i Java. Nu kan jeg sende HTTP-requests og oprette, hente, opdatere og slette hændelser.

Opbygning af API’et

Jeg brugte Hotel API fra undervisningen som hjælp til strukturen. Mine routes starter med /api/v1, og serveren kører på port 7070. Routes sender requesten videre til controlleren, som bruger service- og DAO-laget. Jeg har også lavet DTO’er til oprettelse, opdatering og svar. Der er kontrol af blandt andet tom titel, ugyldigt ID og manglende severity. Fejl sendes tilbage som JSON med en statuskode.

Uge 6 – REST & Test

Mon, 01 Jan 0001 00:00:00 +0000

Hvad jeg har implementeret

Denne uge har jeg lavet automatiserede tests af mit REST API med REST Assured og Hamcrest. Jeg brugte mine DAO-tests og Hotel API fra undervisningen som hjælp.

Testopsætning

Testcontainers starter en separat PostgreSQL-database. Før hver test rydder jeg tabellerne og opretter en testbruger og en hændelse. Serveren og testene bruger den samme testdatabase.

Hvad testene kontrollerer

Jeg har nu 7 API-tests:

GET af alle hændelser: Kontrollerer status 200 og JSON som indholdstype.
GET med kontrol af indhold: Kontrollerer, at listen indeholder testhændelsens titel.
GET via ID: Kontrollerer, at den rigtige hændelse returneres med det forventede ID, titel og status.
POST: Opretter en hændelse og kontrollerer status 201, et genereret ID og de forventede felter. Hændelsen hentes bagefter med GET for at kontrollere, at den er gemt.
POST med tom titel: Kontrollerer status 400 og fejlbeskeden Titel må ikke være tom.
PUT: Ændrer titel, beskrivelse, severity og status. Et efterfølgende GET kontrollerer, at ændringerne er gemt.
DELETE: Kontrollerer status 204 og en tom response body og derefter et GET på samme ID skal give 404.

Resultat

Alle syv tests i ApiTest bestod ved kørslen. Det var kun API-testklassen, ikke hele projektets tests.

Uge 7 – Security

Mon, 01 Jan 0001 00:00:00 +0000

Hvad jeg har implementeret

Denne uge har jeg tilføjet registrering og login til CIT. Passwords gemmes som en bcrypt-hash, og ved login får brugeren et JWT, der gælder i en time. Jeg brugerTokenSecurity-bibliotek, og nøglen hentes fra JWT_SECRET.

Brugere, passwords og roller

Min User har fået et passwordHash. Når en bruger oprettes med navn, e-mail og password, hasher constructoren passwordet med bcrypt. Ved login bruger verifyPassword() bcrypt til at kontrollere det indtastede password mod den gemte hash.

Uge 8 – Deployment

Mon, 01 Jan 0001 00:00:00 +0000

Hvad jeg har implementeret

Denne uge har jeg deployet CIT til DigitalOcean, så API’et kan bruges uden at køre på min egen computer.

API’et er tilgængeligt på:

https://api.antwi.dk/api/v1/incidents

Endpointet kræver et gyldigt JWT. Derfor får man 401, hvis man åbner linket direkte uden et token.

Build og GitHub Actions

Jeg har tilføjet Maven Shade Plugin, som samler projektet og dets biblioteker i én fil: app.jar. Min Dockerfile bruger Java 17 og starter serveren fra denne fil.