# jfinal-ueditor

**Repository Path**: BTMTimor/jfinal-ueditor

## Basic Information

- **Project Name**: jfinal-ueditor
- **Description**: 适配ueditor的java后端接口
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-18
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: JFinal, ueditor

## README

# JFinal-ueditor

## 功能列表

* 上传图片
* 上传涂鸦图片
* 上传截图
* 上传音频（未实现：ueditor前端 该功能已废弃）
* 远程抓取图片
* 上传视频
* 列出上传目录下的指定类型资源文件

## 如何使用

```java

public class AppConfig extends JFinalConfig {

    @Override
    public void onStart() {
        configUEditor();
    }
   
    private void configUEditor() {
        final String urlPrefix = "//test.com/attachment";
        final String baseUploadPath = "/srv/project-name/data/";
    
        // 使用本地存储器存储文件，也可适配使用阿里云、七牛云等
        final FileStorageManager storageManager = new FileStorageManager(baseUploadPath, urlPrefix);
        final UeditorService ueditorService = new UeditorService(storageManager);
        // 这步一定别忘了，不然使用默认控制器自动注入会失败
        AopManager.me().addSingletonObject(ueditorService);
    
        try {
            // from class path load resources file
            final String ueditorConfigFile = "config/ueditor-plus.conf";
            UeditorConfig.init(ueditorConfigFile);
        } catch (IOException e) {
            // todo
            logger.warn("初始化UEditor配置失败", e);
        }
    }

    @Override
    public void configRoute(Routes routes) {
        routes.add(new Routes() {
            @Override
            public void config() {
                // 权限校验与拦截
                addInterceptor(new FileUploadInterceptor());

                add("/api/ueditor-plus", UeditorPlusController.class);
            }
        });
    }

}

```

ueditor-plus: https://open-doc.modstart.com/ueditor-plus/guide.html

js需要配置ueditor配置地址为：/api/ueditor-plus


## 接口文档

### 一、上传图片

接口地址：`/api/ueditor-plus/uploadImage`

请求方法：POST

请求参数：
* file：图片文件

请求参考（nodejs）：

```js
fetch("http://red-culture.xpman.local/api/ueditor-plus/uploadImage", {
  "headers": {
    "accept": "*/*",
    "accept-language": "zh-CN,zh;q=0.9",
    "cache-control": "no-cache",
    "content-type": "multipart/form-data; boundary=----WebKitFormBoundaryOj2AxeaA8RzVSVHP",
    "pragma": "no-cache",
  },
  "body": "------WebKitFormBoundaryOj2AxeaA8RzVSVHP\r\nContent-Disposition: form-data; name=\"file\"; filename=\"机器人.png\"\r\nContent-Type: image/png\r\n\r\n\r\n------WebKitFormBoundaryOj2AxeaA8RzVSVHP--\r\n",
  "method": "POST"
});
```


响应参考：

```json
{
    "code": 200,
    "data": {
        "name": "a43eb2abeeaa402cb889f2d0e7554638.png",
        "original": "机器人.png",
        "state": "SUCCESS",
        "timestamp": 1774012579088,
        "title": "机器人.png",
        "url": "https://red-culture.xpman.top/attachment/image/default/2026-03-20/a43eb2abeeaa402cb889f2d0e7554638.png"
    },
    "message": "成功",
    "success": true,
    "timestamp": 1774012579088
}
```

### 二、上传视频



## 注意事项