diff --git a/src/main/java/com/yeqifu/bus/controller/CustomerController.java b/src/main/java/com/yeqifu/bus/controller/CustomerController.java
index 87057bc..30bc178 100644
--- a/src/main/java/com/yeqifu/bus/controller/CustomerController.java
+++ b/src/main/java/com/yeqifu/bus/controller/CustomerController.java
@@ -1,25 +1,24 @@
-package com.yeqifu.bus.controller;
+package com.yeqifu.bus.controller; // 定义包路径
+import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入查询包装器类
+import com.baomidou.mybatisplus.core.metadata.IPage; // 导入分页接口
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入分页实现类
+import com.yeqifu.bus.entity.Customer; // 导入客户实体类
+import com.yeqifu.bus.service.ICustomerService; // 导入客户服务接口
+import com.yeqifu.bus.vo.CustomerVo; // 导入客户视图对象
+import com.yeqifu.sys.common.Constast; // 导入常量类
+import com.yeqifu.sys.common.DataGridView; // 导入数据网格返回类
+import com.yeqifu.sys.common.ResultObj; // 导入结果对象类
+import io.swagger.annotations.ApiImplicitParam; // 导入Swagger参数注解
+import io.swagger.annotations.ApiImplicitParams; // 导入Swagger参数列表注解
+import io.swagger.annotations.ApiOperation; // 导入Swagger操作注解
+import org.apache.commons.lang3.StringUtils; // 导入字符串工具类
+import org.springframework.beans.factory.annotation.Autowired; // 导入Spring的依赖注入注解
+import org.springframework.web.bind.annotation.RequestMapping; // 导入请求映射注解
+import org.springframework.web.bind.annotation.RequestMethod; // 导入请求方法注解
+import org.springframework.web.bind.annotation.RestController; // 导入控制器注解
-import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
-import com.baomidou.mybatisplus.core.metadata.IPage;
-import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
-import com.yeqifu.bus.entity.Customer;
-import com.yeqifu.bus.service.ICustomerService;
-import com.yeqifu.bus.vo.CustomerVo;
-import com.yeqifu.sys.common.Constast;
-import com.yeqifu.sys.common.DataGridView;
-import com.yeqifu.sys.common.ResultObj;
-import io.swagger.annotations.ApiImplicitParam;
-import io.swagger.annotations.ApiImplicitParams;
-import io.swagger.annotations.ApiOperation;
-import org.apache.commons.lang3.StringUtils;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestMethod;
-import org.springframework.web.bind.annotation.RestController;
-
-import java.util.List;
+import java.util.List; // 导入列表类
/**
*
@@ -29,29 +28,27 @@ import java.util.List;
* @author luoyi-
* @since 2019-12-05
*/
-@RestController
-@RequestMapping("/customer")
+@RestController // 标注为REST控制器
+@RequestMapping("/customer") // 设置请求路径为/customer
public class CustomerController {
- @Autowired
- private ICustomerService customerService;
+ @Autowired // 自动注入客户服务接口实现类
+ private ICustomerService customerService; // 定义客户服务接口实例
/**
* 查询所有的客户
* @param customerVo
* @return
*/
- @RequestMapping("loadAllCustomer")
- public DataGridView loadAllCustomer(CustomerVo customerVo){
- //1.声明分页page对象
- IPage page = new Page(customerVo.getPage(),customerVo.getLimit());
- //2.声明queryWrapper
- QueryWrapper queryWrapper = new QueryWrapper();
- queryWrapper.like(StringUtils.isNotBlank(customerVo.getCustomername()),"customername",customerVo.getCustomername());
- queryWrapper.like(StringUtils.isNotBlank(customerVo.getConnectionpersion()),"connectionpersion",customerVo.getConnectionpersion());
- queryWrapper.like(StringUtils.isNotBlank(customerVo.getPhone()),"phone",customerVo.getPhone());
- customerService.page(page,queryWrapper);
- return new DataGridView(page.getTotal(),page.getRecords());
+ @RequestMapping("loadAllCustomer") // 映射路径为/loadAllCustomer
+ public DataGridView loadAllCustomer(CustomerVo customerVo){ // 查询所有客户方法
+ IPage page = new Page(customerVo.getPage(),customerVo.getLimit()); // 声明分页对象
+ QueryWrapper queryWrapper = new QueryWrapper(); // 声明查询包装器
+ queryWrapper.like(StringUtils.isNotBlank(customerVo.getCustomername()),"customername",customerVo.getCustomername()); // 根据客户名模糊查询
+ queryWrapper.like(StringUtils.isNotBlank(customerVo.getConnectionpersion()),"connectionpersion",customerVo.getConnectionpersion()); // 根据联系人模糊查询
+ queryWrapper.like(StringUtils.isNotBlank(customerVo.getPhone()),"phone",customerVo.getPhone()); // 根据手机号模糊查询
+ customerService.page(page,queryWrapper); // 调用分页查询服务
+ return new DataGridView(page.getTotal(),page.getRecords()); // 返回分页数据
}
/**
@@ -59,14 +56,14 @@ public class CustomerController {
* @param customerVo
* @return
*/
- @RequestMapping("addCustomer")
- public ResultObj addCustomer(CustomerVo customerVo){
+ @RequestMapping("addCustomer") // 映射路径为/addCustomer
+ public ResultObj addCustomer(CustomerVo customerVo){ // 添加客户方法
try {
- customerService.save(customerVo);
- return ResultObj.ADD_SUCCESS;
+ customerService.save(customerVo); // 保存客户数据
+ return ResultObj.ADD_SUCCESS; // 返回添加成功结果
} catch (Exception e) {
- e.printStackTrace();
- return ResultObj.ADD_ERROR;
+ e.printStackTrace(); // 打印异常堆栈信息
+ return ResultObj.ADD_ERROR; // 返回添加失败结果
}
}
@@ -75,14 +72,14 @@ public class CustomerController {
* @param customerVo
* @return
*/
- @RequestMapping("updateCustomer")
- public ResultObj updateCustomer(CustomerVo customerVo){
+ @RequestMapping("updateCustomer") // 映射路径为/updateCustomer
+ public ResultObj updateCustomer(CustomerVo customerVo){ // 修改客户方法
try {
- customerService.updateById(customerVo);
- return ResultObj.UPDATE_SUCCESS;
+ customerService.updateById(customerVo); // 根据ID更新客户数据
+ return ResultObj.UPDATE_SUCCESS; // 返回更新成功结果
} catch (Exception e) {
- e.printStackTrace();
- return ResultObj.UPDATE_ERROR;
+ e.printStackTrace(); // 打印异常堆栈信息
+ return ResultObj.UPDATE_ERROR; // 返回更新失败结果
}
}
@@ -91,31 +88,29 @@ public class CustomerController {
* @param id 客户的ID
* @return
*/
- @ApiOperation(value = "删除一个客户",notes = "删除一个客户")
- @ApiImplicitParams({@ApiImplicitParam(name = "id", value = "客户ID",required = true,paramType = "query",dataType = "Integer")})
- @RequestMapping(value = "deleteCustomer",method = RequestMethod.DELETE)
- public ResultObj deleteCustomer(Integer id){
+ @ApiOperation(value = "删除一个客户",notes = "删除一个客户") // Swagger注解,描述操作内容
+ @ApiImplicitParams({@ApiImplicitParam(name = "id", value = "客户ID",required = true,paramType = "query",dataType = "Integer")}) // Swagger注解,描述参数信息
+ @RequestMapping(value = "deleteCustomer",method = RequestMethod.DELETE) // 映射路径为/deleteCustomer,方法为DELETE
+ public ResultObj deleteCustomer(Integer id){ // 删除客户方法
try {
- customerService.deleteCustomerById(id);
- return ResultObj.DELETE_SUCCESS;
+ customerService.deleteCustomerById(id); // 调用服务删除客户
+ return ResultObj.DELETE_SUCCESS; // 返回删除成功结果
} catch (Exception e) {
- e.printStackTrace();
- return ResultObj.DELETE_ERROR;
+ e.printStackTrace(); // 打印异常堆栈信息
+ return ResultObj.DELETE_ERROR; // 返回删除失败结果
}
}
-
/**
* 加载所有客户的下拉列表
* @return
*/
- @RequestMapping("loadAllCustomerForSelect")
- public DataGridView loadAllCustomerForSelect(){
- QueryWrapper queryWrapper = new QueryWrapper();
- queryWrapper.eq("available", Constast.AVAILABLE_TRUE);
- List list = customerService.list(queryWrapper);
- return new DataGridView(list);
+ @RequestMapping("loadAllCustomerForSelect") // 映射路径为/loadAllCustomerForSelect
+ public DataGridView loadAllCustomerForSelect(){ // 加载客户下拉列表方法
+ QueryWrapper queryWrapper = new QueryWrapper(); // 声明查询包装器
+ queryWrapper.eq("available", Constast.AVAILABLE_TRUE); // 查询可用客户数据
+ List list = customerService.list(queryWrapper); // 获取客户列表
+ return new DataGridView(list); // 返回客户数据
}
}
-