*
* Gib "irgendöpis" mit dem {@code echo} command aus.
*
*
* Ändere die Antwort nun zu einem gültigen json objekt {"hello" => "world"}. Übergebe dafür ein array der
* Methode {@see $this->sendJson()}.
*
*
* Implementiere und nutze die Methode {@see ArticleDao::getArticleById()}, um das entsprechende Artikel-Objekt
* aus der Datenbank zu lesen und gebe diese anschliessend im JSON Format zurück.
*
* Das Article-Objekt kannst du einfach {@see $this->sendJson()} übergeben, um einen validen JSON-Response zu
* generieren.
*
*
* Kann der Artikel nicht gefunden werden, werfe eine {@link PageNotFoundException}.
*
*
*
* @param int $articleId
* @return void
* @throws PageNotFoundException if Article could not be found.
*/
function getDoArticle(int $articleId): void {
$article = $this->articleDao->getArticleById($articleId);
if ($article === null) {
throw new PageNotFoundException();
} else {
$this->sendJson($article);
}
}
/**
* Diese Methode kannst du im Browser testen. Pfad: localhost/[ordner name vom projekt]/src-php/public/api/articles
*
*
* -
* Implementiere und nutze die Methode {@see ArticleDao::getArticles()}, um Artikel aus der Datenbank zu lesen
* und gebe diese anschliessend im JSON Format zurück.
*
* Article-Objekte kannst du einfach {@see $this->sendJson()} übergeben, um einen validen JSON-Response zu
* generieren.
*
* -
* Wird ein $categoryName übergeben, gebe nur die Artikel aus, die über diesen Kategorienamen verfügen.
*
*
*
* @param string|null $categoryName
* @return void
*/
function getDoArticles(?string $categoryName = null): void {
if ($categoryName == null) {
$articles = $this->articleDao->getArticles();
} else {
$articles = $this->articleDao->getArticlesByCategoryName($categoryName);
}
$this->sendJson($articles);
}
/**
* Speichere einen Artikel.
*
*
* -
* Der Kategoriename darf nur 'international','national' oder 'sport' sein.
* Validiere dies und schmeisse im Fehlerfall eine: {@see BadRequestException}
*
* -
* Mache eine neue Entity {@see Article} und befülle sie mit den übergebenen Daten.
*
* -
* Implementiere eine neue Methode im {@see ArticleDao} und bennene sie "saveArticle".
*
*
*
* Nenne die Methode {@see saveArticle(Article $article)}
*
* @return void
* @throws StatusException
*/
function postDoArticle(ParamBody $body): void {
$httpData = $body->parseJsonToHttpData();
$title = $httpData->reqString('title');
$text = $httpData->reqString('text');
$categoryName = $httpData->reqString('categoryName');
if (!$this->isValidArticleCategory($categoryName)) {
throw new BadRequestException();
}
$articleToAdd = $this->prepareArticle($title, $text, $categoryName);
$this->beginTransaction();
$this->articleDao->saveArticle($articleToAdd);
$this->commit();
}
/**
* Editiere einen Artikel.
*
*
* -
* Der Kategoriename darf nur 'international','national' oder 'sport' sein.
* Validiere dies und schmeisse im Fehlerfall eine: {@see BadRequestException}
*
* -
* Finde den dazugehörigen {@see Article} und passe die Daten mit denjenigen Daten von gestern ab.
*
* -
* Implementiere eine neue Methode im {@see ArticleDao} und nenne die Methode {@see saveArticle(Article $article)}.
*
*
*
* @return void
* @throws StatusException
*/
function putDoArticle(int $articleId, ParamBody $body): void {
$httpData = $body->parseJsonToHttpData();
$title = $httpData->reqString('title');
$text = $httpData->reqString('text');
$categoryName = $httpData->reqString('categoryName');
if (!$this->isValidArticleCategory($categoryName)) {
throw new BadRequestException();
}
$article = $this->articleDao->getArticleById($articleId);
if ($article === null) {
throw new PageNotFoundException();
}
$article->setCategoryName($categoryName);
$article->setTitle($title);
$article->setText($text);
$this->beginTransaction();
$this->articleDao->saveArticle($article);
$this->commit();
}
/**
* Löscht den {@see Article} mit der dazugehörigen Id.
*
*
* - Mache eine neue Methode im {@see ArticleDao} und benenne sie "removeArticle(int articleId)
*
*
* @return void
*/
function deleteDoArticle(int $articleId): void {
$this->beginTransaction();
$this->articleDao->removeArticle($articleId);
$this->commit();
}
/*
* Überprüft, ob die Article Category einen gültigen Wert enthält.
* @return boolean
*/
function isValidArticleCategory($category): bool {
$categories = array('international', 'national', 'sport');
return in_array($category, $categories);
}
/*
* Stellt aus den Input Parametern ein Article Objekt zur Verfügung.
* @return Article
*/
function prepareArticle($title, $text, $categoryName): Article {
$article = new Article();
$article->setCategoryName($categoryName);
$article->setTitle($title);
$article->setText($text);
return $article;
}
}