网页CAD后台处理DWG的做法（MxServiceCode）

处理网页CAD后台处理DWG的做法（MxServiceCode）这类问题时，先确认目标场景，再按步骤核对配置或玩法细节。

一、引言：什么是 MxServiceCode？#

在开发 Web CAD 应用时，我们经常会遇到一些需要在服务器后台处理图纸的需求，比如批量转换格式、提取图纸数据等。这时候，云图开发包中的 MxServiceCode 就派上大用场了。

简单来说，MxServiceCode 是一个典型的 CAD 后端服务层，它位于云图开发包中的 MxDrawCloudServerBinMxServiceCode 目录下。它不是一个完整的 Web 前端应用，而是以 Node.js 命令行（CLI）的形式，对底层的 DWG 处理能力进行了轻量化的封装。它的核心技术由三大基石构成：MxFun 核心引擎、Native Addon（原生 C++ 扩展插件）以及 mxcad 对象模型。

这种底层架构设计，保证了它在处理复杂 CAD 数据时的高性能与稳定性。而在应用层面上，它非常灵活，所有的后端功能都是由基于该核心的 “命令模块” 来提供的。这意味着，开发者可以像搭积木一样，通过编写或调用不同的命令模块，轻松定制和扩展服务器端的图纸处理逻辑。

二、MxServiceCode 项目结构介绍#

为了让大家在二次开发时能 “找对门”，我们结合实际的工程目录结构，对 MxServiceCode 主要部分进行详细拆解。该项目采用标准的 Node.js + TypeScript 工程规范，核心分为以下几个板块：

1. bin 原生依赖与资源#

bin 目录是整个项目的 “动力心脏”，它并非普通的脚本文件夹，而是包含了项目运行所必需的底层二进制文件和资源。MxServiceCode 之所以能处理复杂的 DWG 图纸，完全依赖于该目录提供的原生环境支持。

1. Mx2DNode.node：核心的 Native 模块，真正执行 DWG 解析与转换的底层引擎。
2. fonts：DWG 字体文件，确保后台转换时文字不乱码。

2. src 核心源码层#

这是项目的逻辑处理中心，包含了从底层引擎封装到具体业务功能的所有 TypeScript 代码。根据职责不同，可划分为以下三个部分：

(1) mxcad 数据模型层#

这个文件夹是 CAD 对象模型的封装，将底层的 Native DWG 对象包装成了 JavaScript 可访问的实体。里面包含了大量的核心类，例如：

1. McDbDatabase.ts：图纸数据库。
2. McDbEntity.ts、McDbPolyline.ts、McDbText.ts：各类图纸实体（如多段线、文字、圆等）。
3. McDbLayerTable.ts：图层表，用于管理图纸的图层信息。

(2) sample 业务实现层#

这里是编写实际业务逻辑的地方，每个文件通常对应一个特定的图纸处理功能（如格式转换、图框切割等）。

若需新增功能，只需在此添加脚本并在 MxCommand.ts 中注册即可，模块化设计使得扩展非常灵活。

(3) 其他核心 TS 文件#

除了上述子文件夹外，src 根目录下的文件构成了程序的骨架与控制中枢：

1. ini.js：初始化脚本。通常在程序启动最早期执行，用于设置环境变量或加载基础配置，确保后续模块正常加载。
2. MxFun.ts：底层桥梁。负责加载 bin 目录下的原生 C++ 扩展（Mx2DNode.node），初始化 CAD 引擎环境，并提供日志记录、路径处理等通用工具函数。
3. MxProcessor.ts：命令调度中枢。负责解析外部传入的命令行参数，并将任务精准分发给对应的业务处理函数。
4. MxCommand.ts：命令注册表。在这里定义所有可用的指令名称（如 convert、frameCut）与具体实现函数的映射关系。
5. MxUtility.ts：通用工具库。提供项目中各模块复用的高频辅助方法，减少重复代码。
6. MxBackstageConvert.ts：图纸文件后台处理接口。封装底层 DWG 后台处理接口，负责打开 / 保存图纸、生成 WebGL 输出并提供后台数据库访问。

3. 根目录与基础配置#

这是项目的入口和配置中心，决定了程序如何启动和运行。

1. mxapp.ts：程序的绝对入口。Node.js 启动时首先执行此文件，负责初始化底层环境、解析命令行参数并触发命令执行。
2. package.json / tsconfig.json：项目的依赖管理清单与 TypeScript 编译配置文件。
3. test.bat / testlinux.sh：跨平台的测试脚本。分别用于 Windows 和 Linux 环境下快速验证功能是否正常。
4. .dwg (A3.dwg, BT.DWG, tree.dwg 等)：项目自带的测试图纸文件，用于开发调试时的输入源。

4. doc 与 public 目录#

1. doc：存放相关的技术文档或 API 说明，方便开发者查阅。
2. public：静态资源目录。如果 MxServiceCode 启动了简单的 HTTP 服务，这里的文件（如 HTML 预览页、CSS/JS 资源）可以直接被外部访问。

三、命令执行链路#

理解了项目结构后，我们需要深入探究 MxServiceCode 是如何处理一次完整请求的。它的命令执行链路非常清晰，核心逻辑可以概括为：命令行输入 → MxProcessor 调度 → 业务实现 → 底层处理 → JSON 输出。具体流程如下：

1. 程序启动与参数读取#

当我们在终端输入命令时，Node.js 首先会执行入口文件 mxapp.ts。程序启动后，会立即调用 MxFun.init() 来初始化底层的 C++ 运行环境。随后，它会通过 process.argv.slice(2) 获取用户在命令行传入的所有参数。如果此时没有传入任何命令，程序会直接输出版本信息和日志路径并结束运行。

2. 命令分发与注册#

当检测到有效参数后，程序会进入 MxProcessor.do(args) 进行命令分发。在分发之前，MxProcessor 会先调用 ReginstCommand() 完成命令的注册。这个函数位于 MxCommand.ts 中，它的作用是将具体的命令名称（如 convert、frameCut、margeDwg 等）与 sample 目录下的具体实现函数一一映射。

3. 参数解析与执行#

MxProcessor 支持两种参数解析模式：一种是标准的 命令 名称=值 形式，另一种是通过 fileparam filepath=... 读取外部 JSON 文件的形式。解析出命令名和参数后，MxProcessor 会在已注册的命令表中查找对应的处理函数。如果找不到，会直接返回 “命令没定义” 的错误；如果找到，则立即执行该函数。

4. 业务逻辑与底层交互#

位于 sample 目录下的命令实现函数被触发后，会开始处理具体的业务逻辑。它们通常会调用 MxBackstageConvert 或 Mx2DDraw 等模块来操作图纸。而这些模块在接收到指令后，会将请求传递给真正的底层核心 —— 由 MxFun 加载的 Native 模块（Mx2DNode.node）。Native 模块负责执行最耗时的 DWG 文件打开、实体遍历、数据转换等底层操作。

5. 统一结果输出#

当 Native 层完成所有图纸处理任务后，结果会逐层向上返回给命令实现函数。命令函数会将处理结果封装成一个标准的对象（例如包含 success 和 message 字段）。最后，MxProcessor.do() 会使用 console.log(JSON.stringify(...)) 将这个对象统一输出为 JSON 格式。这种标准化的输出方式，使得外部的 Web 服务或调用程序能够极其方便地读取和处理执行结果。

四、 功能测试#

在正式体验 MxServiceCode 强大的图纸处理能力之前，有一个关键的前置步骤，如果需要通过 HTTP 接口来调用这些功能，必须先启动云图开发包中的 web 服务，确保 1337 端口处于正常运行状态。

1. 启动 1337 端口服务（前置准备）#

MxDraw 云图开发包提供了极其简便的一键启动方式，您无需手动配置复杂的后台环境：

1. Windows 系统：直接双击运行 MxDrawCloudServer/Mx3dServer.exe，在弹出的窗口中点击 “开始 Web 服务”。程序会自动启动 1337 端口的 CAD 核心引擎服务（由 Bin/MxDrawServer/Windows/app.js 驱动）。
2. Linux 系统：在终端执行启动脚本 ./start_demo.sh，该脚本会自动拉起 1337 端口的 CAD 核心服务。

便捷提示：服务启动后，您可以直接在浏览器访问 localhost:1337/servertest。这是一个官方提供的可视化测试页面，您可以在页面上直接点击按钮来测试 DWG 转换、PDF 导出等核心接口，无需编写任何代码。

2. 核心功能与参数详解#

（1）获取 DWG 文件基础数据#

读取 DWG 图纸的实体数据、版本、范围等元信息，并输出为标准 JSON 文件，便于前端解析与展示。

命令行调用

    ./bin/node mxapp.js getcaddata file=t1.dwg outfile=t1.dwg.json

接口调用

    var data = {
cmd:"getcaddata",
file:"t1.dwg",
outfile:"t1.dwg.json"
};
axios({
method: "post",
url: "localhost:1337/users/mxservicecode",
data
}).then((ret) => {
console.log(ret.data)
alert(JSON.stringify(ret.data))
// 输出文件位置:Bin/MxServiceCode/MxServiceCode/t1.dwg.json
}).catch((err)=>{alert("网络错误") })

参数说明cmd目标命令名file源 DWG 文件名 文件路径：MxDrawCloudServerBinMxServiceCodeMxServiceCodeoutfile生成的 JSON 数据文件名 文件保存路径：MxDrawCloudServerBinMxServiceCodeMxServiceCode（2）后台参数化绘图#

无需人工干预，程序打开空白模板，根据预设逻辑执行绘图操作（如绘制特定图形、标注等），并生成新的 DWG 文件。

命令行调用

./bin/node mxapp.js testParamDraw  outfile=testdraw.dwg debug=1

接口调用

    var data = {
cmd:"testParamDraw",
//cmd:"testParamDrawTk",
outfile:"testdraw.dwg",
};
axios({
method: "post",
url: "localhost:1337/users/mxservicecode",
data
}).then((ret) => {
console.log(ret.data)
alert(JSON.stringify(ret.data))
// 输出文件位置:Bin/MxServiceCode/MxServiceCode/testdraw.dwg
    }).catch((err)=>{alert("网络错误") })

参数说明cmd目标命令名outfile生成的新 DWG 文件的保存路径debug可选，调试模式开关。值为 1 时表示开启调试模式（通常会输出更多日志信息）（3）根据图框名裁剪 DWG 到 PDF#

这是一个非常实用的出图功能。程序会自动在图纸中搜索指定名称的图框（Block），识别其范围，并将图框内的图形内容批量导出为 PDF、图片或其他格式。

命令行调用

./bin/node mxapp.js frameCut2 file=D:/Test/testcut.dwg tkname="AAA" outtype=.pdf width="5000" height="3000"

接口调用

    var data = {
cmd:"frameCut2",
file:"D:/Test/testcut.dwg",
tkname:"1横20200521",
outtype:".pdf",
//colorPolicy:"mono"
//width:"1000"
//height:"1000"
};
axios({
method: "post",
url: "localhost:1337/users/mxservicecode",
data
}).then((ret) => {
console.log(ret.data)
alert(JSON.stringify(ret.data))
    }).catch((err)=>{alert("网络错误") })

参数说明cmd目标命令名file源 DWG 文件路径tkname需要裁剪的图框名称（即 Block 的名字）outtype指定输出文件的格式，例如 .pdf、.mxweb 等width / height指定输出 pdf 的宽度和高度colorPolic颜色策略。例如设置为 mono 表示输出黑白（4）获取 DWG 文件图层信息#

专门用于分析图纸结构，读取 DWG 的图层表（LayerTable），提取所有图层的名称、颜色、线型等属性，并输出图层列表，默认输出文件名为 原文件名_layers.json。

命令行调用

./bin/node mxapp.js getAllLayer  file="D:/Test/A.dwg"

接口调用

    var data = {
cmd:"getAllLayer",
file:"t1.dwg",
};
axios({
method: "post",
url: "localhost:1337/users/mxservicecode",
data
}).then((ret) => {
console.log(ret.data)
alert(JSON.stringify(ret.data))
// 输出文件位置:Bin/MxServiceCode/MxServiceCode/t1.dwg_layers.json
}).catch((err)=>{alert("网络错误") })

参数说明cmd目标命令名file源 DWG 文件的路径（5）合并图纸#

读取多张 DWG 图纸的数据库，并将读取到的数据库合并到目标图纸数据库中，实现图纸的批量合并与拼接。

命令行调用

./bin/node mxapp.js margeDwg file="D:/Test/mB.dwg" marge_file="D:/Test/mA.dwg"  out_file="D:/Test/mC.dwg" marge_layer="['2306','2307']" debug=1

接口调用

    var data = {
cmd:"margeDwg",
file:"D:/Test/mB.dwg",
marge_file:"['D:/Test/mA.dwg']",
out_file:"D:/Test/mC.dwg",
marge_layer:"['2306','2307']",
};
axios({
method: "post",
url: "localhost:1337/users/mxservicecode",
data
}).then((ret) => {
console.log(ret.data)
alert(JSON.stringify(ret.data))
    }).catch((err)=>{alert("网络错误") })

参数说明cmd目标命令名file目标 DWG 文件（被合并到的主文件）marge_file要合并的 DWG 文件，支持单个路径或 JSON 数组out_file合并后输出 DWG 文件marge_layer（可选）要合并的图层数组，格式类似 ['layer1','layer2'] 本作品采用《CC 协议》，转载必须注明作者和本文链接