Habrahabr\Api\Resources\PostResource

Complexity

Total Complexity

7

Size/Duplication

Total Lines	122
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Test Coverage

Coverage

100%

Importance

Changes	7
Bugs	0	Features	0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	getPost()	0	6	1
A	votePlus()	0	6	1
A	voteMinus()	0	6	1
A	voteNeutral()	0	6	1
A	vote()	0	4	1
A	addPostToFavorite()	0	6	1
A	removePostFromFavorite()	0	6	1

<?php

namespace Habrahabr\Api\Resources;

use Habrahabr\Api\Exception\IncorrectUsageException;

/**
 * Class PostResource
 *
 * Ресурс работы с постами
 *
 * @package Habrahabr\Api\Resources
 * @version 0.0.8
 * @author thematicmedia <info@tmtm.ru>
 * @link https://tmtm.ru/
 * @link https://habrahabr.ru/
 * @link https://github.com/thematicmedia/habrahabr_api
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
class PostResource extends AbstractResource implements ResourceInterface
{
    /**
     * @const Флаг голосования в плюс
     */
    const VOTE_PLUS = 1;

    /**
     * @const Флаг голосования нейтрально
     */
    const VOTE_NEUTRAL = 0;

    /**
     * @const Флаг голосования в минус
     */
    const VOTE_MINUS = -1;

    /**
     * Возвращает пост по номеру
     *
     * @param int $post_id Номер поста
     * @return array
     * @throws IncorrectUsageException
     */
    public function getPost($post_id)
    {
        $this->checkId($post_id);

        return $this->adapter->get(sprintf('/post/%d', $post_id));
    }

    /**
     * Положительное голосование за пост
     *
     * Этот метод может быть предоставлен дополнительно, по запросу
     * https://habrahabr.ru/feedback/
     *
     * @param int $post_id Номер поста
     * @return array
     * @throws IncorrectUsageException
     */
    public function votePlus($post_id)
    {
        $this->checkId($post_id);

        return $this->vote($post_id, self::VOTE_PLUS);
    }

    /**
     * Отрицательное голосование за пост
     *
     * Этот метод может быть предоставлен дополнительно, по запросу
     * https://habrahabr.ru/feedback/
     *
     * @param int $post_id Номер поста
     * @return array
     * @throws IncorrectUsageException
     */
    public function voteMinus($post_id)
    {
        $this->checkId($post_id);

        return $this->vote($post_id, self::VOTE_MINUS);
    }

    /**
     * Нейтральное голосование за пост
     *
     * Этот метод может быть предоставлен дополнительно, по запросу
     * https://habrahabr.ru/feedback/
     *
     * @param int $post_id Номер поста
     * @return array
     * @throws IncorrectUsageException
     */
    public function voteNeutral($post_id)
    {
        $this->checkId($post_id);

        return $this->vote($post_id, self::VOTE_NEUTRAL);
    }

    /**
     * Добавить пост в избранное
     *
     * @param int $post_id Номер поста
     * @return array
     * @throws IncorrectUsageException
     */
    public function addPostToFavorite($post_id)
    {
        $this->checkId($post_id);

        return $this->adapter->put(sprintf('/post/%d/favorite', $post_id));
    }

    /**
     * Удалить пост из избранного
     *
     * @param int $post_id Номер поста
     * @return array
     * @throws IncorrectUsageException
     */
    public function removePostFromFavorite($post_id)
    {
        $this->checkId($post_id);

        return $this->adapter->delete(sprintf('/post/%d/favorite', $post_id));
    }

    /**
     * Голосование за пост
     *
     * @param int $post_id Номер поста
     * @param int $vote Флаг голосования
     * @return array
     */
    private function vote($post_id, $vote)
    {
        return $this->adapter->put(sprintf('/post/%d/vote', $post_id), ['vote' => $vote]);
    }
}