Micaps3.2二次开发实例教程-11

实例六-让Micaps支持新数据类型-BLN地图数据

Micaps本身支持几十类数据，如果将所有类型数据的读写显示都模块都放在一起，那将带来如下问题：

• 代码量太大，代码维护成问题；
• Micaps以后可能还需要支持更多的数据格式，程序的升级扩充问题；
• 各种数据支持代码也不能仅靠Micaps开发团队核心人员编写，团队开发问题；
• 最后，各省还想直接显示他们自己的数据，二次开发问题；

Micaps3.2的策略是利用SharpDevelop的插件框架，将各种数据支持功能都以插件方式提供，一种数据格式一个插件。大家根据Micaps预定义好规则，独立开发插件，扩充性和团队开发问题都得到了解决。二次开发中也可以使用同样方法开发插件让Micaps支持特定的数据格式。

要实现这个功能，插件的代码里首先要解决两个问题：

• 数据识别问题。当用户打开一个文件（链接、字符串等）后，如何让Micaps识别出数据类型，然后根据数据类型来决定怎么读文件、怎么绘图。

对这个问题，Sharpdevelop已经提供了框架，使用一种叫做DisplayBinding（显示绑定）的插件架构。每个显示绑定插件里首先要实现一个对文件类型的识别函数，Sharpdevelop将系统中所有显示绑定插件排成一个列表，如果自己能识别，则打开显示，不能识别则交个下一个数据支持插件处理。

•  数据显示问题。读出了数据，如果是要填到地图上，如何与Micaps地图交互？

要将数据显示在地图上，那必然要和Micaps的地图交互。Micaps已提供大量可供调用类，包括图层、绘制函数等，这也是Micaps二次开发的难点，这些内容可查阅《Micaps3.2二次开发手册》。

这一节，我们编写插件为Micaps增加surfer的bln格式地图数据支持功能。

1、Addin文件：

  

<Pathname="/Workspace/DisplayBindings">
    <DisplayBinding id="SurferBln"
              type="Layer"
              class="SurferBln.SurferBlnDataBindings"/>
  </Path>

显示绑定的扩展点路径为"/Workspace/DisplayBindings"；type="Layer"是Micaps新增的一种类型，它表示该数据将以地图图层方式显示；在显示绑定段里指定绑定的类名为"SurferBln.SurferBlnDataBindings"，这个类将完成对数据类型的判断、数据显示等动作。

2、代码：

代码中主要是实现Addin文件里指定的SurferBln.SurferBlnDataBindings，该类必须实现接口ILayerDisplayBinding：

 public class SurferBlnDataBindings : ILayerDisplayBinding
    {
        #region ILayerDisplayBinding 成员
 
        /// <summary>
        /// 判读传入的文件名是否能被本插件打开
        /// </summary>
        /// <param name="filename">文件名</param>
        /// <returns>可以打开：true，不能打开：false</returns>
        public bool CanCreateForFile(string filename)
        {
            //本插件能打开后缀为bln的文件
            return Path.GetExtension(filename).ToLower() == ".bln";
        }
 
        /// <summary>
        /// 创建bln图层并加入地图
        /// </summary>
        /// <param name="file"></param>
        /// <returns></returns>
        public ILayer CreateLayerForFile(OpenedFile file)
        {
            //取得当前视图，转换为Micaps地图视图
            var mainRenderView = WorkspaceSingleton.Workspace.ActiveViewContent as IMicapsMainView;
            //如果当前视图是地图，则加载图层
            if (mainRenderView != null)
            {
                //创建bln图层
                BlnChart Chart = new BlnChart();
                //用它创建Micaps图层绑定对象
                MicapsDataLayerWrapper layer = new MicapsDataLayerWrapper(Chart);
                //给图层的地图对象赋值
                Chart.Map = mainRenderView.Map;
                //加载数据
                layer.Load(file, file.OpenRead());
                file.CloseIfAllViewsClosed();
                layer.LayerName = Chart.Description();
                return layer;
            }
            return null;            
        } 
        #endregion
    }

ILayerDisplayBinding接口包含两个函数：

• bool CanCreateForFile(string filename)；用来判断该插件能打开的文件。
• ILayer CreateLayerForFile(OpenedFile file)；打开文件，创建图层。

    上面的代码里，BlnChart是我们新建的一个类，用来读取和显示bln文件。该类从C_ChartBase类继承，主要实现以下成员：

 
 
string ReadFile(string filename)：读取解析bln文件。
void Draw(GLGraphics g)：绘图。

<pre name="code" class="csharp">using System;
using System.Collections.Generic;
using System.Text;
using nmc.micaps3;
using System.Drawing;
using System.IO;

namespace SurferBln
{
    class BlnChart : C_ChartBase
    {

        private BlnProperty _Property = new BlnProperty();

        public override void AddLayer(System.Collections.ArrayList list)
        {
            LayerZOrder layer_order = new LayerZOrder();
            layer_order.obj = this;
            layer_order.zOrder = 31;
            list.Add(layer_order);
        }
        string _Description = "Surfer Bln格式数据";

        public override string Description()
        {
            return _Description;
        }

        public override void Draw(GLGraphics g)
        {
            float x, y;
            List<PointF> pts;
            foreach (MapModel mo in MapObjects)
            //判断地图元素类型，仅显示线状数据
            if (mo.ObjectType == ShapeType.PolyLine)
                {
                    pts = new List<PointF>();
                    foreach (PointF ptf in mo.Points)
                    {
                        map.MemTY(ptf.X, ptf.Y, out x, out y);
                        PointF xy = new PointF(x,y);
                        pts.Add(xy);
                    }
                    g.DrawLines(_Property.LineColor, pts.ToArray());
                }
            }
            //map.MemTY(107, 33, out x, out y);
            //g.DrawEllipse(_Property.LineColor, x, y, 300, 300);
        }

        public override object GetPropertyInstance()
        {
            return _Property;
        }

        public override DateTime NextDateTime()
        {
            throw new NotImplementedException();
        }

        public override DateTime PreviousDateTime()
        {
            throw new NotImplementedException();
        }

        public override string ReadDB(object parameter)
        {
            throw new NotImplementedException();
        }
        protected IList<MapModel> MapObjects = new List<MapModel>();

        public override string ReadFile(string filename)
        {
            using (FileStream fs = new FileStream(filename, FileMode.Open, FileAccess.Read, FileShare.Read))
            {
                using (StreamReader ws = new StreamReader(fs, Encoding.Default))
                {
                    while (!ws.EndOfStream)
                    {
                        //数据行
                        string line = "";
                        //读取地图元素头，并跳过空行
                        do
                        {
                            line = ws.ReadLine();
                        }
                        while (string.IsNullOrEmpty(line));
                        //分隔数据行
                        string[] items = line.Split(", ".ToCharArray(), StringSplitOptions.RemoveEmptyEntries);
                        //点数
                        int n = Convert.ToInt16(items[0]);
                        //地图元素
                        MapModel mo = new MapModel();
                        //地图元素头为两个
                        if (items.Length > 1)
                        {
                            int t = Convert.ToInt16(items[1]);
                            if (t == 1)
                            {
                                //线
                                mo.ObjectType = ShapeType.PolyLine;
                            }
                            else
                            {
                                //面
                                mo.ObjectType = ShapeType.Polygon;
                            }
                        }
                        else
                        {
                            //线
                            mo.ObjectType = ShapeType.PolyLine;
                        }
                        //地图元素点数
                        mo.Points = new System.Drawing.PointF[n];
                        //读取经纬度
                        for (int i = 0; i < n; i++)
                        {
                            PointF ptf = new PointF();
                            line = "";
                            //读入一行,并跳过空行
                            do
                            {
                                line = ws.ReadLine();
                            }
                            while (string.IsNullOrEmpty(line));
                            //分隔数据行
                            items = line.Split(", ".ToCharArray(), StringSplitOptions.RemoveEmptyEntries);
                            //有两项时
                            if (items.Length == 2)
                            {
                                //经纬度
                                ptf.X = Convert.ToSingle(items[0]);
                                ptf.Y = Convert.ToSingle(items[1]);
                                mo.Points[i] = ptf;
                            }
                        }
                        //加入到列表
                        MapObjects.Add(mo);
                    }
                }
                fs.Close();
            }
            _Description = Path.GetFileName(filename);
            return "Success";
        }

        public override string ReadXmlFile(string filename)
        {
            throw new NotImplementedException();
        }

        protected static int z_order = 31;
        public override int Z_Order
        {
            get
            {
                return z_order;
            }
            set
            {
                z_order = value;
            }
        }
    }

    /// <summary>
    /// 地图数据实体类
    /// </summary>
    public class MapModel //: DrawObject
    {
        /// <summary>
        /// 构造函数
        /// </summary>
        public MapModel()
        {
        }

        private ShapeType _ObjectType = 0;
        /// <summary>
        /// 对象类型
        /// </summary>
        public ShapeType ObjectType
        {
            get { return _ObjectType; }
            set { _ObjectType = value; }
        }

        private string _Id;
        /// <summary>
        /// 对象ID
        /// </summary>
        public string Id
        {
            get { return _Id; }
            set { _Id = value; }
        }

        private RectangleF _Rect;
        /// <summary>
        /// 对象最大矩形范围
        /// </summary>        
        public RectangleF Rect
        {
            get
            {
                return _Rect;
            }
            set { _Rect = value; }
        }

        private PointF[] _Points;
        /// <summary>
        /// 对象点数组
        /// </summary>
        public PointF[] Points
        {
            get { return _Points; }
            set { _Points = value; }
        }
    }

    /// <summary>
    /// 地图元素类型
    /// </summary>
    public enum ShapeType : int
    {
        /// <summary>
        /// 空
        /// </summary>
        Null = 0,
        /// <summary>
        /// 点
        /// </summary>
        Point = 1,
        /// <summary>
        /// 线
        /// </summary>
        PolyLine = 3,
        /// <summary>
        /// 面
        /// </summary>
        Polygon = 5,
    };
}

总结一下，显示自定义格式数据时，Addin文件从扩展点路径"/Workspace/DisplayBindings"扩展，指定数据绑定类，代码中，实现数据绑定类接口IlayerDisplayBinding的两个方法，一个方法判断我们的插件是否能识别打开的文件，当文件能打开时，将调用另一个方法打开文件建立新图层，另外，需要新建一个继承C_ChartBase的类，它实现读取文件和绘图功能。

下图为打开bln地图的效果，为了显示更清楚，我隐去了Micaps自带的基础地图：

       海南的bln县界与Micaps叠加：

       其实，Micaps3.2完全没必要自己再定义一套图层显示绑定，直接使用SharpDevelop的IdisplayBinding接口就行了，甚至写一个适配器直接使用Micaps3.1的原有插件。