苍穹外卖菜品管理：新增功能实战解析

// RESTful 风格 POST /api/dishes // 新增菜品 POST /api/category/{id}/dishes // 向指定分类添加菜品 // 实际选择 POST /api/admin/dishes // 后台管理接口

// 定义请求对象
@Data
public class DishAddRequest {
    @NotBlank(message = "菜品名称不能为空")
    private String name;
    
    @NotNull(message = "价格不能为空")
    @DecimalMin(value = "0.01", message = "价格必须大于0")
    private BigDecimal price;
    
    @NotNull(message = "分类不能为空")
    private Long categoryId;
    
    private String description;
    
    private List<String> imageUrls;  // 图片URL列表
    
    @NotNull(message = "库存不能为空")
    @Min(value = 0, message = "库存不能小于0")
    private Integer stock;
    
    private Boolean status = true;  // 默认上架
    
    private List<DishFlavor> flavors;  // 口味选项

// Controller
@PostMapping("/dishes")
public Result<Long> addDish(@RequestBody @Valid DishAddRequest request) {
    Long dishId = dishService.addDish(request);
    return Result.success(dishId);
}

@RestController
@RequestMapping("/admin/common")
@Slf4j
@Api(tags = "通用接口")
public class CommonController {
    /**
     * 文件上传
     * @param file
     * @return
     */
    @PostMapping("/upload")
    @ApiOperation("文件上传")
    public Result<String> upload(MultipartFile file){//注意，这里面的参数必须要和前端传过来的一样file，不然就接收不到前端的图片了，String是返回图片的路径，用于用户查看照片，可以直接调用这个路径
        log.info("文件上传:{}",file);
        //把文件上传到阿里云服务

alioss:
  endpoint: ${sky.alioss.endpoint}
  access-key-id: ${sky.alioss. access-key-id}
  access-key-secret: ${sky.alioss.access-key-secret}
  bucket-name: ${sky.alioss.bucket-name}

/**
 * 配置类，用于创建AliUtil对象
 */
@Configuration
@Slf4j
public class OssConfiguration {
    @Bean
    @ConditionalOnBean
    public AliOssUtil aliOssUtil(AliOssProperties aliOssProperties){
        log.info("开始创建阿里云工作类对象,{}",aliOssProperties);
     return    new AliOssUtil(aliOssProperties.getEndpoint(),
             aliOssProperties.getAccessKeyId(),
             aliOssProperties.getAccessKeySecret(),
             aliOssProperties.getBucketName());

┌─────────────────┐
│  OssProperties  │ ← 读取配置
└────────┬────────┘
         ↓
┌─────────────────┐
│OssConfiguration │ ← 配置类，创建Bean
└────────┬────────┘
         ↓
┌─────────────────┐
│   AliOssUtil    │ ← 工具类，真正干活
└────────┬────────┘
         ↓
┌─────────────────┐
│ 业务Service     │ ← 使用工具类
└─────────────────┘

log.info("文件上传:{}",file); //把文件上传到阿里云服务 try { //原始文件名 String originalFilename = file.getOriginalFilename(); //截取原始文件名的后缀 String extension = originalFilename.substring(originalFilename.lastIndexOf(".")); //构造新文件名名称 String objectName= UUID.randomUUID().toString()+extension; //文件的地址/网址 String filePath = aliOssUtil.upload(file.getBytes(), objectName); return Result.success(filePath); } catch (IOException e) { log.info("文件上传失败,{}",e); }