第6章 产线定制：MapGIS二次开发

第6章 · 产线定制：MapGIS 二次开发

章节摘要：标准产品服务标准需求，特殊业务必须改造产线。本章是全书工程含量最高的一章：先做选型判断——桌面定制、Web 应用、服务端扩展还是脚本自动化，四条路线各有成本与收益；再逐条走通。代码以 C# 组件开发与 JavaScript 服务端调用为主，穿插插件与 Python 脚本。读完你能为一个真实需求选对开发路线，并写出可运行的原型代码。

学习目标

阅读完本章，你应当能够：

1. 按"用户在哪、交互多复杂、性能要求多高"三个问题为项目选择二次开发路线
2. 搭建 C# 组件开发环境，完成连接数据库、读取要素类、遍历要素的最小程序
3. 解释 MapGIS 对象模型中服务器、数据库、要素类、要素的层级关系
4. 调用 IGServer 的 REST 接口完成查询与出图请求，并用代码解析返回结果
5. 编写桌面插件，把一个重复操作挂进菜单
6. 用 Python 脚本批处理数据转换，把人从重复劳动里解放出来

核心概念速览

一句金句：选路线的顺序是先问"能不能不写代码"，再问"能不能少写代码"，最后才问"用什么语言写"。

本章知识点清单

• 选型三问：零代码、少写代码、完整程序三问的适用顺序与判断依据
• 四路线矩阵：组件式、服务端、插件、脚本的用户形态、成本量级与典型风险
• 环境三坑：位数、框架版本、环境变量的排查顺序
• 对象模型四级：服务器、数据库、要素类、要素的钻取路径与打开关闭配对纪律
• 游标遍历：大要素表的按批取数与进度反馈
• 接口解剖：REST 地址七段语义、参数三件（几何、属性、分页）、返回结构按下标配对
• 集成三防：范围校验、统一错误语义、未命中返回
• 生存三件：超时、幂等重试、降级兜底
• 插件生命周期：加载、注册、回调、清理四拍与宿主上下文的使用纪律
• 脚本工程习惯：留痕日志、版本管理、幂等重跑

子章节导航

6.1 二次开发方式选型与环境搭建

四条路线的决策框架与成本对照，加上开发环境的搭建实录。跳过选型直接写代码，是二开项目返工的头号原因。

6.2 组件式开发：用 C# 拼装桌面 GIS

以对象模型为纲：连库、开类、遍历要素、写回修改。适合做内部工具与重交互的桌面系统。

6.3 服务端开发：IGServer 接口调用

面向 Web 与集成的开发方式：REST 风格接口、请求组装、结果解析。适合做跨平台应用与业务系统集成。

6.4 插件式扩展与脚本自动化

两条轻量路线：插件把功能挂进桌面端菜单，脚本把批处理交给机器。二八定律在这条战线上最灵验。

子章节之间的逻辑关系

6.1 是岔路口，后面三节是三条并行的路，按项目需求走其一即可；但组件式的对象模型认知会让接口调用与脚本编写都变得更顺：

6.1 选型 ──► 6.2 组件式 CSharp ──┐
        ├──► 6.3 服务端 REST ─────┼──► 第7章 行业项目落地
        └──► 6.4 插件与脚本 ──────┘
​

前置知识与后续延伸

• 前置知识：第 2 章的地理数据库结构与第 5 章的服务概念；C# 或 JavaScript 任一语言的基础语法
• 后续延伸：本章的代码骨架在第 7 章行业案例里组装成完整方案；插件与脚本是长期积累个人工具库的起点

编程基础的自查门槛

本章默认你写过一点代码，不要求精通。自查三题：能用任一语言写循环加条件判断；知道什么是函数的参数与返回值；见过对象这个词，知道方法通过点号调用。三题都能过关即可起步——C# 与 JavaScript 在本章都从最小骨架讲起，语法细节卡住时随手查语法手册即可，GIS 开发的难点从来不在语言本身，在对象模型与工程判断。