上传

src/main/java/com/jiudian/manage/config/CustomMVCConfiguration.java

@@ -1,5 +1,5 @@
 package com.jiudian.manage.config;
-
+//// 导入Spring相关注解和类
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.http.converter.HttpMessageConverter;
@@ -9,11 +9,16 @@ import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter
 
 import java.nio.charset.Charset;
 import java.util.List;
-//
+
+// * 自定义MVC配置类
+// * 用于配置HTTP消息转换和内容协商，解决中文乱码问题
+// */
 @Configuration
 public class CustomMVCConfiguration extends WebMvcConfigurerAdapter {
-
+    //创建并配置String类型的HTTP消息转换器
     @Bean
+    // 声明这是一个Bean，会被Spring容器管理
+    // 创建字符串消息转换器，设置字符集为UTF-8
     public HttpMessageConverter<String> responseBodyConverter() {
         StringHttpMessageConverter converter = new StringHttpMessageConverter(
                 Charset.forName("UTF-8"));
@@ -24,7 +29,9 @@ public class CustomMVCConfiguration extends WebMvcConfigurerAdapter {
     public void configureMessageConverters(
             List<HttpMessageConverter<?>> converters) {
         super.configureMessageConverters(converters);
+        // 先调用父类方法，保留默认的转换器配置
         converters.add(responseBodyConverter());
+       // 添加我们自定义的字符串转换器
     }
 
     @Override
@@ -32,4 +39,6 @@ public class CustomMVCConfiguration extends WebMvcConfigurerAdapter {
             ContentNegotiationConfigurer configurer) {
         configurer.favorPathExtension(false);
     }
-}
+}
+// 禁用基于URL路径扩展名的内容协商
+// 例如：/api/users.json 或 /api/users.xml 这样的URL将不再生效

src/main/java/com/jiudian/manage/controller/ConfigController.java

@@ -10,26 +10,34 @@ import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.Map;
-//
-@RestController
-@RequestMapping(value = "/config")
+///**
+// * 配置管理控制器
+// * 处理与系统配置相关的HTTP请求
+// */
+@RestController //标记此类为REST控制器，所有方法返回JSON格式数据
+@RequestMapping(value = "/config") //定义基础URL路径
 public class ConfigController {
+    //自动注入ConfigService服务,依赖注入
     @Autowired
     ConfigService configService;
 
     /**
-     *
-     * @return
+     * 获取系统配置信息
+     * @return 包含配置信息的Map对象
      */
-    @RequestMapping(value = "/getConfig.do")
+    @RequestMapping(value = "/getConfig.do") //定义具体的URL路径
     public Map getConfig(){
+        // 调用服务层获取配置信息
         Config config = configService.get();
+        // 创建状态信号对象，用于统一返回格式
         StateSignal signal = new StateSignal();
         if(config!=null){
+            // 配置存在，返回成功状态和配置数据
             signal.put(State.SuccessCode);
             signal.put(State.SuccessMessage);
             signal.put("config",config);
         }else {
+            // 配置不存在，返回错误状态
             signal.put(State.ErrorCode);
             signal.put(State.ErrorMessage);
         }
@@ -48,11 +56,14 @@ public class ConfigController {
      * @param totalroom     总卖出房数
      * @return
      */
-    @RequestMapping(value = "/updateConfig.do")
+    @RequestMapping(value = "/updateConfig.do")//// 定义具体的URL路径
     public Map updateConfig(@RequestParam double managesalary,@RequestParam double  staffsalary,@RequestParam double cleanerssalary,@RequestParam double manage,@RequestParam double staff,@RequestParam double cleaner,@RequestParam(required = false,defaultValue = "-1") double totalmoney,@RequestParam(required = false,defaultValue = "-1") double totalroom){
+        // 调用服务层执行更新操作
         boolean update = configService.update(managesalary, staffsalary, cleanerssalary, manage, staff, cleaner, totalmoney, totalroom);
+        // 创建状态信号对象
         StateSignal signal = new StateSignal();
         if(update){
+            // 更新成功
             signal.put(State.SuccessCode);
             signal.put(State.SuccessMessage);
         }else {

src/main/java/com/jiudian/manage/controller/FileController.java

@@ -16,26 +16,37 @@ import java.io.FileOutputStream;
 import java.util.Map;
 import java.util.Random;
 import java.util.UUID;
-
-@RestController
+/**
+ * 文件上传控制器
+ * 主要处理用户头像上传功能
+ */
+@RestController //标记为REST控制器，返回JSON格式数据
 @RequestMapping(value = "/upFile")
 public class FileController {
+    // 自动注入UserService服务
     @Autowired
     UserService userService;
-//z
+
     @RequestMapping("/upFilePhoto.do")
     public Map upFilePhoto(@RequestParam MultipartFile file,@RequestParam int userid){
+        //接受上传文件和用户Id
+        // 生成唯一的文件名，避免文件名冲突
+        // 使用UUID+原始文件名
         String fileName = UUID.randomUUID().toString()+file.getOriginalFilename();
-
+//定义文件保存路径
+        // 本地保存路径：项目资源目录下的static/File文件夹
         String filePath = ".\\src\\main\\resources\\static\\File\\";
         String RealfilePath = "File"+"/"+fileName;
+        // 更新用户头像路径到数据库
         boolean photo = userService.photo(userid, RealfilePath);
         boolean b = false;
         try {
            b = FileUtil.uploadFile(file.getBytes(), filePath, fileName);
         } catch (Exception e) {
+            // 捕获并打印异常信息
             e.printStackTrace();
         }
+        // 创建状态信号对象，封装 API 接口，用于统一JSON回格式
         StateSignal signal = new StateSignal();
         if(b&&photo){
             signal.put(State.SuccessCode);

src/main/java/com/jiudian/manage/controller/OrderController.java

@@ -12,13 +12,17 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 import java.util.Map;
-
+/**
+ * 订单管理控制器
+ * 处理酒店预订系统中的订单相关操作
+ * 这个控制器实现了酒店订单管理的核心功能，包括创建、删除、更新和查询订单
+ */
 @RestController
 @RequestMapping(value = "/order")
 public class OrderController {
     @Autowired
     OrderServiceImpl orderService;
-//
+//: 自动注入订单服务实现类
     /**
      * 添加订单
      * @param householdname 入住人姓名
@@ -29,11 +33,14 @@ public class OrderController {
      * @param userid        用户id
      * @return
      */
+    //Spring MVC 中的一个注解，用于将 HTTP 请求映射到控制器的处理方法上
     @RequestMapping("/addOrder.do")
     public Map addOrder(@RequestParam String householdname,@RequestParam String id,@RequestParam String starttime,@RequestParam String endtime,@RequestParam int roomid,@RequestParam int userid){
+        // 调用服务层添加订单
         boolean b = orderService.addOrder(householdname, id, starttime, endtime, roomid, userid);
         StateSignal signal = new StateSignal();
         if(b){
+            //添加成功
             signal.put(State.SuccessCode);
             signal.put(State.SuccessMessage);
         }else {
@@ -70,6 +77,7 @@ public class OrderController {
      */
     @RequestMapping("/updateOrderState.do")
     public Map updateOrderState(@RequestParam int orderid,@RequestParam int state){
+        // 调用服务层更新订单状态
         boolean b = orderService.updateOrderState(orderid, state);
         StateSignal signal = new StateSignal();
         if(b){
@@ -81,9 +89,18 @@ public class OrderController {
         }
         return  signal.getResult();
     }
+    /**
+     * 获取所有订单（分页查询）
+     *
+     * @param pageNum 页码
+     * @param pageSize 每页记录数
+     * @return 包含订单列表和分页信息的Map对象
+     */
 
     @RequestMapping("/getAllOrder.do")
     public Map getAllOrder(@RequestParam int pageNum,@RequestParam int pageSize){
+
+// 调用服务层获取订单列表
         List<Order> allOrder = orderService.getAllOrder(pageNum, pageSize);
         StateSignal signal = new StateSignal();
         if(allOrder!=null){

src/main/java/com/jiudian/manage/controller/RoomController.java

@@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 import java.util.Map;
-
+//这个控制器实现了酒店房间管理的完整功能，包括添加、删除、查询和更新房间信息。
 @RestController
 @RequestMapping(value = "/room")
 public class RoomController {
@@ -58,7 +58,7 @@ public class RoomController {
         }
         return  signal.getResult();
     }
-
+//更新房间信息
     @RequestMapping("/updateRoom.do")
     public Map updateRoom(@RequestParam int roomid,@RequestParam(required = false,defaultValue = "null") String local,@RequestParam(required = false,defaultValue = "-1") double money,@RequestParam(required = false,defaultValue = "-1") int state,@RequestParam(required = false,defaultValue = "-1") int type){
         boolean b = roomService.updateRoom(roomid, local, money, state, type);
@@ -72,6 +72,7 @@ public class RoomController {
         }
         return  signal.getResult();
     }
+    //根据ID查询房间详情
     @RequestMapping("/getRoomById.do")
     public Map getRoomById(@RequestParam int roomid){
         Room b = roomService.getRoomById(roomid);

src/main/java/com/jiudian/manage/controller/UserController.java

@@ -16,15 +16,16 @@ import javax.servlet.http.HttpSession;
 import java.io.IOException;
 import java.util.List;
 import java.util.Map;
-
+//这个控制器实现了完整的用户管理功能，包括 验证码认证、授权.登录、注册、信息管理操作
 @RestController
 @RequestMapping(value = "/user")
 public class UserController {
+    // 自动注入用户服务实现类
     @Autowired
     UserServiceImpl userService;
 
     /**
-     * 登录(已测试)
+     * 登录
      * @param useraccount
      * @param password
      * @return
@@ -32,9 +33,11 @@ public class UserController {
     @RequestMapping(value = "/login.do")
     public Map login(@RequestParam String useraccount, @RequestParam String password,@RequestParam String icode,HttpSession session){
         StateSignal signal = new StateSignal();
+        // 验证验证码
         String code = (String) session.getAttribute(ImageCode.CODENAME);
         System.out.println("session: "+code+"   实际"+icode);
         if(icode!=null&&code!=null&&icode.equals(code)){
+            // 调用服务层进行登录验证
             int[] login = userService.login(useraccount, password);
             if(login!=null){
                 signal.put(State.SuccessCode);
@@ -51,9 +54,17 @@ public class UserController {
         }
         return signal.getResult();
     }
-
+    /**
+     * 生成验证码图片
+     *
+     * @param code 验证码
+     * @param response HTTP响应对象
+     * @param session HTTP会话对象
+     * @throws IOException IO异常
+     */
     @GetMapping("/createImage")
     public void createImage(@RequestParam String code, HttpServletResponse response, HttpSession session) throws IOException {
+        // 调用工具类生成验证码图片
         ImageCode.createImage(response,session);
     }
 
@@ -66,6 +77,7 @@ public class UserController {
      */
     @RequestMapping(value = "/addUser.do")
     public Map addUser(@RequestParam String useraccount, @RequestParam String password, @RequestParam String power){
+        // 调用服务层添加用户
         boolean add = userService.addUser(useraccount,password,Integer.parseInt(power));
         StateSignal signal = new StateSignal();
         if(add){
@@ -79,7 +91,7 @@ public class UserController {
     }
 
     /**
-     * 修改用户数据(已测试)
+     * 修改用户数据
      * @param userid
      * @param password
      * @param username
@@ -90,6 +102,7 @@ public class UserController {
      */
     @RequestMapping(value = "/updateUser.do")
     public Map updateUser(@RequestParam int userid,@RequestParam(required = false,defaultValue = "null") String password,@RequestParam(required = false,defaultValue = "null") String username,@RequestParam(required = false,defaultValue = "-1") int age,@RequestParam(required = false,defaultValue = "-1") int power,@RequestParam(required = false,defaultValue = "null") String IDnumber,@RequestParam(required = false,defaultValue = "null") String phonenumber){
+        // 调用服务层更新用户信息
         boolean upd = userService.alterUser(userid, password, username, age, power, IDnumber,phonenumber);
         StateSignal signal = new StateSignal();
         if(upd){