cloudcc-cli 2.3.9 → 2.4.0

package/src/jsp/docs/introduction.md

@@ -0,0 +1,50 @@
+# CloudCC JSP 迁移介绍
+
+## 1. 模块定位
+
+`jsp` 模块用于辅助将旧 JSP 页面迁移为 CloudCC 自定义类与自定义组件。
+
+当前资源主要提供三类能力：
+
+- 读取固定迁移规则
+- 对单个 JSP 做 dry-run 分析
+- 对单个 JSP 输出迁移产物
+
+可通过以下命令查看：
+
+```bash
+cloudcc doc jsp introduction
+cloudcc doc jsp devguide
+```
+
+## 2. 当前支持的命令
+
+```bash
+cloudcc doc jsp devguide
+cloudcc analyze jsp <encodeURI(JSON.stringify(params))>
+cloudcc split jsp <encodeURI(JSON.stringify(params))>
+```
+
+其中 `params` 主要包含：
+
+- `jspPath`
+- `helpDocPath`
+- `projectPath`
+- `outputProjectPath`
+- `className`
+- `componentName`
+- `reportDir`
+- `mode`
+- `overwrite`
+
+## 3. 适用场景
+
+- 旧系统 JSP 页面迁移评估
+- 识别 `reason` 分支、对象依赖、`PageClsInvoker` 调用
+- 生成 CloudCC 自定义类、自定义组件和迁移报告草稿
+
+## 4. 使用建议
+
+- 先阅读 `cloudcc doc jsp devguide`
+- 再执行 `cloudcc analyze jsp ...` 做分析
+- 确认命名、输出目录和覆盖策略后，再执行 `cloudcc split jsp ...`

package/src/jsp/docs.js

@@ -0,0 +1,21 @@
+const fs = require("fs")
+const path = require("path")
+
+const DOCS_DIR = path.join(__dirname, "docs")
+
+function readDocFile(name) {
+  return fs.readFileSync(path.join(DOCS_DIR, `${name}.md`), "utf8")
+}
+
+function readIntroductionDoc() {
+  return readDocFile("introduction")
+}
+
+function readDevGuideDoc() {
+  return readDocFile("devguide")
+}
+
+module.exports = {
+  readIntroductionDoc,
+  readDevGuideDoc,
+}

package/src/jsp/index.js

@@ -0,0 +1,14 @@
+const cc = {}
+cc.analyze = require("./analyze")
+cc.split = require("./split")
+cc.doc = require("./doc")
+
+function main(action, argvs) {
+  const fn = cc[action]
+  if (!fn) {
+    throw new Error(`jsp: unsupported action ${action}`)
+  }
+  return fn(argvs)
+}
+
+module.exports = main