diff -r 2251fb41dbc7 -r 1e110b03ae96 web/lib/Zend/Service/Simpy.php --- a/web/lib/Zend/Service/Simpy.php Sun Apr 21 10:07:03 2013 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,433 +0,0 @@ -_http = new Zend_Http_Client; - $this->_http->setAuth($username, $password); - } - - /** - * Returns the HTTP client currently in use by this class for REST API - * calls, intended mainly for testing. - * - * @return Zend_Http_Client - */ - public function getHttpClient() - { - return $this->_http; - } - - /** - * Sends a request to the REST API service and does initial processing - * on the response. - * - * @param string $op Name of the operation for the request - * @param array $query Query data for the request (optional) - * @throws Zend_Service_Exception - * @return DOMDocument Parsed XML response - */ - protected function _makeRequest($op, $query = null) - { - if ($query != null) { - $query = array_diff($query, array_filter($query, 'is_null')); - $query = '?' . http_build_query($query); - } - - $this->_http->setUri($this->_baseUri . $op . '.do' . $query); - $response = $this->_http->request('GET'); - - if ($response->isSuccessful()) { - $doc = new DOMDocument(); - $doc->loadXML($response->getBody()); - $xpath = new DOMXPath($doc); - $list = $xpath->query('/status/code'); - - if ($list->length > 0) { - $code = $list->item(0)->nodeValue; - - if ($code != 0) { - $list = $xpath->query('/status/message'); - $message = $list->item(0)->nodeValue; - /** - * @see Zend_Service_Exception - */ - require_once 'Zend/Service/Exception.php'; - throw new Zend_Service_Exception($message, $code); - } - } - - return $doc; - } - - /** - * @see Zend_Service_Exception - */ - require_once 'Zend/Service/Exception.php'; - throw new Zend_Service_Exception($response->getMessage(), $response->getStatus()); - } - - /** - * Returns a list of all tags and their counts, ordered by count in - * decreasing order - * - * @param int $limit Limits the number of tags returned (optional) - * @link http://www.simpy.com/doc/api/rest/GetTags - * @throws Zend_Service_Exception - * @return Zend_Service_Simpy_TagSet - */ - public function getTags($limit = null) - { - $query = array( - 'limit' => $limit - ); - - $doc = $this->_makeRequest('GetTags', $query); - - /** - * @see Zend_Service_Simpy_TagSet - */ - require_once 'Zend/Service/Simpy/TagSet.php'; - return new Zend_Service_Simpy_TagSet($doc); - } - - /** - * Removes a tag. - * - * @param string $tag Tag to be removed - * @link http://www.simpy.com/doc/api/rest/RemoveTag - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function removeTag($tag) - { - $query = array( - 'tag' => $tag - ); - - $this->_makeRequest('RemoveTag', $query); - - return $this; - } - - /** - * Renames a tag. - * - * @param string $fromTag Tag to be renamed - * @param string $toTag New tag name - * @link http://www.simpy.com/doc/api/rest/RenameTag - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function renameTag($fromTag, $toTag) - { - $query = array( - 'fromTag' => $fromTag, - 'toTag' => $toTag - ); - - $this->_makeRequest('RenameTag', $query); - - return $this; - } - - /** - * Merges two tags into a new tag. - * - * @param string $fromTag1 First tag to merge. - * @param string $fromTag2 Second tag to merge. - * @param string $toTag Tag to merge the two tags into. - * @link http://www.simpy.com/doc/api/rest/MergeTags - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function mergeTags($fromTag1, $fromTag2, $toTag) - { - $query = array( - 'fromTag1' => $fromTag1, - 'fromTag2' => $fromTag2, - 'toTag' => $toTag - ); - - $this->_makeRequest('MergeTags', $query); - - return $this; - } - - /** - * Splits a single tag into two separate tags. - * - * @param string $tag Tag to split - * @param string $toTag1 First tag to split into - * @param string $toTag2 Second tag to split into - * @link http://www.simpy.com/doc/api/rest/SplitTag - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function splitTag($tag, $toTag1, $toTag2) - { - $query = array( - 'tag' => $tag, - 'toTag1' => $toTag1, - 'toTag2' => $toTag2 - ); - - $this->_makeRequest('SplitTag', $query); - - return $this; - } - - /** - * Performs a query on existing links and returns the results or returns all - * links if no particular query is specified (which should be used sparingly - * to prevent overloading Simpy servers) - * - * @param Zend_Service_Simpy_LinkQuery $q Query object to use (optional) - * @return Zend_Service_Simpy_LinkSet - */ - public function getLinks(Zend_Service_Simpy_LinkQuery $q = null) - { - if ($q != null) { - $query = array( - 'q' => $q->getQueryString(), - 'limit' => $q->getLimit(), - 'date' => $q->getDate(), - 'afterDate' => $q->getAfterDate(), - 'beforeDate' => $q->getBeforeDate() - ); - - $doc = $this->_makeRequest('GetLinks', $query); - } else { - $doc = $this->_makeRequest('GetLinks'); - } - - /** - * @see Zend_Service_Simpy_LinkSet - */ - require_once 'Zend/Service/Simpy/LinkSet.php'; - return new Zend_Service_Simpy_LinkSet($doc); - } - - /** - * Saves a given link. - * - * @param string $title Title of the page to save - * @param string $href URL of the page to save - * @param int $accessType ACCESSTYPE_PUBLIC or ACCESSTYPE_PRIVATE - * @param mixed $tags String containing a comma-separated list of - * tags or array of strings containing tags - * (optional) - * @param string $urlNickname Alternative custom title (optional) - * @param string $note Free text note (optional) - * @link Zend_Service_Simpy::ACCESSTYPE_PUBLIC - * @link Zend_Service_Simpy::ACCESSTYPE_PRIVATE - * @link http://www.simpy.com/doc/api/rest/SaveLink - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function saveLink($title, $href, $accessType, $tags = null, $urlNickname = null, $note = null) - { - if (is_array($tags)) { - $tags = implode(',', $tags); - } - - $query = array( - 'title' => $title, - 'href' => $href, - 'accessType' => $accessType, - 'tags' => $tags, - 'urlNickname' => $urlNickname, - 'note' => $note - ); - - $this->_makeRequest('SaveLink', $query); - - return $this; - } - - /** - * Deletes a given link. - * - * @param string $href URL of the bookmark to delete - * @link http://www.simpy.com/doc/api/rest/DeleteLink - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function deleteLink($href) - { - $query = array( - 'href' => $href - ); - - $this->_makeRequest('DeleteLink', $query); - - return $this; - } - - /** - * Return a list of watchlists and their meta-data, including the number - * of new links added to each watchlist since last login. - * - * @link http://www.simpy.com/doc/api/rest/GetWatchlists - * @return Zend_Service_Simpy_WatchlistSet - */ - public function getWatchlists() - { - $doc = $this->_makeRequest('GetWatchlists'); - - /** - * @see Zend_Service_Simpy_WatchlistSet - */ - require_once 'Zend/Service/Simpy/WatchlistSet.php'; - return new Zend_Service_Simpy_WatchlistSet($doc); - } - - /** - * Returns the meta-data for a given watchlist. - * - * @param int $watchlistId ID of the watchlist to retrieve - * @link http://www.simpy.com/doc/api/rest/GetWatchlist - * @return Zend_Service_Simpy_Watchlist - */ - public function getWatchlist($watchlistId) - { - $query = array( - 'watchlistId' => $watchlistId - ); - - $doc = $this->_makeRequest('GetWatchlist', $query); - - /** - * @see Zend_Service_Simpy_Watchlist - */ - require_once 'Zend/Service/Simpy/Watchlist.php'; - return new Zend_Service_Simpy_Watchlist($doc->documentElement); - } - - /** - * Returns all notes in reverse chronological order by add date or by - * rank. - * - * @param string $q Query string formatted using Simpy search syntax - * and search fields (optional) - * @param int $limit Limits the number notes returned (optional) - * @link http://www.simpy.com/doc/api/rest/GetNotes - * @link http://www.simpy.com/simpy/FAQ.do#searchSyntax - * @link http://www.simpy.com/simpy/FAQ.do#searchFieldsLinks - * @return Zend_Service_Simpy_NoteSet - */ - public function getNotes($q = null, $limit = null) - { - $query = array( - 'q' => $q, - 'limit' => $limit - ); - - $doc = $this->_makeRequest('GetNotes', $query); - - /** - * @see Zend_Service_Simpy_NoteSet - */ - require_once 'Zend/Service/Simpy/NoteSet.php'; - return new Zend_Service_Simpy_NoteSet($doc); - } - - /** - * Saves a note. - * - * @param string $title Title of the note - * @param mixed $tags String containing a comma-separated list of - * tags or array of strings containing tags - * (optional) - * @param string $description Free-text note (optional) - * @param int $noteId Unique identifier for an existing note to - * update (optional) - * @link http://www.simpy.com/doc/api/rest/SaveNote - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function saveNote($title, $tags = null, $description = null, $noteId = null) - { - if (is_array($tags)) { - $tags = implode(',', $tags); - } - - $query = array( - 'title' => $title, - 'tags' => $tags, - 'description' => $description, - 'noteId' => $noteId - ); - - $this->_makeRequest('SaveNote', $query); - - return $this; - } - - /** - * Deletes a given note. - * - * @param int $noteId ID of the note to delete - * @link http://www.simpy.com/doc/api/rest/DeleteNote - * @return Zend_Service_Simpy Provides a fluent interface - */ - public function deleteNote($noteId) - { - $query = array( - 'noteId' => $noteId - ); - - $this->_makeRequest('DeleteNote', $query); - - return $this; - } -}