<?php

namespace app\controller\api;

use laytp\controller\Api;
use laytp\library\Random;

/**
 * Token相关
 */
class Token extends Api
{
    public $no_need_login = [];

    /*@formatter:off*/
    /**
     * @ApiTitle    (检测Token是否过期)
     * @ApiSummary  (检测Token是否过期)
     * @ApiMethod   (POST)
     * @ApiRoute    (/api.token/check)
     * @ApiHeaders  (name="token", type="string", required="true", description="用户登录后得到的Token")
     * @ApiReturnParams   (name="code", type="integer", description="接口返回码.0=常规正确码，表示常规操作成功；1=常规错误码，客户端仅需提示msg；其他返回码与具体业务相关。框架实现了的唯一其他返回码：10401，前端需要跳转至登录界面。在一个复杂的交互过程中，你可能需要自行定义其他返回码")
     * @ApiReturnParams   (name="msg", type="string", description="返回描述")
     * @ApiReturnParams   (name="time", type="integer", description="请求时间，Unix时间戳，单位秒")
     * @ApiReturnParams   (name="data", type="object", description="返回的数据对象")
     * @ApiReturnParams   (name="data.token", type="string", description="用户登录凭证，token")
     * @ApiReturnParams   (name="data.expires_in", type="integer", description="token有效时间，单位秒")
     * @ApiReturn
({
    "code": 0,
    "msg": "Token有效",
    "time": 1591167181,
    "data": {
        "token": "827fb87e-2064-45c8-839a-128e195a7411",
        "expires_in": 1789
    }
})
     */
    /*@formatter:on*/
    public function check()
    {
        $token     = $this->service_user->getToken();
        $tokenInfo = \library\Token::get($token);
        $this->success('Token有效', ['token' => $tokenInfo['token'], 'expires_in' => $tokenInfo['expires_in']]);
    }

    /*@formatter:off*/
    /**
     * @ApiTitle    (刷新Token)
     * @ApiSummary  (刷新Token)
     * @ApiMethod   (POST)
     * @ApiRoute    (/api.token/refresh)
     * @ApiHeaders  (name="token", type="string", required="true", description="用户登录后得到的Token")
     * @ApiReturnParams   (name="code", type="integer", description="接口返回码.0=常规正确码，表示常规操作成功；1=常规错误码，客户端仅需提示msg；其他返回码与具体业务相关。框架实现了的唯一其他返回码：10401，前端需要跳转至登录界面。在一个复杂的交互过程中，你可能需要自行定义其他返回码")
     * @ApiReturnParams   (name="msg", type="string", description="返回描述")
     * @ApiReturnParams   (name="time", type="integer", description="请求时间，Unix时间戳，单位秒")
     * @ApiReturnParams   (name="data", type="object", description="返回的数据对象")
     * @ApiReturnParams   (name="data.token", type="string", description="用户登录凭证，token")
     * @ApiReturnParams   (name="data.expires_in", type="integer", description="token有效时间，单位秒")
     * @ApiReturn
({
    "code": 0,
    "msg": "成功刷新Token",
    "time": 1591167423,
    "data": {
        "token": "e356df60-ff03-4f15-bb66-c0e3ef37f335",
        "expires_in": 1800
    }
})
     */
    /*@formatter:on*/
    public function refresh()
    {
        //删除源Token
        $token = $this->service_user->getToken();
        \library\Token::delete($token);
        //创建新Token
        $token = Random::uuid();
        \library\Token::set($token, $this->service_user->id, $this->service_user->token_keep_time);
        $this->success('成功刷新Token', ['token' => $token, 'expires_in' => $this->service_user->token_keep_time]);
    }
}