完成了接口和基本的类定义

This commit is contained in:
2025-11-14 01:54:04 +08:00
commit b73727ccc2
22 changed files with 988 additions and 0 deletions

View File

@@ -0,0 +1,48 @@
package backend.service.interfaces;
/**
* 认证服务接口
* 提供用户认证和权限管理相关功能
*/
public interface AuthService {
/**
* 用户登录验证
* 验证用户名和密码是否匹配,如果匹配则允许用户登录系统
*
* @param username 用户名
* @param password 密码
* @return 登录成功返回true失败返回false
*/
boolean login(String username, String password);
/**
* 用户注册
* 创建新的用户账户,将用户信息存储到系统中
*
* @param username 用户名
* @param password 密码
* @param email 邮箱地址
* @return 注册成功返回true失败返回false
*/
boolean register(String username, String password, String email);
/**
* 用户登出
* 使指定用户的会话失效,结束用户的登录状态
*
* @param userId 用户唯一标识符
* @return 登出成功返回true失败返回false
*/
boolean logout(int userId);
/**
* 权限检查
* 检查指定用户是否具有所需的权限角色
*
* @param userId 用户唯一标识符
* @param requiredRole 所需的角色权限
* @return 具有权限返回true无权限返回false
*/
boolean hasPermission(int userId, String requiredRole);
}

View File

@@ -0,0 +1,49 @@
package backend.service.interfaces;
import backend.model.DataItem;
import backend.model.QueryRecord;
import backend.model.User;
import java.util.*;
/**
* 数据查询服务接口
* 提供数据项的增删改查功能
*/
public interface DataQueryService {
/**
* 查询所有数据项
* @return 包含所有数据项的列表
*/
List<DataItem> queryAll();
/**
* 根据关键字搜索数据项
* @param keyword 搜索关键字
* @return 匹配关键字的数据项列表
*/
List<DataItem> search(String keyword);
/**
* 添加数据项
* @param item 要添加的数据项对象
* @param userId 执行操作的用户ID
* @return 添加成功返回true失败返回false
*/
boolean addDataItem(DataItem item, int userId);
/**
* 更新数据项
* @param item 要更新的数据项对象
* @param userId 执行操作的用户ID
* @return 更新成功返回true失败返回false
*/
boolean updateDataItem(DataItem item, int userId);
/**
* 删除数据项
* @param id 要删除的数据项ID
* @param userId 执行操作的用户ID
* @return 删除成功返回true失败返回false
*/
boolean deleteDataItem(int id, int userId);
}

View File

@@ -0,0 +1,33 @@
package backend.service.interfaces;
import backend.model.User;
import java.util.*;
/**
* 用户服务接口
* 定义了用户相关的业务操作方法
*/
public interface UserService {
/**
* 根据用户ID获取用户信息
* @param id 用户ID
* @return 用户对象如果未找到则返回null
*/
User getUserInfo(int id);
/**
* 列出所有用户信息
* @param requesterId 请求者用户ID用于权限验证
* @return 用户列表
*/
List<User> listAllUsers(int requesterId);
/**
* 更新用户角色权限
* @param targetId 目标用户ID
* @param newRole 新的角色权限
* @param adminId 管理员用户ID
* @return 操作是否成功
*/
boolean updateUserRole(int targetId, String newRole, int adminId);//用户权限
}