<?php

// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2023 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
declare(strict_types=1);

namespace think\db;

use DateInterval;
use DateTime;
use DateTimeInterface;
use think\db\exception\InvalidArgumentException;

/**
 * CacheItem实现类.
 */
class CacheItem
{
    /**
     * 缓存Key.
     *
     * @var string
     */
    protected $key;

    /**
     * 缓存内容.
     *
     * @var mixed
     */
    protected $value;

    /**
     * 过期时间.
     *
     * @var int|DateTimeInterface
     */
    protected $expire;

    /**
     * 缓存tag.
     *
     * @var string
     */
    protected $tag;

    /**
     * 缓存是否命中.
     *
     * @var bool
     */
    protected $isHit = false;

    public function __construct(?string $key = null)
    {
        $this->key = $key;
    }

    /**
     * 为此缓存项设置「键」.
     *
     * @param string $key
     *
     * @return $this
     */
    public function setKey(string $key)
    {
        $this->key = $key;

        return $this;
    }

    /**
     * 返回当前缓存项的「键」.
     *
     * @return string
     */
    public function getKey()
    {
        return $this->key;
    }

    /**
     * 返回当前缓存项的有效期
     *
     * @return DateTimeInterface|int|null
     */
    public function getExpire()
    {
        if ($this->expire instanceof DateTimeInterface) {
            return $this->expire;
        }

        return $this->expire ? $this->expire - time() : null;
    }

    /**
     * 获取缓存Tag.
     *
     * @return string|array
     */
    public function getTag()
    {
        return $this->tag;
    }

    /**
     * 凭借此缓存项的「键」从缓存系统里面取出缓存项.
     *
     * @return mixed
     */
    public function get()
    {
        return $this->value;
    }

    /**
     * 确认缓存项的检查是否命中.
     *
     * @return bool
     */
    public function isHit(): bool
    {
        return $this->isHit;
    }

    /**
     * 为此缓存项设置「值」.
     *
     * @param mixed $value
     *
     * @return $this
     */
    public function set($value)
    {
        $this->value = $value;
        $this->isHit = true;

        return $this;
    }

    /**
     * 为此缓存项设置所属标签.
     *
     * @param string|array $tag
     *
     * @return $this
     */
    public function tag($tag = null)
    {
        $this->tag = $tag;

        return $this;
    }

    /**
     * 设置缓存项的有效期
     *
     * @param mixed $expire
     *
     * @return $this
     */
    public function expire($expire)
    {
        if (is_null($expire)) {
            $this->expire = null;
        } elseif (is_numeric($expire) || $expire instanceof DateInterval) {
            $this->expiresAfter($expire);
        } elseif ($expire instanceof DateTimeInterface) {
            $this->expire = $expire;
        } else {
            throw new InvalidArgumentException('not support datetime');
        }

        return $this;
    }

    /**
     * 设置缓存项的准确过期时间点.
     *
     * @param DateTimeInterface $expiration
     *
     * @return $this
     */
    public function expiresAt(DateTimeInterface $expiration)
    {
        $this->expire = $expiration;

        return $this;
    }

    /**
     * 设置缓存项的过期时间.
     *
     * @param int|DateInterval $timeInterval
     *
     * @throws InvalidArgumentException
     *
     * @return $this
     */
    public function expiresAfter($timeInterval)
    {
        if ($timeInterval instanceof DateInterval) {
            $this->expire = (int) DateTime::createFromFormat('U', (string) time())->add($timeInterval)->format('U');
        } elseif (is_numeric($timeInterval)) {
            $this->expire = $timeInterval + time();
        } else {
            throw new InvalidArgumentException('not support datetime');
        }

        return $this;
    }
}
