ja Requester class

Requester

名前の妥当性はよくわからん。

Requesterとは何か

APIリクエストするための手続きを静的メソッドとしてを集めたクラスです。いや、別にクラスではなくて名前空間入りの函数でも良いんですけど、クラスなら自動で遅延ロードできますからね。

Requesterの実装

I'm a static guy.

class Requester
{
    /**
     * Fetching an account
     *
     * @see https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#fetching-an-account
     * @param  Client         $client
     * @param  SessionStorage $session
     * @param  int            $id
     * @return Entity\Account ← 返値の型(クラス名)を明示する
     */
    public static function getAccount(Client $client, SessionStorage $session, $id)
    {
        // check type ($id > 0)
        v::intVal()->min(0)->assert($id);

        // return 
        return static::map(
            Entity\Account::class, // ← クラス名文字列
            $client->requestAPI('GET', sprintf('/api/v1/accounts/%d', $id), [], $session)
        );
    }

    // ...
}

Mastodon\Client $clientはGuzzle6の引数をそのまま受け付けるので、HTTPリクエストの構築方法を学ぶにはRequest Options — Guzzle Documentationを読む必要があります。

さっき気付いたんですけど、全部のメソッドにClient $client, SessionStorage $sessionって書くのもそれはそれでめんどくさいので、コンストラクタに分けて、手続きはやっぱりstaticにしなくてもいいですね。どーしようかな。