package com.custom.webui.service;
|
|
import com.custom.webui.dto.req.ChangePasswordRequest;
|
import com.custom.webui.dto.req.LoginRequest;
|
import com.custom.webui.dto.req.RegisterRequest;
|
import com.custom.webui.dto.resp.LoginResponse;
|
import com.custom.webui.dto.resp.UserDTO;
|
import com.custom.webui.entity.User;
|
|
/** 用户与认证服务。 */
|
public interface UserService {
|
|
/**
|
* 登录:校验用户名密码,成功返回 JWT 与用户信息。
|
*
|
* @throws com.custom.webui.exception.BusinessException 用户名或密码错误(401)
|
*/
|
LoginResponse login(LoginRequest request);
|
|
/**
|
* 注册新用户,角色固定为 user。
|
*
|
* @throws com.custom.webui.exception.BusinessException 用户名已存在(400)
|
*/
|
UserDTO register(RegisterRequest request);
|
|
/** 按 id 查用户,不存在抛 404 */
|
User requireById(Long userId);
|
|
/** 转 DTO(自动剥离 passwordHash) */
|
UserDTO toDto(User user);
|
|
/** 修改当前用户密码 */
|
void changePassword(Long userId, ChangePasswordRequest request);
|
}
|