WorldWind源码剖析系列：下载请求类DownloadRequest

下载请求类DownloadRequest是各种下载请求的抽象基类，先派生出网络下载请求类WebDownloadRequest，再派生出地理空间下载请求类GeoSpatialDownloadRequest（抽象类），再派生出地形下载请求类TerrainDownloadRequest。这些类的类图如下。

 

抽象基类下载请求类DownloadRequest

抽象基类下载请求类DownloadRequest各个字段和属性的含义说明如下：

internal static DownloadQueue Queue;//指定存储该下载请求对象的下载队列对象

object m_owner; //指定该下载请求的拥有者

public abstract string Key//标识该下载请求的惟一字符串键

public object Owner //指定该下载请求的拥有者

public abstract float Progress//指示该下载请求完成的进度，（0,1）之间

public abstract bool IsDownloading//标识该下载请求是否正在被下载

构造函数protected DownloadRequest(object owner)仅仅指定该下载请求的拥有者

虚方法public virtual float CalculateScore()计算下载请求的分值，用来给下载排出优先级，在派生类中北重载以给予优先次序。返回分值，或者当该下载请求不再处于活动时返回float.MinValue

抽象方法public abstract void Start()开始处理该请求，必须被派生类重载

public virtual void OnComplete()派生类需调用该虚方法来发送处理完成信号

网络下载请求类WebDownloadRequest

网络下载请求类WebDownloadRequest各个字段和属性的含义说明如下：

       protected WebDownload download;//网络下载对象

protected static string TemporaryExtension = ".tmp";//网络下载文件临时扩展名

public string SaveFilePath

public override float Progress

public override string Key

public override bool IsDownloading

public override void Start()

public override float CalculateScore()

以上六个成员都是重载父类相对应的成员，详情请参见父类，不再赘述。

构造函数public WebDownloadRequest(object owner)完成给父类的请求拥有者owner成员赋值，同时用空字符串实例化网络下载对象download。重载的构造函数利用给定的下载请求url实例化网络下载对象download。

虚方法protected virtual void InternalDownloadComplete(WebDownload download)需被重载，当下载已经完成时以被通知，内部调用下面的DownloadComplete()虚函数。

虚函数protected virtual void DownloadComplete()需要在派生类中重载，此处未实现任何功能。

地理空间下载请求类GeoSpatialDownloadRequest

地理空间下载请求类GeoSpatialDownloadRequest是个抽象类，各个字段和属性的含义说明如下：

public abstract int Color//标识本图层下载信息的颜色

public abstract float South//当前请求的瓦片的南部边界，10进制的度为单位

public abstract float North//当前请求的瓦片的北部边界，10进制的度为单位

public abstract float East//当前请求的瓦片的东部边界，10进制的度为单位

public abstract float West//当前请求的瓦片的西部边界，10进制的度为单位

构造函数protected GeoSpatialDownloadRequest(object owner, string uri) : base( owner, uri )调用父类的构造函数外，还将下载类型设置为DownloadType.Wms

地形下载请求类TerrainDownloadRequest

地形下载请求类TerrainDownloadRequest各个字段和属性的含义说明如下：

       public TerrainTile TerrainTile;//下载请求所要下载的地形瓦片对象

     const string ContentTypeZip = "application/zip";//标识下载数据内容的压缩类型

       const string ContentType7z = "application/x-7z-compressed";

const string ContentTypeXCompressed = "application/x-compressed";

public abstract int Color//以下五个成员都是重载父类相对应的成员

public abstract float South

public abstract float North

public abstract float East

public abstract float West

public override float CalculateScore()

构造函数public TerrainDownloadRequest(TerrainTile tile, TerrainTileService owner, int row, int col, int targetLevel)利用给定的瓦片对象参数赋值给瓦片变量成员，用给定的瓦片所有者、瓦片行号、瓦片列号、瓦片层级等信息构造网络下载对象的URL字符串。

方法public void DownloadInForeground()在前台下载瓦片数据。处理步骤为：先调用DownloadFile下载数据并存储到指定的目标路径里，接着调用ProcessFile函数处理已下载的数据，如果捕捉到“FileNotFoundException”异常则调用FlagBadTile创建空文件，如果捕捉到“WebException”异常，则根据HttpWebResponse响应情况调用FlagBadTile函数，其它异常则未处理。

虚函数protected override void DownloadComplete()重载祖父类的方法，是瓦片下载完成时的回调函数，内部调用了下面两个方法。当下载完成时先验证数据的有效性。

方法void FlagBadTile()如果服务器没有所请求的数据，则创建一个空文件来标识这个缺失的文件，并发送“由于某种原因当前请求永久性地不可用”的信号，避免用重复的请求敲打服务器发。地形瓦片将会处理移除这个空文件，并重新向服务器发起请求。

方法protected void ProcessFile()根据下载数据内容的压缩类型进行不同的处理。三大类压缩类型具体处理方式为：Zip压缩类型用ICSharpCode.SharpZipLib.dll程序集中FastZip类来处理，7z或XCompressed压缩类型用Process和ProcessStartInfo类启动\System\7za.exe程序来处理。