원클릭으로 Manus에서 모든 스킬 실행

시작하기

restful-vs-frame

스타3

포크0

업데이트2026년 7월 15일 09:09

EWA RESTful handler 开发/调试时，与 Frame 路径 (ServletUpload/ActionFrame) 对照确保参数映射和 SQL 执行一致性

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

gdx1231

gdx1231/emp-script

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

RESTful vs Frame 路径对照

核心原则

当开发或调试 ServletRestful 的 handler（upload/download/image/conf）时，必须对照 Frame 路径的等效实现，确保：

RequestValue 参数映射完整
Action SQL 被执行
响应结构匹配客户端预期

对照表

功能	RESTful 路径	Frame 路径
上传文件	`ServletRestful.handleUpload()`	`ServletUpload.show()`
文件→参数映射	需手动实现	`ActionFrame.createUploadPara()`
参数→SQL	`ServletRestful.handleConf()`	`ActionFrame.executeCallSql()`
下载	`ServletRestful.handleDownload()`	`HtmlCreator` (inline)
图片	`ServletRestful.handleImage()`	`HtmlCreator.getUploadedFilePath()`

关键差异

上传流程

Frame 路径（两步式，两次请求）：

客户端 --Ajax上传--> ServletUpload → Upload.upload() → 返回 [{"UP":"加密JSON"}]
客户端 --表单提交--> ActionFrame.createUploadPara() → 解密UP → 映射字段参数 → 执行Action SQL

RESTful 路径（一步式，一次请求）：

客户端 --POST multipart--> ServletRestful.handleUpload()
  1. Upload.upload()           // 保存文件，执行 UpSql
  2. mapUploadParametersToRv() // 迭代 UserXItems → UploadUtils.createUploadPara()
  3. handleConf()              // 执行 Item Action SQL (INSERT/UPDATE)

UploadUtils — 统一上传入口

UploadUtils 提供两个公共方法，是上传流程的唯一权威实现：

// com.gdxsoft.easyweb.uploader.UploadUtils

// 1. 完整上传流程：创建 Upload → 解析 multipart → 执行 upload() → 返回 Upload 实例
public static Upload parseAndUpload(HttpServletRequest request, RequestValue rv) throws Exception

// 2. 参数映射：FileUpload 列表 → RequestValue 字段级参数
public static void createUploadPara(String uploadName, String dataType,
        List<FileUpload> alFiles, String uploadDir, RequestValue rv) throws Exception

调用方：

方法	ServletUpload.show()	ServletRestful.handleUpload()	ActionFrame.createUploadPara()
`parseAndUpload()`	✅	✅	—
`createUploadPara()`	—	✅ (via `mapUploadParametersToRv`)	✅

parseAndUpload() 内部流程：

new Upload() → setRv(rv) → init(request)（从 rv 读取 XMLNAME/ITEMNAME/NAME）
设置 DiskFileItemFactory（buffer 10M, tempPath=upload_files）
创建 ServletFileUpload（maxSize 2G）
parseRequest(request) → 遍历 items → form fields 写入 rv
setUploadItems(items) → upload() → 返回 Upload 实例

createUploadPara() 调用方式差异：

ServletRestful：直接传 up.getAlFiles() + up.getUploadDir()
ActionFrame：从解密后的 UP JSON 构建 FileUpload（设置 savePath/fileUrl/unid 等），传 p（UpPath）作为 uploadDir

上传参数映射（UploadUtils 设置的参数）

参数名	来源	说明
`字段名`	`UFile.readFileBytes(path)` 或 `fu.getFileUrl()`	binary 或 string 类型
`字段名_EXT`	`fu.getExt()`	扩展名
`字段名_MD5`	`UFile.md5(file)`	MD5 校验
`字段名_NAME`	`file.getName()`	保存文件名
`字段名_PATH`	`file.getAbsolutePath()`	完整物理路径
`字段名_PATH_SHORT`	`up.getUploadDir() + "/" + file.getName()`	短路径
`字段名_SIZE` / `_LENGTH`	`file.length()`	文件大小
`字段名_URL`	`fu.getFileUrl()`	文件URL
`字段名_UP_UNID`	`fu.getUnid()`	文件UNID
`字段名_CT`	`UPath.getPATH_UPLOAD_URL()`	URL前缀
`字段名_LOCAL_NAME`	`fu.getUserLocalPath()`	用户本地文件名
`字段名_JSON`	JSONArray of all files	所有上传文件JSON

哪些 Tag 需要处理上传

在遍历 UserXItems 时，只处理以下 Tag：

h5upload
image
swffile

且必须 item.testName("Upload") 为 true。

调试检查清单

当 ServletRestful 的 upload 不工作时：

handleUpload() 是否调用了 handleConf()？（否则 Item Action SQL 不会执行）
是否调用 mapUploadParametersToRv() → UploadUtils.createUploadPara()？
handleUpload 签名是否有 HttpServletResponse 参数？（handleConf 需要）
initUploadParameters() 是否设置了 name（小写）在 rv 中？（Upload.init() 通过 rv.s("NAME") 读取，大小写不敏感）

依赖类

// 统一参数映射
import com.gdxsoft.easyweb.uploader.UploadUtils;
// 文件数据载体
import com.gdxsoft.easyweb.uploader.FileUpload;
// 上传引擎
import com.gdxsoft.easyweb.uploader.Upload;
// 文件操作
import com.gdxsoft.easyweb.utils.UFile;
import com.gdxsoft.easyweb.utils.UPath;

이 저장소의 다른 Skills

같은 저장소

sqlite-dataconnection-test

gdx1231/emp-script

How to write DataConnection tests using SQLite — driver version, pool setup (HikariCP/Druid), path expressions, concurrency, and API patterns

2026-07-133

ewa-api

gdx1231/emp-script

Use when: 调用 EWA Servlet API、查询数据库表结构与数据、读取或修改 EWA XML 配置项、生成业务 XML（自动创建容器）、查看配置存储路径（showScriptPaths）、直接读取 XML 文件（getXmlFile）、校验 SQL 语法（validateSql）、需要脚本化执行 login/getTables/getTable/getTableData/getConfItem/previewBusinessXml/createBusinessXml/showScriptPaths/getXmlFile/validateSql。

2026-07-083

ewa-stored-procedure

gdx1231/emp-script

Use when: 通过 EWA API 查看存储过程、函数或触发器的完整定义文本。INFORMATION_SCHEMA.ROUTINES 会截断，需用 sys.sql_modules 获取完整内容。

2026-07-073

ewa-form

gdx1231/emp-script

Use when: 编写 EWA 表单前端 JS 代码、表单提交与验证、表单与列表联动、对话框中表单操作、动态字段控制、合并单元格、分组向导。按任务组织，含完整代码示例。

2026-07-033

ewa-listframe

gdx1231/emp-script

Use when: 编写 EWA ListFrame 列表前端 JS 代码、行数据操作、选中行、翻页排序、检索过滤、展开行详情、动态列、底部汇总、行内编辑。按任务组织，含完整代码示例。

2026-07-033

ewa-sql

gdx1231/emp-script

Use when: 编写 EWA XML 中的 SQL、理解 EWA SQL 参数规则、SQL 注释标记（ewa_test/ewa_block_test/auto/ewa_table_name/EWA_SQL_SPLIT_NO/EWA_IS_SELECT/EWA_JOIN/EWA_KV/COMPARATIVE_CHANGES）、分页查询、存储过程调用、INSERT/UPDATE/DELETE 模式。

2026-07-033

name	restful-vs-frame
description	EWA RESTful handler 开发/调试时，与 Frame 路径 (ServletUpload/ActionFrame) 对照确保参数映射和 SQL 执行一致性
source	auto-skill
extracted_at	2026-07-15T09:00:10.895Z

RESTful vs Frame 路径对照

核心原则

当开发或调试 ServletRestful 的 handler（upload/download/image/conf）时，必须对照 Frame 路径的等效实现，确保：

RequestValue 参数映射完整
Action SQL 被执行
响应结构匹配客户端预期

对照表

功能	RESTful 路径	Frame 路径
上传文件	`ServletRestful.handleUpload()`	`ServletUpload.show()`
文件→参数映射	需手动实现	`ActionFrame.createUploadPara()`
参数→SQL	`ServletRestful.handleConf()`	`ActionFrame.executeCallSql()`
下载	`ServletRestful.handleDownload()`	`HtmlCreator` (inline)
图片	`ServletRestful.handleImage()`	`HtmlCreator.getUploadedFilePath()`

关键差异

上传流程

Frame 路径（两步式，两次请求）：

客户端 --Ajax上传--> ServletUpload → Upload.upload() → 返回 [{"UP":"加密JSON"}]
客户端 --表单提交--> ActionFrame.createUploadPara() → 解密UP → 映射字段参数 → 执行Action SQL

RESTful 路径（一步式，一次请求）：

客户端 --POST multipart--> ServletRestful.handleUpload()
  1. Upload.upload()           // 保存文件，执行 UpSql
  2. mapUploadParametersToRv() // 迭代 UserXItems → UploadUtils.createUploadPara()
  3. handleConf()              // 执行 Item Action SQL (INSERT/UPDATE)

UploadUtils — 统一上传入口

UploadUtils 提供两个公共方法，是上传流程的唯一权威实现：

// com.gdxsoft.easyweb.uploader.UploadUtils

// 1. 完整上传流程：创建 Upload → 解析 multipart → 执行 upload() → 返回 Upload 实例
public static Upload parseAndUpload(HttpServletRequest request, RequestValue rv) throws Exception

// 2. 参数映射：FileUpload 列表 → RequestValue 字段级参数
public static void createUploadPara(String uploadName, String dataType,
        List<FileUpload> alFiles, String uploadDir, RequestValue rv) throws Exception

调用方：

方法	ServletUpload.show()	ServletRestful.handleUpload()	ActionFrame.createUploadPara()
`parseAndUpload()`	✅	✅	—
`createUploadPara()`	—	✅ (via `mapUploadParametersToRv`)	✅

parseAndUpload() 内部流程：

new Upload() → setRv(rv) → init(request)（从 rv 读取 XMLNAME/ITEMNAME/NAME）
设置 DiskFileItemFactory（buffer 10M, tempPath=upload_files）
创建 ServletFileUpload（maxSize 2G）
parseRequest(request) → 遍历 items → form fields 写入 rv
setUploadItems(items) → upload() → 返回 Upload 实例

createUploadPara() 调用方式差异：

ServletRestful：直接传 up.getAlFiles() + up.getUploadDir()
ActionFrame：从解密后的 UP JSON 构建 FileUpload（设置 savePath/fileUrl/unid 等），传 p（UpPath）作为 uploadDir

上传参数映射（UploadUtils 设置的参数）

参数名	来源	说明
`字段名`	`UFile.readFileBytes(path)` 或 `fu.getFileUrl()`	binary 或 string 类型
`字段名_EXT`	`fu.getExt()`	扩展名
`字段名_MD5`	`UFile.md5(file)`	MD5 校验
`字段名_NAME`	`file.getName()`	保存文件名
`字段名_PATH`	`file.getAbsolutePath()`	完整物理路径
`字段名_PATH_SHORT`	`up.getUploadDir() + "/" + file.getName()`	短路径
`字段名_SIZE` / `_LENGTH`	`file.length()`	文件大小
`字段名_URL`	`fu.getFileUrl()`	文件URL
`字段名_UP_UNID`	`fu.getUnid()`	文件UNID
`字段名_CT`	`UPath.getPATH_UPLOAD_URL()`	URL前缀
`字段名_LOCAL_NAME`	`fu.getUserLocalPath()`	用户本地文件名
`字段名_JSON`	JSONArray of all files	所有上传文件JSON

哪些 Tag 需要处理上传

在遍历 UserXItems 时，只处理以下 Tag：

h5upload
image
swffile

且必须 item.testName("Upload") 为 true。

调试检查清单

当 ServletRestful 的 upload 不工作时：

handleUpload() 是否调用了 handleConf()？（否则 Item Action SQL 不会执行）
是否调用 mapUploadParametersToRv() → UploadUtils.createUploadPara()？
handleUpload 签名是否有 HttpServletResponse 参数？（handleConf 需要）
initUploadParameters() 是否设置了 name（小写）在 rv 中？（Upload.init() 通过 rv.s("NAME") 读取，大小写不敏感）

依赖类

// 统一参数映射
import com.gdxsoft.easyweb.uploader.UploadUtils;
// 文件数据载体
import com.gdxsoft.easyweb.uploader.FileUpload;
// 上传引擎
import com.gdxsoft.easyweb.uploader.Upload;
// 文件操作
import com.gdxsoft.easyweb.utils.UFile;
import com.gdxsoft.easyweb.utils.UPath;