注释 ytt

minsu/minsuguanliw/src/main/java/com/controller/UsersController.java

@@ -149,8 +149,8 @@ public class UsersController {
  * @param user 包含用户相关信息的UsersEntity对象，可能用于进一步构建查询条件，比如根据用户对象中的某些属性来筛选特定用户数据等，具体取决于业务逻辑和相关工具类（如MPUtil）的使用方式。
  * @return R对象，封装了操作结果及相关数据，成功时包含分页后的用户数据列表信息（通过PageUtils对象承载）。
  */
-@RequestMapping("/page")
-public R page(@RequestParam Map<String, Object> params, UsersEntity user) {
+	@RequestMapping("/page")
+	public R page(@RequestParam Map<String, Object> params, UsersEntity user) {
 	// 创建一个EntityWrapper对象，用于构建数据库查询条件，它可以方便地拼接各种查询条件语句，例如等于、大于、小于等条件，初始时为空，后续会根据业务逻辑添加相应条件。
 	EntityWrapper<UsersEntity> ew = new EntityWrapper<UsersEntity>();
 	// 调用用户服务层的queryPage方法进行分页查询，传入params参数用于分页相关设置以及通过MPUtil相关工具方法构建的查询条件。

minsu/minsuguanliw/src/main/java/com/controller/YonghuController.java

@@ -106,6 +106,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，如会话中的用户角色等
      * @return R对象，封装了操作结果及相关数据，成功时包含用户详细信息
      */
+
     @RequestMapping("/info/{id}")
     public R info(@PathVariable("id") Long id, HttpServletRequest request){
         logger.debug("info方法:,,Controller:{},,id:{}",this.getClass().getName(),id);
@@ -135,6 +136,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，如会话中的用户角色等
      * @return R对象，封装了操作结果，成功表示保存成功，失败则提示账户或者手机号已经被使用等错误信息
      */
+
     @RequestMapping("/save")
     public R save(@RequestBody YonghuEntity yonghu, HttpServletRequest request){
         logger.debug("save方法:,,Controller:{},,yonghu:{}",this.getClass().getName(),yonghu.toString());
@@ -177,6 +179,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，如会话中的用户角色等
      * @return R对象，封装了操作结果，成功表示更新成功，失败则提示账户或者手机号已经被使用等错误信息
      */
+
     @RequestMapping("/update")
     public R update(@RequestBody YonghuEntity yonghu, HttpServletRequest request){
         logger.debug("update方法:,,Controller:{},,yonghu:{}",this.getClass().getName(),yonghu.toString());
@@ -217,6 +220,7 @@ public class YonghuController {
      * @param ids 包含要删除的用户ID的整数数组，通过请求体传入
      * @return R对象，封装了操作结果，成功表示删除操作执行成功（实际只是更新了逻辑删除标识）
      */
+
     @RequestMapping("/delete")
     public R delete(@RequestBody Integer[] ids){
         logger.debug("delete:,,Controller:{},,ids:{}",this.getClass().getName(),ids.toString());
@@ -241,6 +245,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，如当前用户ID等
      * @return R对象，封装了操作结果，成功表示批量插入成功，失败则提示各种错误信息，如文件格式错误、数据重复、插入异常等
      */
+
     @RequestMapping("/batchInsert")
     public R save( String fileName, HttpServletRequest request){
         logger.debug("batchInsert方法:,,Controller:{},,fileName:{}",this.getClass().getName(),fileName);
@@ -360,6 +365,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息
      * @return R对象，封装了操作结果及相关数据，成功时包含用户登录后的Token、角色、用户名、所属表名、用户ID等信息，失败则返回相应错误提示
      */
+
     @IgnoreAuth // 该注解可能表示此登录接口不需要进行权限认证（具体取决于该注解的实际定义和功能）
     @RequestMapping(value = "/login")
     public R login(String username, String password, String captcha, HttpServletRequest request) {
@@ -400,6 +406,7 @@ public class YonghuController {
      * @param yonghu 包含用户注册信息的YonghuEntity对象，通过请求体传入（通常是前端提交的注册表单数据等）
      * @return R对象，封装了操作结果，成功表示注册成功，失败则提示账户或者手机号已经被使用的错误信息
      */
+
     @IgnoreAuth // 该注解可能表示此注册接口不需要进行权限认证（具体取决于该注解的实际定义和功能）
     @PostMapping(value = "/register")
     public R register(@RequestBody YonghuEntity yonghu) {
@@ -434,6 +441,7 @@ public class YonghuController {
      * @param id 用户的唯一标识（通常是数据库中的主键ID），从请求参数中获取
      * @return R对象，封装了操作结果，成功表示密码重置成功
      */
+
     @GetMapping(value = "/resetPassword")
     public R resetPassword(Integer id) {
         YonghuEntity yonghu = new YonghuEntity();
@@ -454,6 +462,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，但在当前方法中未体现更多相关使用情况
      * @return R对象，封装了操作结果，成功表示密码重置成功，若用户不存在则返回账号不存在的错误信息，若更新数据库操作失败则返回相应错误信息
      */
+
     @IgnoreAuth
     @RequestMapping(value = "/resetPass")
     public R resetPass(String username, HttpServletRequest request) {
@@ -484,6 +493,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，重点是从中获取会话中的用户ID
      * @return R对象，封装了操作结果及相关数据，成功时包含经过转换后的用户视图信息，若查不到数据则返回相应错误信息
      */
+
     @RequestMapping("/session")
     public R getCurrYonghu(HttpServletRequest request) {
         // 从当前请求的会话中获取名为“userId”的属性值，并转换为整数类型，该值作为用户的唯一标识，用于后续查询用户信息
@@ -513,6 +523,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，重点是操作其对应的会话对象
      * @return R对象，封装了操作结果及相关提示信息，这里返回退出成功的提示
      */
+
     @GetMapping(value = "logout")
     public R logout(HttpServletRequest request) {
         // 调用HttpServletRequest对象的invalidate方法使当前会话失效，即清除会话中存储的用户登录等相关信息
@@ -530,6 +541,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，比如可能用于后续字典表数据转换等操作获取相关上下文信息，但当前代码中未体现更多复杂使用情况。
      * @return R对象，封装了操作结果及相关数据，成功时包含分页后的用户数据列表（已经过字典表数据转换）。
      */
+
     @IgnoreAuth
     @RequestMapping("/list")
     public R list(@RequestParam Map<String, Object> params, HttpServletRequest request) {
@@ -558,6 +570,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，如在字典表数据转换时可能需要的一些上下文信息等，但当前代码中未体现更多复杂使用情况。
      * @return R对象，封装了操作结果及相关数据，成功时包含经过转换后的用户详细信息，若未查询到对应的数据则返回查不到数据的错误提示。
      */
+
     @RequestMapping("/detail/{id}")
     public R detail(@PathVariable("id") Long id, HttpServletRequest request) {
         logger.debug("detail方法:,,Controller:{},,id:{}", this.getClass().getName(), id);
@@ -587,6 +600,7 @@ public class YonghuController {
      * @param request HttpServletRequest对象，用于获取当前请求相关的信息，当前代码中主要用于日志记录展示请求相关信息，但未体现更多复杂使用情况。
      * @return R对象，封装了操作结果，成功表示保存成功，失败则提示账户或者手机号已经被使用的错误信息。
      */
+
     @RequestMapping("/add")
     public R add(@RequestBody YonghuEntity yonghu, HttpServletRequest request) {
         logger.debug("add方法:,,Controller:{},,yonghu:{}", this.getClass().getName(), yonghu.toString());

minsu/minsuguanliw/src/main/java/com/entity/YonghuEntity.java

@@ -335,5 +335,60 @@ public class YonghuEntity<T> implements Serializable {
         return yonghuDelete;
     }
 
-/**
- * 设置：假
+    /**
+     * 获取：假删
+     * 这是一个按照JavaBean规范定义的公共访问方法（getter方法），用于获取“假删”字段的值。
+     * 在业务逻辑中，其他类可以通过调用此方法来知晓当前对象所代表的用户数据是否处于被标记为删除的状态（具体取决于“假删”字段值的定义规则，例如通常可能用特定数字表示删除与否）。
+     * @return 返回存储的“假删”字段整数值，代表用户数据的删除标记状态。
+     */
+
+    public void setYonghuDelete(Integer yonghuDelete) {
+        this.yonghuDelete = yonghuDelete;
+    }
+
+    /**
+     * 获取：创建时间
+     * 此为获取“创建时间”字段值的公共访问方法（getter方法），遵循JavaBean规范。
+     * 在许多业务场景中，例如按照创建时间对用户数据进行排序、查询某个时间段内创建的用户等操作时，其他类可以调用该方法来获取用户数据在系统中最初被创建的具体时间点信息，
+     * 返回的是一个Date类型的对象，表示具体的时间值，并且该时间值的格式等相关处理可能受到类中定义的 @JsonFormat 和 @DateTimeFormat 等注解影响（若存在对应使用场景）。
+     * @return 返回存储的“创建时间”Date对象，即代表用户数据被创建时的时间信息。
+     */
+    public Date getCreateTime() {
+        return createTime;
+    }
+
+    /**
+     * 设置：创建时间
+     * 按照JavaBean规范定义的用于设置“创建时间”字段值的公共设置方法（setter方法）。
+     * 在创建用户对象或者从数据库查询数据后填充对象等场景下，可调用该方法来更新用户对象的“创建时间”字段内容，
+     * 要注意传入的时间值需符合 @DateTimeFormat 注解定义的格式要求（如果有相应的反序列化处理逻辑），以保证数据能正确绑定到该字段上，确保时间数据的准确性和一致性。
+     * @param createTime 要设置的“创建时间”Date对象，用于更新当前对象的“创建时间”字段内容。
+     */
+    public void setCreateTime(Date createTime) {
+        this.createTime = createTime;
+    }
+
+    /**
+     * 重写toString方法
+     * toString方法在Java中用于将对象以字符串的形式表示出来，方便在调试、日志记录以及一些需要直观展示对象内容的场景下使用。
+     * 这里重写了该方法，按照自定义的格式将对象中的各个重要属性（包括主键、用户名、密码、用户姓名、头像、手机号、电子邮箱、性别、余额、假删状态、创建时间等）拼接成一个字符串返回，
+     * 使得在查看该对象的字符串表示时，能够清晰地了解对象内部各关键属性的具体值情况，便于开发人员快速知晓对象的状态信息。
+     * @return 返回一个包含对象关键属性信息的字符串，格式为 "Yonghu{" + 各属性键值对拼接 + "}"，其中属性值按照实际存储的值进行展示。
+     */
+    @Override
+    public String toString() {
+        return "Yonghu{" +
+                "id=" + id +
+                ", username=" + username +
+                ", password=" + password +
+                ", yonghuName=" + yonghuName +
+                ", yonghuPhoto=" + yonghuPhoto +
+                ", yonghuPhone=" + yonghuPhone +
+                ", yonghuEmail=" + yonghuEmail +
+                ", sexTypes=" + sexTypes +
+                ", newMoney=" + newMoney +
+                ", yonghuDelete=" + yonghuDelete +
+                ", createTime=" + createTime +
+                "}";
+    }
+}