kongdeqiang
2026-10-12 ccf1a44c001e233c158bd168dc2d0d96721af929
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
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);
}