一、引言：什么是 MxServiceCode？

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

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

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

二、MxServiceCode 项目结构介绍

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

1. bin 原生依赖与资源

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

• Mx2DNode.node：核心的 Native 模块，真正执行 DWG 解析与转换的底层引擎。

• fonts：DWG 字体文件，确保后台转换时文字不乱码。

2. src 核心源码层

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

(1) mxcad 数据模型层

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

• McDbDatabase.ts：图纸数据库。

• McDbEntity.ts、McDbPolyline.ts、McDbText.ts：各类图纸实体（如多段线、文字、圆等）。

• McDbLayerTable.ts：图层表，用于管理图纸的图层信息。

(2) sample 业务实现层

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

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

(3) 其他核心 TS 文件

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

• ini.js：初始化脚本。通常在程序启动最早期执行，用于设置环境变量或加载基础配置，确保后续模块正常加载。

• MxFun.ts：底层桥梁。负责加载 bin 目录下的原生 C++ 扩展（Mx2DNode.node），初始化 CAD 引擎环境，并提供日志记录、路径处理等通用工具函数。

• MxProcessor.ts：命令调度中枢。负责解析外部传入的命令行参数，并将任务精准分发给对应的业务处理函数。

• MxCommand.ts：命令注册表。在这里定义所有可用的指令名称（如 convert、frameCut）与具体实现函数的映射关系。

• MxUtility.ts：通用工具库。提供项目中各模块复用的高频辅助方法，减少重复代码。

• MxBackstageConvert.ts：图纸文件后台处理接口。封装底层 DWG 后台处理接口，负责打开/保存图纸、生成 WebGL 输出并提供后台数据库访问。

3. 根目录与基础配置

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

• mxapp.ts：程序的绝对入口。Node.js 启动时首先执行此文件，负责初始化底层环境、解析命令行参数并触发命令执行。

• package.json / tsconfig.json：项目的依赖管理清单与 TypeScript 编译配置文件。

• test.bat / testlinux.sh：跨平台的测试脚本。分别用于 Windows 和 Linux 环境下快速验证功能是否正常。

• .dwg (A3.dwg, BT.DWG, tree.dwg 等)：项目自带的测试图纸文件，用于开发调试时的输入源。

4. doc 与 public 目录

• doc：存放相关的技术文档或 API 说明，方便开发者查阅。

• 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 云图开发包提供了极其简便的一键启动方式，您无需手动配置复杂的后台环境：

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

• 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("网络错误") })

（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("网络错误") })

（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("网络错误") })

（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("网络错误") })

（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("网络错误") })