This repository has been archived on 2024-01-19. You can view files and clone it, but cannot push or open issues or pull requests.
epubreader/lib/Service/BookmarkService.php

112 lines
2.4 KiB
PHP
Raw Normal View History

2020-04-21 20:37:42 +00:00
<?php
/**
* @author Frank de Lange
* @copyright 2017 Frank de Lange
*
* This file is licensed under the Affero General Public License version 3 or
* later.
* See the COPYING-README file.
*/
namespace OCA\Epubreader\Service;
2020-04-21 20:37:42 +00:00
use OCA\Epubreader\Db\BookmarkMapper;
2020-04-21 20:37:42 +00:00
class BookmarkService extends Service {
2023-06-16 14:58:23 +00:00
// "bookmark" name to use for the cursor (current reading position)
public const CURSOR = '__CURSOR__';
public const bookmark_type = 'bookmark';
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
private $bookmarkMapper;
private $userId;
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
public function __construct(BookmarkMapper $bookmarkMapper, $UserId) {
parent::__construct($bookmarkMapper);
$this->bookmarkMapper = $bookmarkMapper;
$this->userId = $UserId;
}
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
/**
* @brief get bookmark
*
* bookmark type is format-dependent, eg CFI for epub, page number for CBR/CBZ, etc
*
* @param int $fileId
* @param string $name
*
* @return array
*/
public function get($fileId, $name = null, $type = null) {
$result = $this->bookmarkMapper->get($fileId, $name, $type);
return array_map(
function ($entity) {
return $entity->toService();
}, $result);
}
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
/**
* @brief write bookmark
*
* position type is format-dependent, eg CFI for epub, page number for CBR/CBZ, etc
*
* @param int $fileId
* @param string $name
* @param string $value
*
* @return array
*/
public function set($fileId, $name, $value, $type = null, $content = null) {
return $this->bookmarkMapper->set($fileId, $name, $value, $type, $content);
}
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
/**
* @brief get cursor (current position in book)
*
* @param int $fileId
*
* @return array
*/
public function getCursor($fileId) {
$result = $this->get($fileId, static::CURSOR);
if (count($result) === 1) {
return $result[0];
}
}
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
/**
* @brief set cursor (current position in book)
*
* @param int $fileId
* @param string $value
*
* @return array
*/
public function setCursor($fileId, $value) {
return $this->bookmarkMapper->set($fileId, static::CURSOR, $value, static::bookmark_type);
}
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
/**
* @brief delete bookmark
*
* @param int $fileId
* @param string $name
*
*/
public function delete($fileId, $name, $type = null) {
foreach ($this->bookmarkMapper->get($fileId, $name, $type) as $bookmark) {
$this->bookmarkMapper->delete($bookmark);
}
}
2020-04-21 20:37:42 +00:00
2023-06-16 14:58:23 +00:00
/**
* @brief delete cursor
*
* @param int $fileId
*
*/
public function deleteCursor($fileId) {
$this->delete($fileId, static::CURSOR, static::bookmark_type);
}
2020-04-21 20:37:42 +00:00
}