package com.test.musichouduan.repository;

import com.test.musichouduan.entity.User;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

import java.util.List;

import java.time.LocalDateTime;
import java.util.Optional;

/**
 * 用户数据访问层
 */
@Repository
public interface UserRepository extends JpaRepository<User, Long>, JpaSpecificationExecutor<User> {

    /**
     * 根据用户名查找用户
     *
     * @param username 用户名
     * @return 用户
     */
    Optional<User> findByUsername(String username);

    /**
     * 根据用户名或邮箱查找用户
     *
     * @param username 用户名
     * @param email 邮箱
     * @return 用户
     */
    Optional<User> findByUsernameOrEmail(String username, String email);

    /**
     * 判断用户名是否存在
     *
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(String username);

    /**
     * 判断邮箱是否存在
     *
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsByEmail(String email);

    /**
     * 统计指定时间范围内创建的用户数量
     *
     * @param start 开始时间
     * @param end 结束时间
     * @return 用户数量
     */
    long countByCreateTimeBetween(LocalDateTime start, LocalDateTime end);

    /**
     * 查询最新注册的用户
     *
     * @param pageable 分页
     * @return 用户列表
     */
    @Query("SELECT u FROM User u ORDER BY u.createTime DESC")
    List<User> findLatestUsers(Pageable pageable);
}
