ArcObjects SDK开发 021 开发框架搭建-FrameWork包设计

时间:2022-12-23 11:12:05

1、框架引擎部分

引擎模块其实就是之前我们说的App-Command-Tool模块,通过这个模块,把系统的主干框架搭建起来。

其中大部分出现在菜单以及工具条上的按钮都会继承这个框架定义ICommand和ITool。整个系统也是通过整合一些列Comand和Tool的方式,把整个系统搭建出来,这点也可以通过我们系统的主窗体代码中看到。

2、常用Command和Tool

一些常用的工具,例如地图放大、缩小、平移等。这些工具要求定义能够被框架引擎识别,并且符合当前使用的UI风格。定义如下。

使用的时候,只需要一行代码即可。

this.UI_Tool_Bar.Items.Add(new BarCheckItemCommandUI(new FrameworkUI.MapTools.MapZoomInTool(this._MapApplication)));
this.UI_Tool_Bar.Items.Add(new BarCheckItemCommandUI(new FrameworkUI.MapTools.MapZoomOutTool(this._MapApplication)));
FrameworkUI.MapTools.MapPanTool myMapPanTool = new FrameworkUI.MapTools.MapPanTool(this._MapApplication);
this.UI_Tool_Bar.Items.Add(new BarCheckItemCommandUI(myMapPanTool));
this._MapApplication.MapPanTool = myMapPanTool;
this._MapApplication.CrruteTool = myMapPanTool;
this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapFullExtentCommand(this._MapApplication)));
this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomInFixedCommand(this._MapApplication)));
this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomOutFixedCommand(this._MapApplication)));
this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomBackCommand(this._MapApplication)));
this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomForwardCommand(this._MapApplication)));

3、通用模块部分

通用模块设计主要包括一些比较通用且核心的模块定义。目前我开发的GeoChem系统定义了三个模块。进度信息模块,Geoprocessor扩展模块和多语言支持模块。

能在Core里面出现的模块,要满足通用性以及核心性两点。我们以最简单的ProcessInfo为例,来说明这样的模块的特性。

配合这个ProcessInfo的是FrameworkUI里面定义的ProcessInfoDialog对话框,定义如下。

设计一,在ProcessInfoDialogHelper使用了一个新线程弹出进度对话框,在主线程进行运算的时候,进度条可以很顺畅的响应进度变化不会卡。

设计二,ProcessInfo定义了SubProcessInfo的概念,可以很好的和子函数衔接。例如一个模型计算,有5个步骤,A(10)、B(30)、C(60)、D(90)、E(100)。其中两个步骤比较复杂,其中B包含3个步骤,B1(20)、B2(80)、B3(100)。D包含了5个步骤,分别是和D1(20)、D2(40)、D3(60)、D4(80)、D5(100)。如何把B和D的计算进度反馈更方便的反馈给计算模型呢?

版本1,不关注B和D的细节了,进度到了A之后,进度条不在动了,只是更新上面的计算信息,等B计算完,一下跳到B该有的进度。D同理。

版本2,加入B是一个专门为本模型定义的一个函数,那么可以把ProcessInfo传入进去,直接设置B1的计算完值为14%,B2计算完之后,设置为26%,B3计算完设置为30%。假如D是一个通用的函数,除了该模块调用,其他模块也会调用,那么可以传ProcessInfo进入,然后再传起始进度值和结束进度值进度。例如调用D,传入ProcessInfo和60、90。计算完D1,设置进度之为60+(90-60)*20%,依次类推。

版本3,设计了SubProcess的概念。当模型调用B的时候,会调用主ProcessInfo,创建一个子ProcessInfo,并设置这个子ProcessInfo应该进度到何值。当子ProcessInfo进度值发生变化的时候,反馈给其父ProcessInfo,由父ProcessInfo计算自己应该前进多少进度。二接收子ProcessInfo的函数,还是设置进度从0-100即可。

调用代码如下。

public void Exe(ProcessInfo pProcessInfo)
{
    //获取栅格CellSize
    pProcessInfo.SetProcess(5, "Get cell size...");
    double myCellSize = GetRasterCellSize();

    //提取栅格数据的范围
    pProcessInfo.SetProcess(10, "Data Extent...");
    string myRasterDomainFile = this.GetRasterDomain();

    //平滑数据
    pProcessInfo.SetProcess(12, "Smooth Data...");
    string myRasterFilePath = this.SmoothData(this.RasterFilePath);

    //生成等值线
    pProcessInfo.SetProcess(20, "ContourList...");
    string myContourLineFile = this.CreateContourLine(myRasterFilePath);

    //调整等值线值的数据精度
    pProcessInfo.SetProcess(25, "Calculate CONTOUR field...");
    this.AdjustAccuracy(myContourLineFile);

    //平滑等值线
    pProcessInfo.SetProcess(30, "SmoothLine...");
    myContourLineFile = this.SmoothContourLine(myContourLineFile, myCellSize);

    //用栅格数据的范围裁切等值线
    pProcessInfo.SetProcess(35, "Clip Contour Line...");
    myContourLineFile = this.ClipContourLineByRasterDomain(myContourLineFile, myRasterDomainFile);

    //根据等值线,生成等值面
    pProcessInfo.SetProcess(40, "Create Contour Polygon");
    pProcessInfo.StartSubProcess(70);
    string myContourPolygonFile = this.GetContourPolygonFile(pProcessInfo.SubProcessInfo, myContourLineFile, myRasterDomainFile);
    pProcessInfo.EndSubProcess();

    //得到切割时使用的 Shape文件
    pProcessInfo.SetProcess(75, "Clip data...");
    this.ClipContourLineAndPolygon(myRasterDomainFile, ref myContourLineFile, ref myContourPolygonFile);

    //删除面积较为小的面
    pProcessInfo.SetProcess(88, "Eliminate Small Area...");
    this.ContourEliminate(ref myContourLineFile, ref myContourPolygonFile);

    //计算极值标注
    pProcessInfo.SetProcess(90, "Create Limite Value Point...");
    this.UpdateThresholdLabel(myContourPolygonFile);

    pProcessInfo.SetProcess(95, "Save Map Document...");
    this.SaveAsMxdFile(myContourLineFile, myContourPolygonFile);
    pProcessInfo.SetProcess(100, "Complete!");
}

使用子进度对象的函数定义如下。

private string GetContourPolygonFile(ProcessInfo pProcessInfo, string pContourLineFile, string pRasterDomainFile)
{
    var myContourPolygonCal = new ContourPCreator
    {
        ContourLineFilePath = pContourLineFile,
        ExtentFilePath = pRasterDomainFile,
        ResultPolygonFilePath = FilePathHelper.GetTempShapeFilePath()
    };
    myContourPolygonCal.Exe(pProcessInfo);
    return myContourPolygonCal.ResultPolygonFilePath;
}

ContourPCreator类的Exe函数定义如下。

public void Exe(ProcessInfo pProcessInfo)
{
    this._PolygonList.Clear();
    this._PolylineList.Clear();

    //把线转换成面
    pProcessInfo.SetProcess(0, "Feature To Polygon...");
    var myPolygonFilePath = FilePathHelper.GetTempShapeFilePath();
    var myFeatureToPolygon = new FeatureToPolygon()
    {
        in_features = this.ContourLineFilePath + ";" + this.ExtentFilePath,
        out_feature_class = myPolygonFilePath,
        cluster_tolerance = "0.001 Meters"
    };
    GPEx myGPEx = new GPEx();
    myGPEx.Execute(myFeatureToPolygon);

    //用栅格范围裁切面
    string myClipOutFilePath = FilePathHelper.GetTempShapeFilePath();
    pProcessInfo.SetProcess(10, "Clip...");
    var myClip = new ESRI.ArcGIS.AnalysisTools.Clip()
    {
        in_features = myPolygonFilePath,
        clip_features = this.ExtentFilePath,
        out_feature_class = myClipOutFilePath
    };
    myGPEx.Execute(myClip);

    //添加字段
    pProcessInfo.SetProcess(20, "Add Field...");
    var myAddField = new AddField
    {
        in_table = myClipOutFilePath,
        field_name = "Value",
        field_type = "DOUBLE"
    };
    myGPEx.ExecuteByGP(myAddField);

    //拷贝结果数据
    ShapeFileHelper.Copy(myClipOutFilePath, this.ResultPolygonFilePath);

    //读取面信息
    pProcessInfo.SetProcess(30, "Init ContourPolygon ...");
    this.LoadContourPolygonList();

    //分析面与面之间的临近关系
    pProcessInfo.SetProcess(40, "Polygon Neighbors ...");
    this.LoadContourPolygonRels();

    //读取等值线的值列表
    pProcessInfo.SetProcess(50, "Read Line Value ...");
    this.LoadContourPolylineList();

    //面与线 临近分析
    pProcessInfo.SetProcess(60, "Load Contour Polygon Line Rels ...");
    this.LoadContourPolygonLineRels();

    //计算等值面值,在此循环,主要是为了避免特殊情况,导致死循环
    pProcessInfo.SetProcess(70, "Cal Contour Polygon Value...");
    for (int i = 0; i < 100; i++)
    {
        int myUnCalCount = this.CalContourPolygonValue();
        if (myUnCalCount == 0)
        {
            break;
        }
    }

    //把计算的值写入该文件中
    pProcessInfo.SetProcess(90, "Write Value To Contour Polygon File...");
    this.WritePolygonValueToFeatureClass();

    //计算完成
    pProcessInfo.SetProcess(100, "Contour Polygon Cal Complete...");
}

因为ProcessInfo是非常核心一个类,使用范围非常广泛,如果把这个定义好了,会让系统非常清晰。这样的话,每个需要暴露进度的函数,值需要定义一个ProcessInfo参数传入进来即可,在函数内部进度从0开始,100结束,其他的都不需要关心了。

4、常用函数库

常用函数库,我一般会定义到Framework程序集的Helper目录下。如果是字段相关的会定义成FieldHelper,空间参考相关的会定义成SpatialReferenceHepler。并且里面大部分都是静态函数,方便直接调用。

在这些里面用的最多的就是FolderPathHelper、ShapeFileHelper、SpatialReferenceHepler以及FeatureClassHelper等。