namespace Wallabag\ApiBundle\Controller;
use FOS\RestBundle\Controller\FOSRestController;
-use Hateoas\Configuration\Route;
+use Hateoas\Configuration\Route as HateoasRoute;
use Hateoas\Representation\Factory\PagerfantaFactory;
use Nelmio\ApiDocBundle\Annotation\ApiDoc;
+use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
use Symfony\Component\Security\Core\Exception\AccessDeniedException;
use Wallabag\CoreBundle\Entity\Entry;
use Wallabag\CoreBundle\Entity\Tag;
+use Wallabag\AnnotationBundle\Entity\Annotation;
class WallabagRestController extends FOSRestController
{
}
}
+ /**
+ * Check if an entry exist by url.
+ *
+ * @ApiDoc(
+ * parameters={
+ * {"name"="url", "dataType"="string", "required"=true, "format"="An url", "description"="Url to check if it exists"},
+ * {"name"="urls", "dataType"="string", "required"=false, "format"="An array of urls (?urls[]=http...&urls[]=http...)", "description"="Urls (as an array) to check if it exists"}
+ * }
+ * )
+ *
+ * @return JsonResponse
+ */
+ public function getEntriesExistsAction(Request $request)
+ {
+ $this->validateAuthentication();
+
+ $urls = $request->query->get('urls', []);
+
+ // handle multiple urls first
+ if (!empty($urls)) {
+ $results = [];
+ foreach ($urls as $url) {
+ $res = $this->getDoctrine()
+ ->getRepository('WallabagCoreBundle:Entry')
+ ->findByUrlAndUserId($url, $this->getUser()->getId());
+
+ $results[$url] = false === $res ? false : true;
+ }
+
+ $json = $this->get('serializer')->serialize($results, 'json');
+
+ return (new JsonResponse())->setJson($json);
+ }
+
+ // let's see if it is a simple url?
+ $url = $request->query->get('url', '');
+
+ if (empty($url)) {
+ throw $this->createAccessDeniedException('URL is empty?, logged user id: '.$this->getUser()->getId());
+ }
+
+ $res = $this->getDoctrine()
+ ->getRepository('WallabagCoreBundle:Entry')
+ ->findByUrlAndUserId($url, $this->getUser()->getId());
+
+ $exists = false === $res ? false : true;
+
+ $json = $this->get('serializer')->serialize(['exists' => $exists], 'json');
+
+ return (new JsonResponse())->setJson($json);
+ }
+
/**
* Retrieve all entries. It could be filtered by many options.
*
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function getEntriesAction(Request $request)
{
$order = $request->query->get('order', 'desc');
$page = (int) $request->query->get('page', 1);
$perPage = (int) $request->query->get('perPage', 30);
- $since = $request->query->get('since', 0);
$tags = $request->query->get('tags', '');
+ $since = $request->query->get('since', 0);
$pager = $this->getDoctrine()
->getRepository('WallabagCoreBundle:Entry')
$pagerfantaFactory = new PagerfantaFactory('page', 'perPage');
$paginatedCollection = $pagerfantaFactory->createRepresentation(
$pager,
- new Route('api_get_entries', [], UrlGeneratorInterface::ABSOLUTE_URL)
+ new HateoasRoute(
+ 'api_get_entries',
+ [
+ 'archive' => $isArchived,
+ 'starred' => $isStarred,
+ 'sort' => $sort,
+ 'order' => $order,
+ 'page' => $page,
+ 'perPage' => $perPage,
+ 'tags' => $tags,
+ 'since' => $since,
+ ],
+ UrlGeneratorInterface::ABSOLUTE_URL
+ )
);
$json = $this->get('serializer')->serialize($paginatedCollection, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function getEntryAction(Entry $entry)
{
$json = $this->get('serializer')->serialize($entry, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
+ }
+
+ /**
+ * Retrieve a single entry as a predefined format.
+ *
+ * @ApiDoc(
+ * requirements={
+ * {"name"="entry", "dataType"="integer", "requirement"="\w+", "description"="The entry ID"}
+ * }
+ * )
+ *
+ * @return Response
+ */
+ public function getEntryExportAction(Entry $entry, Request $request)
+ {
+ $this->validateAuthentication();
+ $this->validateUserAccess($entry->getUser()->getId());
+
+ return $this->get('wallabag_core.helper.entries_export')
+ ->setEntries($entry)
+ ->updateTitle('entry')
+ ->exportAs($request->attributes->get('_format'));
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function postEntriesAction(Request $request)
{
$json = $this->get('serializer')->serialize($entry, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function patchEntriesAction(Entry $entry, Request $request)
{
$json = $this->get('serializer')->serialize($entry, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function deleteEntriesAction(Entry $entry)
{
$json = $this->get('serializer')->serialize($entry, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function getEntriesTagsAction(Entry $entry)
{
$json = $this->get('serializer')->serialize($entry->getTags(), 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function postEntriesTagsAction(Request $request, Entry $entry)
{
$json = $this->get('serializer')->serialize($entry, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function deleteEntriesTagsAction(Entry $entry, Tag $tag)
{
$json = $this->get('serializer')->serialize($entry, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
*
* @ApiDoc()
*
- * @return Response
+ * @return JsonResponse
*/
public function getTagsAction()
{
$tags = $this->getDoctrine()
->getRepository('WallabagCoreBundle:Tag')
- ->findAllTags($this->getUser()->getId())
- ->getQuery()
- ->getResult();
+ ->findAllTags($this->getUser()->getId());
$json = $this->get('serializer')->serialize($tags, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function deleteTagLabelAction(Request $request)
{
->getRepository('WallabagCoreBundle:Entry')
->removeTag($this->getUser()->getId(), $tag);
+ $this->cleanOrphanTag($tag);
+
$json = $this->get('serializer')->serialize($tag, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function deleteTagsLabelAction(Request $request)
{
->getRepository('WallabagCoreBundle:Entry')
->removeTags($this->getUser()->getId(), $tags);
+ $this->cleanOrphanTag($tags);
+
$json = $this->get('serializer')->serialize($tags, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
}
/**
* }
* )
*
- * @return Response
+ * @return JsonResponse
*/
public function deleteTagAction(Tag $tag)
{
->getRepository('WallabagCoreBundle:Entry')
->removeTag($this->getUser()->getId(), $tag);
+ $this->cleanOrphanTag($tag);
+
$json = $this->get('serializer')->serialize($tag, 'json');
+ return (new JsonResponse())->setJson($json);
+ }
+
+ /**
+ * Retrieve annotations for an entry.
+ *
+ * @ApiDoc(
+ * requirements={
+ * {"name"="entry", "dataType"="integer", "requirement"="\w+", "description"="The entry ID"}
+ * }
+ * )
+ *
+ * @return Response
+ */
+ public function getAnnotationsAction(Entry $entry)
+ {
+ $this->validateAuthentication();
+
+ $annotationRows = $this
+ ->getDoctrine()
+ ->getRepository('WallabagAnnotationBundle:Annotation')
+ ->findAnnotationsByPageId($entry->getId(), $this->getUser()->getId());
+ $total = count($annotationRows);
+ $annotations = array('total' => $total, 'rows' => $annotationRows);
+
+ $json = $this->get('serializer')->serialize($annotations, 'json');
+
+ return $this->renderJsonResponse($json);
+ }
+
+ /**
+ * Creates a new annotation.
+ *
+ * @param Entry $entry
+ *
+ * @ApiDoc(
+ * requirements={
+ * {"name"="ranges", "dataType"="array", "requirement"="\w+", "description"="The range array for the annotation"},
+ * {"name"="quote", "dataType"="string", "required"=false, "description"="Optional, quote for the annotation"},
+ * {"name"="text", "dataType"="string", "required"=true, "description"=""},
+ * }
+ * )
+ *
+ * @return Response
+ */
+ public function postAnnotationAction(Request $request, Entry $entry)
+ {
+ $this->validateAuthentication();
+
+ $data = json_decode($request->getContent(), true);
+
+ $em = $this->getDoctrine()->getManager();
+
+ $annotation = new Annotation($this->getUser());
+
+ $annotation->setText($data['text']);
+ if (array_key_exists('quote', $data)) {
+ $annotation->setQuote($data['quote']);
+ }
+ if (array_key_exists('ranges', $data)) {
+ $annotation->setRanges($data['ranges']);
+ }
+
+ $annotation->setEntry($entry);
+
+ $em->persist($annotation);
+ $em->flush();
+
+ $json = $this->get('serializer')->serialize($annotation, 'json');
+
+ return $this->renderJsonResponse($json);
+ }
+
+ /**
+ * Updates an annotation.
+ *
+ * @ApiDoc(
+ * requirements={
+ * {"name"="annotation", "dataType"="string", "requirement"="\w+", "description"="The annotation ID"}
+ * }
+ * )
+ *
+ * @ParamConverter("annotation", class="WallabagAnnotationBundle:Annotation")
+ *
+ * @return Response
+ */
+ public function putAnnotationAction(Annotation $annotation, Request $request)
+ {
+ $this->validateAuthentication();
+
+ $data = json_decode($request->getContent(), true);
+
+ if (!is_null($data['text'])) {
+ $annotation->setText($data['text']);
+ }
+
+ $em = $this->getDoctrine()->getManager();
+ $em->flush();
+
+ $json = $this->get('serializer')->serialize($annotation, 'json');
+
+ return $this->renderJsonResponse($json);
+ }
+
+ /**
+ * Removes an annotation.
+ *
+ * @ApiDoc(
+ * requirements={
+ * {"name"="annotation", "dataType"="string", "requirement"="\w+", "description"="The annotation ID"}
+ * }
+ * )
+ *
+ * @ParamConverter("annotation", class="WallabagAnnotationBundle:Annotation")
+ *
+ * @return Response
+ */
+ public function deleteAnnotationAction(Annotation $annotation)
+ {
+ $this->validateAuthentication();
+
+ $em = $this->getDoctrine()->getManager();
+ $em->remove($annotation);
+ $em->flush();
+
+ $json = $this->get('serializer')->serialize($annotation, 'json');
+
return $this->renderJsonResponse($json);
}
*
* @ApiDoc()
*
- * @return Response
+ * @return JsonResponse
*/
public function getVersionAction()
{
$json = $this->get('serializer')->serialize($version, 'json');
- return $this->renderJsonResponse($json);
+ return (new JsonResponse())->setJson($json);
+ }
+
+ /**
+ * Remove orphan tag in case no entries are associated to it.
+ *
+ * @param Tag|array $tags
+ */
+ private function cleanOrphanTag($tags)
+ {
+ if (!is_array($tags)) {
+ $tags = [$tags];
+ }
+
+ $em = $this->getDoctrine()->getManager();
+
+ foreach ($tags as $tag) {
+ if (count($tag->getEntries()) === 0) {
+ $em->remove($tag);
+ }
+ }
+
+ $em->flush();
}
/**
throw $this->createAccessDeniedException('Access forbidden. Entry user id: '.$requestUserId.', logged user id: '.$user->getId());
}
}
-
- /**
- * Send a JSON Response.
- * We don't use the Symfony JsonRespone, because it takes an array as parameter instead of a JSON string.
- *
- * @param string $json
- *
- * @return Response
- */
- private function renderJsonResponse($json)
- {
- return new Response($json, 200, ['application/json']);
- }
}