*
* 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('No Article with this id');
}
$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);
}
// if (empty($articles)) {
// throw new PageNotFoundException('No such category // no Categories');
// }
$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 benenne sie "saveArticle".
*
*
*
* Nenne die Methode {@see saveArticle(Article $article)}
*
* @return void
*/
function postDoNewArticle(ParamBody $body): void {
$httpData = $body->parseJsonToHttpData();
$article = new Article();
$result = $this->exec(Bind::attrs($httpData)->toObj($article)
->prop('categoryName', Mappers::cleanString(true), Validators::enum(
['international', 'national', 'sport']))
->prop('text', Mappers::cleanString(true, maxlength: 9999) )
->prop('title', Mappers::cleanString(true, minlength: 3, maxlength: 255)));
if ($result->hasErrors()) {
$result->sendErrJson();
return;
}
$this->beginTransaction();
$this->articleDao->saveArticle($article);
$this->commit();
$this->sendJson($article);
}
/**
* 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
*/
function putDoArticle(int $articleId, ParamBody $body): void {
$article = $this->articleDao->getArticleById($articleId);
if (empty($article)) {
throw new PageNotFoundException('invalid article ID');
}
$httpData = $body->parseJsonToHttpData();
$result = $this->exec(Bind::attrs($httpData)->toObj($article)
->optProp('categoryName',
Validators::enum(['international', 'national', 'sport']),
Mappers::valueClosure(function ($categoryNameStr) {
return CategoryName::tryFrom($categoryNameStr);
}))
->optProp('text', Mappers::cleanString(true, maxlength: 9999) )
->optProp('title', Mappers::cleanString(true, minlength: 3, maxlength: 255)));
if ($result->hasErrors()) {
$result->sendErrJson();
return;
}
$this->beginTransaction();
$this->articleDao->saveArticle($article);
$this->commit();
$this->sendJson($article->jsonSerialize());
}
/**
* 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 {
$articleObject = $this->articleDao->getArticleById($articleId);
if (empty($articleObject)) {
throw new PageNotFoundException('invalid article ID');
}
$this->beginTransaction();
$this->articleDao->removeArticle($articleObject);
$this->commit();
}
}