根据用户类型获取不同的通知列表。
+ * + * @param token 用户token + * @return 返回包含通知列表的响应对象 + */ @GetMapping("/sys/notices") @ResponseBody - public R getNoticeList(String token){ - - Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); - if(ObjectUtils.isEmpty(user)) { - return R.error("登录信息不存在，请重新登录"); + public R getNoticeList(String token) { + Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); // 通过token获取用户信息 + if (ObjectUtils.isEmpty(user)) { // 检查用户信息是否存在 + return R.error("登录信息不存在，请重新登录"); // 用户信息不存在时返回错误响应 } - - if(user.getType() == 0){ - - List处理用户登录请求，验证用户名和密码。
+ * + * @param userName 用户名 + * @param passWord 密码 + * @param session HttpSession对象 + * @return 返回登录结果的响应对象 + */ @PostMapping("/login") @ResponseBody - public R login(String userName, String passWord, HttpSession session){ - - Log.info("用户登录，用户名：{}， 用户密码：{}", userName, passWord); - - Users user = usersService.getUserByUserName(userName); - - if(user == null) { + public R login(String userName, String passWord, HttpSession session) { + Log.info("用户登录，用户名：{}， 用户密码：{}", userName, passWord); // 记录日志 - return R.error("输入的用户名不存在"); - }else { + Users user = usersService.getUserByUserName(userName); // 根据用户名获取用户信息 - if(passWord.equals(user.getPassWord().trim())) { + if (user == null) { + return R.error("输入的用户名不存在"); // 用户不存在时返回错误响应 + } else { + if (passWord.equals(user.getPassWord().trim())) { // 验证密码 + String token = IDUtils.makeIDByUUID(); // 生成token + cacheHandle.addUserCache(token, user.getId()); // 将用户信息存储到缓存 - - String token = IDUtils.makeIDByUUID(); - cacheHandle.addUserCache(token, user.getId()); - - return R.success("登录成功", token); - }else { - - return R.error("输入的密码错误"); + return R.success("登录成功", token); // 返回成功响应，包含token + } else { + return R.error("输入的密码错误"); // 密码错误时返回错误响应 } } } + /** + * 用户退出。 + *处理用户退出请求，移除缓存中的用户信息。
+ * + * @param token 用户token + * @return 返回操作结果的响应对象 + */ @RequestMapping("/exit") @ResponseBody public R exit(String token) { + Log.info("用户退出系统并移除登录信息"); // 记录日志 - Log.info("用户退出系统并移除登录信息"); + cacheHandle.removeUserCache(token); // 从缓存中移除用户信息 - cacheHandle.removeUserCache(token); - - return R.success(); + return R.success(); // 返回成功响应 } + /** + * 获取用户信息。 + *根据token获取用户信息。
+ * + * @param token 用户token + * @return 返回包含用户信息的响应对象 + */ @GetMapping("/info") @ResponseBody - public R info(String token){ - - Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); + public R info(String token) { + Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); // 通过token获取用户信息 - return R.successData(user); + return R.successData(user); // 返回成功响应，包含用户信息 } + /** + * 修改用户信息。 + *根据用户信息更新用户数据。
+ * + * @param user 用户信息 + * @return 返回操作结果的响应对象 + */ @PostMapping("/info") @ResponseBody - public R info(Users user){ - - Log.info("修改用户信息，{}", user); + public R info(Users user) { + Log.info("修改用户信息，{}", user); // 记录日志 - usersService.update(user); + usersService.update(user); // 更新用户信息 - return R.success(); + return R.success(); // 返回成功响应 } + /** + * 检查密码。 + *验证原始密码是否正确。
+ * + * @param oldPwd 原始密码 + * @param token 用户token + * @return 返回密码验证结果的响应对象 + */ @RequestMapping("/checkPwd") @ResponseBody public R checkPwd(String oldPwd, String token) { + Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); // 通过token获取用户信息 - Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); - - if(oldPwd.equals(user.getPassWord())) { - - return R.success(); - }else { - - return R.warn("原始密码和输入密码不一致"); + if (oldPwd.equals(user.getPassWord())) { // 验证密码 + return R.success(); // 密码正确时返回成功响应 + } else { + return R.warn("原始密码和输入密码不一致"); // 密码错误时返回警告响应 } } + /** + * 修改密码。 + *根据新密码更新用户密码。
+ * + * @param token 用户token + * @param password 新密码 + * @return 返回操作结果的响应对象 + */ @PostMapping("/pwd") @ResponseBody public R pwd(String token, String password) { + Log.info("修改用户密码，{}", password); // 记录日志 - Log.info("修改用户密码，{}", password); - - Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); - - user.setPassWord(password); - usersService.update(user); + Users user = usersService.getOne(cacheHandle.getUserInfoCache(token)); // 通过token获取用户信息 + user.setPassWord(password); // 设置新密码 + usersService.update(user); // 更新用户信息 - return R.success(); + return R.success(); // 返回成功响应 } } \ No newline at end of file diff --git a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/dao/ActiveLogsDao.java b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/dao/ActiveLogsDao.java index ef207ab..129b191 100644 --- a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/dao/ActiveLogsDao.java +++ b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/dao/ActiveLogsDao.java @@ -1,17 +1,19 @@ package com.rabbiter.association.dao; +// 引入Spring框架的Repository注解，标识这是一个数据访问对象（DAO） import org.springframework.stereotype.Repository; - +// 引入MyBatis Plus的BaseMapper接口，提供基础的CRUD操作 import com.baomidou.mybatisplus.core.mapper.BaseMapper; - +// 引入活动日志实体类 import com.rabbiter.association.entity.ActiveLogs; /** - * 数据层处理接口 - * 报名记录 + * 数据访问层接口，用于处理与报名记录相关的数据库操作。 + * 继承自MyBatis Plus的BaseMapper，提供CRUD操作。 */ +// 使用@Repository注解标识该接口为Spring的一个Repository，并给其指定一个唯一的bean名称 @Repository("activeLogsDao") public interface ActiveLogsDao extends BaseMapper该类被标记为Spring组件（@Component），可通过自动注入（@Autowired）使用CacheManager。
*/ @Component("cacheHandle") public class CacheHandle { @Autowired - private CacheManager cacheManager; + private CacheManager cacheManager; // 自动注入CacheManager，用于操作缓存 - private final String USER_KEY = "users"; + private final String USER_KEY = "users"; // 缓存名称为"users" /** - * 获取用户缓存对象 - * @return + * 获取用户缓存对象。 + *通过CacheManager获取名为"users"的缓存对象。
+ * + * @return Cache对象，如果缓存不存在则返回null。 */ - public Cache getUserCache(){ - + public Cache getUserCache() { Cache cache = cacheManager.getCache(USER_KEY); - return cache; + return cache; } /** - * 存储登录用户信息 - * @param key 缓存用户 token - * @param val 登录用户 信息 + * 存储登录用户信息到缓存。 + *将登录用户信息与指定的key（通常是token）关联，并存储到缓存中。
+ * + * @param key 缓存用户token + * @param val 登录用户信息 */ public void addUserCache(String key, Object val) { + Cache cache = getUserCache(); // 获取用户缓存对象 - Cache cache = getUserCache(); - - cache.put(key, val); + cache.put(key, val); // 将用户信息存储到缓存 } /** - * 移除缓存登录用户信息 - * @param key 缓存用户 token + * 移除缓存中的登录用户信息。 + *根据指定的key（通常是token）从缓存中移除用户信息。
+ * + * @param key 缓存用户token */ - public void removeUserCache(String key){ - - Cache cache = getUserCache(); - - cache.evict(key); + public void removeUserCache(String key) { + Cache cache = getUserCache(); // 获取用户缓存对象 + cache.evict(key); // 从缓存中移除指定key的用户信息 } /** - * 获取缓存的登录用户信息 - * @param key 缓存用户 token - * @return + * 获取缓存的登录用户信息。 + *根据指定的key（通常是token）从缓存中获取用户信息。
+ * + * @param key 缓存用户token + * @return 缓存中的用户信息，如果未找到则返回null。 */ - public String getUserInfoCache(String key){ - - Cache cache = getUserCache(); - - String userId = cache.get(key, String.class); + public String getUserInfoCache(String key) { + Cache cache = getUserCache(); // 获取用户缓存对象 - return userId; + return cache.get(key, String.class); // 从缓存中获取指定key的用户信息 } -} +} \ No newline at end of file diff --git a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/handle/GlobalExceptionHandler.java b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/handle/GlobalExceptionHandler.java index e33cb2b..1ef7c60 100644 --- a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/handle/GlobalExceptionHandler.java +++ b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/handle/GlobalExceptionHandler.java @@ -6,31 +6,49 @@ import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ResponseBody; +/** + * 全局异常处理类。 + *使用@ControllerAdvice注解标记，表示该类作为全局异常处理器，会捕获并处理所有控制器中抛出的异常。
+ */ @ControllerAdvice public class GlobalExceptionHandler { + /** + * 异常处理方法，捕获所有类型的异常。 + *使用@ExceptionHandler注解标记，指定该方法处理Exception类型的异常。
+ *@ResponseBody注解表示该方法的返回值会作为响应体返回给客户端。
+ * + * @param e 捕获到的异常对象。 + * @return 包含错误信息和HTTP状态码的ResponseEntity对象。 + */ @ExceptionHandler(value = Exception.class) @ResponseBody public ResponseEntity+ * 此类封装了分页查询所需的所有信息，包括当前页码、每页数据量、总页数、符合条件的总记录数以及分页查询的结果集。 + *
+ */ public class PageData { - // 当前页码 + /** + * 当前页码。 + */ private Long pageIndex; - // 每页数据量 + /** + * 每页数据量。 + */ private Long pageSize; - // 查询的总页数 + /** + * 查询的总页数。 + * 根据总记录数和每页数据量计算得出。 + */ private Long pageTotal; - // 符合条件的总记录数 + /** + * 符合条件的总记录数。 + */ private Long count; - // 分页查询包含的结果集 + /** + * 分页查询包含的结果集。 + * 存储每条记录的字段映射。 + */ private List+ * 此类继承自 HashMap，用于存储键值对形式的响应数据。它定义了一组静态方法，用于快速创建包含特定响应码和消息的响应对象。 + *
*/ public class R extends HashMap+ * 此方法创建一个包含成功响应码和默认成功消息的响应对象。 + *
+ * + * @return 包含成功响应码和消息的响应对象。 */ - public static R success(){ - + public static R success() { R r = new R(); r.put("code", SUCCESS_CODE); r.put("msg", SUCCESS_MSG); @@ -38,13 +56,16 @@ public class R extends HashMap+ * 此方法创建一个包含成功响应码、指定消息和数据的响应对象。 + *
+ * + * @param msg 指定的消息。 + * @param data 指定的数据。 + * @return 包含成功响应码、指定消息和数据的响应对象。 */ - public static R success(String msg, Object data){ - + public static R success(String msg, Object data) { R r = new R(); r.put("code", SUCCESS_CODE); r.put("msg", msg); @@ -53,12 +74,15 @@ public class R extends HashMap+ * 此方法创建一个包含成功响应码和指定消息的响应对象。 + *
+ * + * @param msg 指定的消息。 + * @return 包含成功响应码和指定消息的响应对象。 */ - public static R successMsg(String msg){ - + public static R successMsg(String msg) { R r = new R(); r.put("code", SUCCESS_CODE); r.put("msg", msg); @@ -66,12 +90,15 @@ public class R extends HashMap+ * 此方法创建一个包含成功响应码、默认成功消息和指定数据的响应对象。 + *
+ * + * @param data 指定响应的数据。 + * @return 包含成功响应码、默认成功消息和指定数据的响应对象。 */ - public static R successData(Object data){ - + public static R successData(Object data) { R r = new R(); r.put("code", SUCCESS_CODE); r.put("msg", SUCCESS_MSG); @@ -80,11 +107,14 @@ public class R extends HashMap+ * 此方法创建一个包含预警响应码和默认预警消息的响应对象。 + *
+ * + * @return 包含预警响应码和默认预警消息的响应对象。 */ - public static R warn(){ - + public static R warn() { R r = new R(); r.put("code", WARN_CODE); r.put("msg", WARN_MSG); @@ -92,43 +122,49 @@ public class R extends HashMap+ * 此方法创建一个包含预警响应码和指定预警消息的响应对象。 + *
+ * + * @param msg 指定的信息。 + * @return 包含预警响应码和指定预警消息的响应对象。 */ - public static R warn(String msg){ - + public static R warn(String msg) { R r = new R(); r.put("code", WARN_CODE); r.put("msg", msg); - return r; } /** - * 系统异常，返回默认的异常信息 - * @return + * 创建系统异常并返回默认异常信息的响应信息。 + *+ * 此方法创建一个包含异常响应码和默认异常消息的响应对象。 + *
+ * + * @return 包含异常响应码和默认异常消息的响应对象。 */ - public static R error(){ - + public static R error() { R r = new R(); r.put("code", ERROR_CODE); r.put("msg", ERROR_MSG); - return r; } /** - * 系统异常，返回指定的异常信息 - * @param msg 异常信息 - * @return + * 创建系统异常并返回指定异常信息的响应信息。 + *+ * 此方法创建一个包含异常响应码和指定异常消息的响应对象。 + *
+ * + * @param msg 异常信息。 + * @return 包含异常响应码和指定异常消息的响应对象。 */ - public static R error(String msg){ - + public static R error(String msg) { R r = new R(); r.put("code", ERROR_CODE); r.put("msg", msg); - return r; } -} +} \ No newline at end of file diff --git a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/ActiveLogsService.java b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/ActiveLogsService.java index d5282d0..af506a1 100644 --- a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/ActiveLogsService.java +++ b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/ActiveLogsService.java @@ -1,29 +1,31 @@ package com.rabbiter.association.service; - import com.rabbiter.association.entity.ActiveLogs; - import java.util.List; import java.util.Map; /** - * 业务层处理 - * 报名记录 + * 业务层处理接口，负责管理活动报名记录。 + *该接口继承自BaseService接口，提供了针对ActiveLogs实体的基本操作。
*/ public interface ActiveLogsService extends BaseService通过查询数据库中的报名记录，判断指定用户是否已经报名参加了指定的活动。
+ * + * @param activeId 指定的活动ID + * @param userId 指定的用户ID + * @return 如果用户参与了活动，返回true；否则返回false。 */ public Boolean isActive(String activeId, String userId); /** - * 依据活动ID获取报名列表 + * 依据活动ID获取报名列表。 + *根据提供的活动ID，查询并返回所有报名参加该活动的用户的列表。
+ * * @param activeId 活动ID - * @return + * @return 返回一个包含报名信息的Map列表，每个Map代表一个报名记录，包含相关信息。 */ public List该接口继承自BaseService接口，提供了针对ApplyLogs实体的基本操作。
*/ public interface ApplyLogsService extends BaseService根据用户ID和团队ID，判断用户是否已经提交过申请，或者是否符合申请条件。
+ * * @param userId 用户ID * @param teamId 团队ID - * @return + * @return 如果用户可以提交申请，返回true；否则返回false。 */ public Boolean isApply(String userId, String teamId); /** - * 团队管理员分页查询申请记录信息 + * 团队管理员分页查询申请记录信息。 + *提供分页查询功能，团队管理员可以使用此方法查询申请记录，支持根据用户编号、团队名称和用户姓名进行筛选。
+ * * @param pageIndex 当前页码 * @param pageSize 每页数据量 * @param userId 用户编号 * @param teamName 团队名称 * @param userName 用户姓名 - * @return + * @return 返回一个PageData对象，包含分页的申请记录信息。 */ public PageData getManPageInfo(Long pageIndex, Long pageSize, String userId, String teamName, String userName); /** - * 分页查询申请记录信息 + * 分页查询申请记录信息。 + *提供分页查询功能，允许用户或管理员查询申请记录，支持根据用户编号、团队名称和用户姓名进行筛选。
+ * * @param pageIndex 当前页码 * @param pageSize 每页数据量 * @param userId 用户编号 * @param teamName 团队名称 * @param userName 用户姓名 - * @return + * @return 返回一个PageData对象，包含分页的申请记录信息。 */ public PageData getPageInfo(Long pageIndex, Long pageSize, String userId, String teamName, String userName); } \ No newline at end of file diff --git a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/impl/ApplyLogsServiceImpl.java b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/impl/ApplyLogsServiceImpl.java index b272584..3dac197 100644 --- a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/impl/ApplyLogsServiceImpl.java +++ b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/service/impl/ApplyLogsServiceImpl.java @@ -1,121 +1,144 @@ package com.rabbiter.association.service.impl; +// 导入MyBatis Plus的QueryWrapper，用于构建查询条件 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; +// 导入MyBatis Plus的分页插件 import com.baomidou.mybatisplus.extension.plugins.pagination.Page; +// 导入服务接口 +// 导入Spring的注解，用于声明服务和自动注入 import com.rabbiter.association.service.ApplyLogsService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; - +// 导入Spring的注解，用于声明事务 import org.springframework.transaction.annotation.Propagation; import org.springframework.transaction.annotation.Transactional; +// 导入DAO接口 import com.rabbiter.association.dao.MembersDao; import com.rabbiter.association.dao.TeamsDao; +import com.rabbiter.association.dao.ApplyLogsDao; +// 导入实体类 import com.rabbiter.association.entity.Members; import com.rabbiter.association.entity.Teams; -import com.rabbiter.association.msg.PageData; import com.rabbiter.association.entity.ApplyLogs; -import com.rabbiter.association.dao.ApplyLogsDao; +// 导入自定义的分页数据类 +import com.rabbiter.association.msg.PageData; +// 导入工具类 import com.rabbiter.association.utils.DateUtils; import com.rabbiter.association.utils.IDUtils; import java.util.Map; -@Service("applyLogsService") + +/** + * ApplyLogsService的服务实现类。 + */ +@Service("applyLogsService") // 声明该类为applyLogsService的实现 public class ApplyLogsServiceImpl implements ApplyLogsService { + // 自动注入MembersDao @Autowired private MembersDao membersDao; + // 自动注入ApplyLogsDao @Autowired private ApplyLogsDao applyLogsDao; + // 自动注入TeamsDao @Autowired private TeamsDao teamsDao; + /** + * 添加申请记录。 + */ @Override - @Transactional + @Transactional // 声明事务，确保操作的原子性 public void add(ApplyLogs applyLogs) { - - applyLogsDao.insert(applyLogs); + applyLogsDao.insert(applyLogs); // 插入申请记录 } + /** + * 更新申请记录。 + * 如果申请通过，则创建成员记录并更新团队人数。 + */ @Override - @Transactional + @Transactional // 声明事务 public void update(ApplyLogs applyLogs) { - - if(applyLogs.getStatus() != null && applyLogs.getStatus() == 1){ - - Members member = new Members(); - member.setId(IDUtils.makeIDByCurrent()); - member.setCreateTime(DateUtils.getNowDate()); - member.setUserId(applyLogs.getUserId()); - member.setTeamId(applyLogs.getTeamId()); - - membersDao.insert(member); - - Teams teams = teamsDao.selectById(applyLogs.getTeamId()); - teams.setTotal(teams.getTotal() + 1); - teamsDao.updateById(teams); + if(applyLogs.getStatus() != null && applyLogs.getStatus() == 1){ // 如果申请通过 + Members member = new Members(); // 创建成员记录 + member.setId(IDUtils.makeIDByCurrent()); // 生成成员ID + member.setCreateTime(DateUtils.getNowDate()); // 设置创建时间 + member.setUserId(applyLogs.getUserId()); // 设置用户ID + member.setTeamId(applyLogs.getTeamId()); // 设置团队ID + + membersDao.insert(member); // 插入成员记录 + + Teams teams = teamsDao.selectById(applyLogs.getTeamId()); // 根据ID查询团队 + teams.setTotal(teams.getTotal() + 1); // 增加团队人数 + teamsDao.updateById(teams); // 更新团队信息 } - applyLogsDao.updateById(applyLogs); + applyLogsDao.updateById(applyLogs); // 更新申请记录 } + /** + * 删除申请记录。 + */ @Override - @Transactional + @Transactional // 声明事务 public void delete(ApplyLogs applyLogs) { - - applyLogsDao.deleteById(applyLogs); + applyLogsDao.deleteById(applyLogs); // 根据ID删除申请记录 } + /** + * 检查用户是否已对团队提交申请。 + * 如果未提交申请返回true，否则返回false。 + */ @Override - @Transactional(readOnly = true, propagation = Propagation.SUPPORTS) + @Transactional(readOnly = true, propagation = Propagation.SUPPORTS) // 声明只读事务 public Boolean isApply(String userId, String teamId){ + QueryWrapperUUID（Universally Unique Identifier）是一种软件构建时生成的唯一标识符。 + * 标准形式的UUID是由32个16进制数字组成的字符串，以连字符分为五组，形式为8-4-4-4-12。 + * 该方法生成的ID去掉了连字符，因此长度为32位。
+ * + * @return 32位的UUID字符串。 */ public static String makeIDByUUID() { - - String id = UUID.randomUUID().toString().replaceAll("-",""); - + // 生成一个随机的UUID + String id = UUID.randomUUID().toString(); + // 将UUID中的连字符去掉，返回一个没有连字符的32位字符串 + id = id.replaceAll("-", ""); return id; } - + /** - * 使用时间戳生成ID, 13位 - * @return + * 使用当前时间戳生成13位ID。 + *该方法基于当前的系统时间（毫秒值）生成一个ID，由于时间戳的精度是毫秒， + * 因此生成的ID具有很高的唯一性，但不会超过13位。
+ * + * @return 13位的当前时间戳字符串。 */ public static String makeIDByCurrent() { - + // 调用DateUtils工具类的getCurrent()方法获取当前时间的毫秒值 Long mills = DateUtils.getCurrent(); - + // 将时间戳的Long值转换为String，并返回 return mills.toString(); } -} +} \ No newline at end of file diff --git a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/utils/StringUtils.java b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/utils/StringUtils.java index 4841811..6715d98 100644 --- a/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/utils/StringUtils.java +++ b/springboota009社团管理系统/代码/AssociationManagerApi - idea/src/main/java/com/rabbiter/association/utils/StringUtils.java @@ -4,101 +4,94 @@ import java.util.regex.Matcher; import java.util.regex.Pattern; /** - * 字符串处理工具类 + * 字符串处理工具类，提供了一系列静态方法来处理字符串，包括检查字符串是否为空、是否包含特定字符等。 */ public class StringUtils { - - /** - * 检查指定的字符串是否为 NUll - * 返回true，指定的字符串是 NULL - * 返回false，指定的字符串不是 NULL + + /** + * 检查指定的字符串是否为 NULL。 + * 如果字符串为 NULL，则返回 true；否则返回 false。 + * * @param str 要检查的字符串 - * @return + * @return true 如果字符串为 NULL，false 否则 */ - public static Boolean isNull(String str){ - - if(str == null){ - + public static Boolean isNull(String str) { + if (str == null) { return true; } - return false; } /** - * 检查指定的字符串是否不为 NUll - * 返回true，指定的字符串不为 NULL - * 返回false，指定的字符串是 NULL + * 检查指定的字符串是否不为 NULL。 + * 如果字符串不为 NULL，则返回 true；否则返回 false。 + * * @param str 要检查的字符串 - * @return + * @return true 如果字符串不为 NULL，false 否则 */ - public static Boolean isNotNull(String str){ - + public static Boolean isNotNull(String str) { + // 直接利用 isNull 方法的结果取反 Boolean flag = !isNull(str); - return flag; } /** - * 检查指定的字符串是否为 NULL 或者空字符串 - * 返回true，指定的字符串是 NULL 或者空字符串 - * 返回 false，指定的字符串不是 NULL 或者空字符粗 + * 检查指定的字符串是否为 NULL 或者空字符串。 + * 如果字符串为 NULL 或者空字符串，则返回 true；否则返回 false。 + * * @param str 要检查的字符串 - * @return + * @return true 如果字符串为 NULL 或者空字符串，false 否则 */ - public static Boolean isNullOrEmpty(String str){ - - if(str == null){ - + public static Boolean isNullOrEmpty(String str) { + // 先检查字符串是否为 NULL，如果是，则返回 true + if (str == null) { return true; } - - if(str.length() <= 0){ - + // 再检查字符串长度是否为 0，如果是，则返回 true + if (str.length() <= 0) { return true; } - return false; } /** - * 检查指定的字符串是否不为 NULL 或者空字符串 - * 返回true，指定的字符串不是 NULL 或者空字符串 - * 返回 false，指定的字符串是 NULL 或者空字符粗 - * @param str - * @return + * 检查指定的字符串是否不为 NULL 或者空字符串。 + * 如果字符串不为 NULL 且不为空字符串，则返回 true；否则返回 false。 + * + * @param str 要检查的字符串 + * @return true 如果字符串不为 NULL 且不为空字符串，false 否则 */ - public static Boolean isNotNullOrEmpty(String str){ - + public static Boolean isNotNullOrEmpty(String str) { + // 直接利用 isNullOrEmpty 方法的结果取反 Boolean flag = !isNullOrEmpty(str); - return flag; } - + /** - * 检查指定的字符串中 - * @param str 要检查的字符串 - * @param flag 指定的字符串 - * @return - */ - public static boolean isExit(String str, String flag) { - - if(str.indexOf(flag) > 0) { - - return false; - } - - return true; - } - + * 检查指定的字符串中是否包含特定的字符或子字符串。 + * 如果字符串中包含指定的字符或子字符串，则返回 false；否则返回 true。 + * + * @param str 要检查的字符串 + * @param flag 要检查的特定字符或子字符串 + * @return true 如果字符串中不包含指定的字符或子字符串，false 否则 + */ + public static boolean isExit(String str, String flag) { + // 使用 indexOf 方法检查字符串中是否包含指定的字符或子字符串 + if (str.indexOf(flag) > 0) { + return false; + } + return true; + } + /** - * 获取字符串的长度 - * 如果字符串是 null，返回 0 - * @param str - * @return - */ - public static int length(String str) { - - return str == null ? 0 : str.length(); - } -} + * 获取字符串的长度。 + * 如果字符串为 null，则返回 0；否则返回字符串的实际长度。 + * + * @param str 要获取长度的字符串 + * @return 字符串的长度，如果字符串为 null，则返回 0 + */ + public static int length(String str) { + // 使用三元运算符简化代码 + return str == null ? 0 : str.length(); + } +} \ No newline at end of file diff --git a/springboota009社团管理系统/代码/AssociationManagerVue/src/views/pages/ActiveLogs.vue b/springboota009社团管理系统/代码/AssociationManagerVue/src/views/pages/ActiveLogs.vue index 610e0ff..eaa0b81 100644 --- a/springboota009社团管理系统/代码/AssociationManagerVue/src/views/pages/ActiveLogs.vue +++ b/springboota009社团管理系统/代码/AssociationManagerVue/src/views/pages/ActiveLogs.vue @@ -1,6 +1,9 @@ +