# 1.0.4 配置文档

[返回1.0.4目录](./api.md) | [返回主文档](../../README.md)

## 说明
- **java**: 3.8.8
- **vue**: 3.8.4
## setup
[初始化环境参考](api.md#quick-start-)

## 📁 java端
### upload-pic
```java
// common/upload 接口
@Autowired
private MinIOService ioService;

/**
 * 通用上传请求（单个）
 */
@PostMapping("/upload")
public AjaxResult uploadFile(MultipartFile file) throws Exception
{
    try
    {
        FileResult fileResult = this.ioService.uploadFile(file, "sass-guoshu");
        // COS 上传逻辑
        String url = fileResult.peekSmall();

        // 统一返回字段
        ajax.put("url", url);
        ajax.put("fileName", url);
        ajax.put("newFileName", FileUtils.getName(url));
        ajax.put("ossUrl", this.ioService.getPublicImgUrl(url));
        ajax.put("originalFilename", isUrlUpload ? extractFilenameFromUrl(fileContent) : file.getOriginalFilename());
        return ajax;
    }
    catch (Exception e)
    {
        return AjaxResult.error(e.getMessage());
    }
}
```
### rich-text
（富文本）
```java
public void saveJsonData(){
    this.jsonDataService.saveJsonData("sass-guoshu/"+gsProduct.getId(),gsProduct.getContent());
}
```
```java
public String getJsonData(){
    String jsonData = this.jsonDataService.getJsonData("sass-guoshu/" + gsProduct.getId(), String.class);
    return jsonData;
}
```
### 组件使用案例
（富文本）
```vue
<el-form-item label="图片路径" prop="img">
  <ImageUpload v-model="form.img" :limit="1"></ImageUpload>
</el-form-item>
<el-form-item label="文件路径" prop="file">
  <file-upload v-model="form.file"/>
</el-form-item>
<el-form-item label="富文本的路径">
  <editor v-model="form.content" :min-height="192"/>
  <Editor :value="form.content":min-height="192"  @updateValue="getMsg" />
</el-form-item>
```
## ⚙️ vue-admin
[upload组件-上传图片](ruoyi-upgrade-upload.md#quick-start)
[Editor组件-富文本](ruoyi-upgrade-editor.md#quick-start)
[FileUpload组件](ruoyi-upgrade-file-upload.md#quick-start)


## 相关文档
[返回主文档](../../README.md)

*迁移改造若依版本: 1.0.4-SNAPSHOT | 最后更新: 2025-12-05*