namespace Wallabag\CoreBundle\Controller;
use Nelmio\ApiDocBundle\Annotation\ApiDoc;
-use FOS\RestBundle\Controller\Annotations\View;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-use Wallabag\CoreBundle\Entity\Entries;
-use Wallabag\CoreBundle\Entity\Tags;
-use Wallabag\CoreBundle\Entity\Users;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Wallabag\CoreBundle\Entity\Entry;
+use Wallabag\CoreBundle\Entity\Tag;
+use Wallabag\CoreBundle\Service\Extractor;
-class WallabagRestController
+class WallabagRestController extends Controller
{
+ /**
+ * Retrieve salt for a giver user.
+ *
+ * @ApiDoc(
+ * parameters={
+ * {"name"="username", "dataType"="string", "required"=true, "description"="username"}
+ * }
+ * )
+ * @return array
+ */
+ public function getSaltAction($username)
+ {
+ $user = $this
+ ->getDoctrine()
+ ->getRepository('WallabagCoreBundle:User')
+ ->findOneByUsername($username);
+
+ if (is_null($user)) {
+ throw $this->createNotFoundException();
+ }
+ return array($user->getSalt() ?: null);
+ }
/**
- * Fetches all entries
+ * Retrieve all entries. It could be filtered by many options.
*
* @ApiDoc(
+ * parameters={
+ * {"name"="archive", "dataType"="boolean", "required"=false, "format"="true or false, all entries by default", "description"="filter by archived status."},
+ * {"name"="star", "dataType"="boolean", "required"=false, "format"="true or false, all entries by default", "description"="filter by starred status."},
+ * {"name"="sort", "dataType"="string", "required"=false, "format"="'created' or 'updated', default 'created'", "description"="sort entries by date."},
+ * {"name"="order", "dataType"="string", "required"=false, "format"="'asc' or 'desc', default 'desc'", "description"="order of sort."},
+ * {"name"="page", "dataType"="integer", "required"=false, "format"="default '1'", "description"="what page you want."},
+ * {"name"="perPage", "dataType"="integer", "required"=false, "format"="default'30'", "description"="results per page."},
+ * {"name"="tags", "dataType"="string", "required"=false, "format"="api%2Crest", "description"="a list of tags url encoded. Will returns entries that matches ALL tags."},
+ * }
* )
- * @return Entries
+ * @return Entry
*/
- public function getEntriesAction()
+ public function getEntriesAction(Request $request)
{
+ $isArchived = $request->query->get('archive');
+ $isStarred = $request->query->get('star');
+ $sort = $request->query->get('sort', 'created');
+ $order = $request->query->get('order', 'desc');
+ $page = $request->query->get('page', 1);
+ $perPage = $request->query->get('perPage', 30);
+ $tags = $request->query->get('tags', array());
+
+ $entries = $this
+ ->getDoctrine()
+ ->getRepository('WallabagCoreBundle:Entry')
+ ->findEntries($this->getUser()->getId(), $isArchived, $isStarred, $sort, $order);
+
+ if (!($entries)) {
+ throw $this->createNotFoundException();
+ }
+ $json = $this->get('serializer')->serialize($entries, 'json');
+
+ return new Response($json, 200, array('application/json'));
}
/**
- * Fetches an entry
+ * Retrieve a single entry
*
* @ApiDoc(
* requirements={
* {"name"="entry", "dataType"="integer", "requirement"="\w+", "description"="The entry ID"}
* }
* )
- * @return Entries
+ * @return Entry
*/
- public function getEntryAction(Entries $entry)
+ public function getEntryAction(Entry $entry)
{
- return $entry;
+ $json = $this->get('serializer')->serialize($entry, 'json');
+
+ return new Response($json, 200, array('application/json'));
}
/**
- * Deletes an entry
+ * Create an entry
*
* @ApiDoc(
- * requirements={
- * {"name"="entry", "dataType"="integer", "requirement"="\w+", "description"="The entry ID"}
- * }
+ * parameters={
+ * {"name"="url", "dataType"="string", "required"=true, "format"="http://www.test.com/article.html", "description"="Url for the entry."},
+ * {"name"="title", "dataType"="string", "required"=false, "description"="Optional, we'll get the title from the page."},
+ * {"name"="tags", "dataType"="string", "required"=false, "format"="tag1,tag2,tag3", "description"="a comma-separated list of tags."},
+ * }
* )
+ * @return Entry
*/
- public function deleteEntriesAction(Entries $entry)
+ public function postEntriesAction(Request $request)
{
+ //TODO gérer si on passe les tags
+ $url = $request->request->get('url');
+
+ $content = Extractor::extract($url);
+ $entry = new Entry($this->getUser());
+ $entry->setUrl($url);
+ $entry->setTitle($request->request->get('title') ?: $content->getTitle());
+ $entry->setContent($content->getBody());
+ $em = $this->getDoctrine()->getManager();
+ $em->persist($entry);
+ $em->flush();
+
+ $json = $this->get('serializer')->serialize($entry, 'json');
+ return new Response($json, 200, array('application/json'));
}
/**
- * Changes several properties of an entry. I.E tags, archived, starred and deleted status
+ * Change several properties of an entry
*
* @ApiDoc(
* requirements={
* {"name"="entry", "dataType"="integer", "requirement"="\w+", "description"="The entry ID"}
+ * },
+ * parameters={
+ * {"name"="title", "dataType"="string", "required"=false},
+ * {"name"="tags", "dataType"="string", "required"=false, "format"="tag1,tag2,tag3", "description"="a comma-separated list of tags."},
+ * {"name"="archive", "dataType"="boolean", "required"=false, "format"="true or false", "description"="archived the entry."},
+ * {"name"="star", "dataType"="boolean", "required"=false, "format"="true or false", "description"="starred the entry."},
* }
* )
+ * @return Entry
*/
- public function patchEntriesAction(Entries $entry)
+ public function patchEntriesAction(Entry $entry, Request $request)
{
+ $title = $request->request->get("title");
+ $tags = $request->request->get("tags", array());
+ $isArchived = $request->request->get("archive");
+ $isStarred = $request->request->get("star");
+
+ if (!is_null($title)) {
+ $entry->setTitle($title);
+ }
+
+ if (!is_null($isArchived)) {
+ $entry->setArchived($isArchived);
+ }
+ if (!is_null($isStarred)) {
+ $entry->setStarred($isStarred);
+ }
+
+ $em = $this->getDoctrine()->getManager();
+ $em->flush();
+
+ return $entry;
}
/**
- * Saves a new entry
+ * Delete **permanently** an entry
*
* @ApiDoc(
+ * requirements={
+ * {"name"="entry", "dataType"="integer", "requirement"="\w+", "description"="The entry ID"}
+ * }
* )
+ * @return Entry
*/
- public function postEntriesAction()
+ public function deleteEntriesAction(Entry $entry)
{
+ $em = $this->getDoctrine()->getManager();
+ $em->remove($entry);
+ $em->flush();
+
+ $json = $this->get('serializer')->serialize($entry, 'json');
+ return new Response($json, 200, array('application/json'));
}
/**
- * Gets tags for an entry
+ * Retrieve all tags for an entry
*
* @ApiDoc(
* requirements={
* }
* )
*/
- public function getEntriesTagsAction(Entries $entry) {
-
+ public function getEntriesTagsAction(Entry $entry)
+ {
}
/**
- * Saves new tag for an entry
+ * Add one or more tags to an entry
*
* @ApiDoc(
* requirements={
* {"name"="entry", "dataType"="integer", "requirement"="\w+", "description"="The entry ID"}
- * }
+ * },
+ * parameters={
+ * {"name"="tags", "dataType"="string", "required"=false, "format"="tag1,tag2,tag3", "description"="a comma-separated list of tags."},
+ * }
* )
*/
- public function postEntriesTagsAction(Entries $entry) {
-
+ public function postEntriesTagsAction(Entry $entry)
+ {
}
/**
- * Remove tag for an entry
+ * Permanently remove one tag for an entry
*
* @ApiDoc(
* requirements={
* }
* )
*/
- public function deleteEntriesTagsAction(Entries $entry, Tags $tag)
+ public function deleteEntriesTagsAction(Entry $entry, Tag $tag)
{
-
}
/**
- * Gets tags for a user
+ * Retrieve all tags
*
* @ApiDoc(
* )
*/
- public function getTagsAction() {
-
+ public function getTagsAction()
+ {
}
/**
- * Gets one tag
+ * Retrieve a single tag
*
* @ApiDoc(
- * {"name"="tag", "dataType"="string", "requirement"="\w+", "description"="The tag"}
+ * requirements={
+ * {"name"="label", "dataType"="string", "requirement"="\w+", "description"="Label of the tag"}
+ * }
* )
*/
- public function getTagAction(Tags $tag) {
+ public function getTagAction($label)
+ {
+ $tag = $this
+ ->getDoctrine()
+ ->getRepository('WallabagCoreBundle:Tag')
+ ->findOneByLabel($label);
+
+ if (is_null($tag)) {
+ throw $this->createNotFoundException();
+ }
+ $json = $this->get('serializer')->serialize($tag, 'json');
+
+ return new Response($json, 200, array('application/json'));
}
/**
- * Delete tag
+ * Permanently remove one tag from **every** entry
*
* @ApiDoc(
* requirements={
* }
* )
*/
- public function deleteTagAction(Tags $tag)
+ public function deleteTagAction(Tag $tag)
{
-
}
-}
\ No newline at end of file
+}
projects / github / wallabag / wallabag.git / blobdiff