forked from WEB-IB-SS26/development-ib
09: Labor
parent
0ad7ca40e4
commit
5cbe3c0553
|
|
@ -0,0 +1,41 @@
|
|||
# Übungsblatt 09
|
||||
|
||||
## 1. Go-Übung: Datenbank INSERT
|
||||
|
||||
**Aufgabenstellung**: Erstellen Sie ein Webserver-Programm in Go, dass beim Aufruf eines Endpunkts `/insert` einen neuen Datensatz in der Datenbank speichert.
|
||||
|
||||
## 2. Go-Übung: Datenbank UPDATE
|
||||
|
||||
**Aufgabenstellung**: Erweitern Sie das Programm aus Aufgabe 1 um einen neuen Endpunkt `/update`, der einen vorhandenen Datensatz in der Datenbank aktualisiert.
|
||||
|
||||
### Hinweise zu Aufgaben 1 und 2
|
||||
1. Erstellen Sie zunächst die benötigten Tabellen und Datensätze in Ihrer Datenbank. Eine Anleitung hierfür finden Sie hier: [Datenbank vorbereiten](db/anleitung_db.md)
|
||||
2. Verwenden Sie folgende Schnittstellen-Definition für Ihre Implementierung: [Swagger-API](hobbiesapi.json)
|
||||
3. Tipp: Um die Elemente eines Slice in einem String zusammenzufügen, können Sie das Paket `strings` aus der Standard-Bibliothek verwenden: [strings.Join](https://pkg.go.dev/strings#Join)
|
||||
|
||||
## 3. HTML-Übung: Formular
|
||||
|
||||
**Aufgabenstellung**: Schreiben Sie ein HTML-Formular, dass die Schnittstelle [Swagger-API](hobbiesapi.json) implementiert und Benutzereingaben an das in Aufgabe 1 + 2 implementierte Backend sendet.
|
||||
|
||||
## 4. Go-Übung: CORS
|
||||
|
||||
_Keine Abgabe erforderlich_
|
||||
|
||||
**Aufgabenstellung**: Erweitern Sie die beiden serverseitigen Go-Programme zur Workshop-Anmeldung aus den vorangegangen Übungsblättern 07 und 08 so, dass beim Ausführen der "Try Out"-Funktion in der SwaggerUI-Preview kein CORS-Fehler mehr auftaucht.
|
||||
|
||||
#### Arbeitsschritte
|
||||
|
||||
1. Fügen Sie folgende Zeile am Anfang in Ihrer Handler `func` oder in der `ServeHTTP`-Funktion ihres `http.Handler` auf:
|
||||
|
||||
```go
|
||||
w.Header().Set("Access-Control-Allow-Origin", "*")
|
||||
w.Header().Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
|
||||
w.Header().Set("Access-Control-Allow-Headers", "Content-Type")
|
||||
|
||||
if r.Method == "OPTIONS" {
|
||||
w.WriteHeader(http.StatusNoContent)
|
||||
return
|
||||
}
|
||||
```
|
||||
|
||||
2. Testen Sie Ihr(e) Programm(e) mit dieser [Workshop-API](workshop-api.json).
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
# Tooling für die Entwicklung mit einer PostGreSQL-DB
|
||||
|
||||
Diese Anleitung beschreibt die Schritte zur Verbindung mit einer PostGreSQL-DB sowie das Erstellen von Tabellen mit Hilfe der VS Code Extension _PostgreSQL_ und der im Dev-Container enthaltenen Datenbank.
|
||||
|
||||
## Neue Verbindung
|
||||
|
||||
1. Prüfen Sie, ob Sie sich im Dev-Container befinden
|
||||
2. Klicken Sie auf das PostGreSQL-Symbol (VS Code Extension) in der Activity Bar (default: linke Leiste)
|
||||
3. Wählen Sie "Add New Connection" und "CONNECTIONS" in der Primary Side Bar (meistens: links)
|
||||
1. Füllen Sie die geforderten Felder aus. Sie finden die Daten zu Ihrer Datenbank-Installation in der Datei `.env` innerhalb des `.devcontainer`- Ordners.
|
||||
2. Testen Sie die Verbindung ("Test Connection")
|
||||
3. Vergeben Sie einen geeigneten Namen und speichern Sie die Verbindung ("Save & Connect")
|
||||
|
||||
## Tabellen
|
||||
4. Öffnen Sie die Datei `create_personen.sql`.
|
||||
5. Auf der rechten Seite der Tab-Leiste erscheinen nun mehrere Symbole. Wählen Sie "Connect" aus und geben Sie ggf. Ihr Datenbank-Passwort ein (`POSTGRES_PASSWORD` in `.env`)
|
||||
6. Wählen Sie nun das Symbol für "Change PostGreSQL Database" aus und wählen Ihre Datenbank aus (`POSTGRES_DB` in `.env`)
|
||||
7. Wählen Sie nun das Symbol für "Execute PostGreSQL Query" aus: Es wird eine neue Tabelle in Ihrer Datenbank erstellt.
|
||||
|
||||
## Einfügen und Anzeigen
|
||||
8. Führen Sie die Schritte 5.-7. nun auch für die Dateien `insert_personen.sql` und `select_personen.sql` durch.
|
||||
9. Alternativ oder zusätzlich können Sie natürlich auch eigene Queries ausführen.
|
||||
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
CREATE TABLE personen (
|
||||
name TEXT NOT NULL,
|
||||
hobbies TEXT,
|
||||
alter SMALLINT
|
||||
);
|
||||
|
|
@ -0,0 +1,129 @@
|
|||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Hobbies API",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "http://localhost:8080"
|
||||
}
|
||||
],
|
||||
"paths": {
|
||||
"/insert": {
|
||||
"post": {
|
||||
"summary": "Erstellt eine:n neue:n Benutzer:in mit einer Liste von Hobbies",
|
||||
"requestBody": {
|
||||
"description": "Name und Hobbies des neuen Benutzers/der neuen Benutzerin",
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/x-www-form-urlencoded": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/Hobbies"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"$ref": "#/components/responses/SuccessResponse"
|
||||
},
|
||||
"400": {
|
||||
"$ref": "#/components/responses/BadRequestResponse"
|
||||
},
|
||||
"405": {
|
||||
"$ref": "#/components/responses/MethodNotAllowedResponse"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/update": {
|
||||
"post": {
|
||||
"summary": "Aktualisiert eine:n vorhandene:n Benutzer:in mit einer Liste von Hobbies",
|
||||
"requestBody": {
|
||||
"description": "Name und Hobbies des/der vorhandenen Benutzer:in",
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/x-www-form-urlencoded": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/Hobbies"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"$ref": "#/components/responses/SuccessResponse"
|
||||
},
|
||||
"400": {
|
||||
"$ref": "#/components/responses/BadRequestResponse"
|
||||
},
|
||||
"405": {
|
||||
"$ref": "#/components/responses/MethodNotAllowedResponse"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"Hobbies": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"name": {
|
||||
"type": "string",
|
||||
"example": "Lea"
|
||||
},
|
||||
"hobby": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
},
|
||||
"example": [
|
||||
"reiten",
|
||||
"backen"
|
||||
]
|
||||
},
|
||||
"alter": {
|
||||
"type": "integer",
|
||||
"example": 23
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"SuccessResponse": {
|
||||
"description": "Success",
|
||||
"content": {
|
||||
"text/html": {
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"BadRequestResponse": {
|
||||
"description": "Bad Request",
|
||||
"content": {
|
||||
"text/html": {
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"example": "Kein POST-Formular gesendet"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"MethodNotAllowedResponse": {
|
||||
"description": "Method not allowed",
|
||||
"content": {
|
||||
"text/html": {
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"example": "Nur POST-Methode erlaubt."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1 @@
|
|||
INSERT INTO personen (name, hobbies, alter) VALUES ('Siri', 'Lesen, Wandern, Kochen', 14),('Alexa', 'Kochen, Gitarre spielen', 11);
|
||||
|
|
@ -0,0 +1 @@
|
|||
SELECT * FROM personen;
|
||||
|
|
@ -0,0 +1,119 @@
|
|||
{
|
||||
"openapi": "3.0.0",
|
||||
"info": {
|
||||
"title": "Workshop API",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "http://localhost:8080"
|
||||
}
|
||||
],
|
||||
"paths": {
|
||||
"/registrierung": {
|
||||
"post": {
|
||||
"summary": "Sends all information needed for registering at a workshop",
|
||||
"requestBody": {
|
||||
"required": false,
|
||||
"content": {
|
||||
"application/x-www-form-urlencoded": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/RegistrierungForm"
|
||||
}
|
||||
},
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/RegistrierungForm"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Success",
|
||||
"content": {
|
||||
"text/html": {
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Bad Request",
|
||||
"content": {
|
||||
"text/plain": {
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"example": "Kein Formular gesendet"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"RegistrierungForm": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"vorname",
|
||||
"nachname",
|
||||
"agb",
|
||||
"format"
|
||||
],
|
||||
"properties": {
|
||||
"vorname": {
|
||||
"type": "string",
|
||||
"example": "Zoya"
|
||||
},
|
||||
"nachname": {
|
||||
"type": "string",
|
||||
"example": "Akhtar"
|
||||
},
|
||||
"email": {
|
||||
"type": "string",
|
||||
"example": "z.akhtar@test.de"
|
||||
},
|
||||
"telefon": {
|
||||
"type": "string",
|
||||
"example": "Zoya"
|
||||
},
|
||||
"sessions": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"example": "vormittag"
|
||||
},
|
||||
"example": [
|
||||
"vormittag",
|
||||
"nachmittag"
|
||||
]
|
||||
},
|
||||
"agb": {
|
||||
"type": "string",
|
||||
"enum": ["ja"],
|
||||
"example": "ja"
|
||||
},
|
||||
"newsletter": {
|
||||
"type": "string",
|
||||
"enum": ["ja"],
|
||||
"example": "ja"
|
||||
},
|
||||
"equipment": {
|
||||
"type": "string",
|
||||
"enum": ["ja"],
|
||||
"example": "ja"
|
||||
},
|
||||
"format": {
|
||||
"type": "string",
|
||||
"enum": ["online","praesenz"],
|
||||
"example": "online"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue