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程序来处理。

时间: 2024-10-14 10:58:15

WorldWind源码剖析系列:下载请求类DownloadRequest的相关文章

WorldWind源码剖析系列:设置类SettingsBase

PluginSDK中的星球设置类WorldSettings 和WorldWind.程序设置类WorldWindSettings均继承自父类SettingsBase.类图如下所示.其中父类SettingsBase内嵌了枚举型LocationType,子类WorldSettings的定义文件中附带了定义了测量模式的枚举型. 父类SettingsBase主要是对设置文件相关的设置文件名.版本.路径.载入.保存等于文件处理相关的顶层抽象.主要是以XML文件保存的,采用.NET平台提供的XmlSerial

WorldWind源码剖析系列:挂件类Widgets

WorldWindow用户定制控件类中所包含的的挂件类Widgets控件主要有如下图所示的派生类.它们的类图如下所示. 鉴于挂件类Widgets及其派生类,相对简单,基本上都是些利用DirectX3D进行绘图和处理图标纹理影像等的操作,此处不再对各个类的主要的字段.属性和方法进行描述了.感兴趣的读者可以直接阅读源码.建议阅读源码之前读者应具备一定的DirectX3D开发基础. 挂件PictureBox类被WavingFlags.TimeController等插件引擎子类所引用. 挂件Button

WorldWind源码剖析系列:缓冲类Cache

缓冲类Cache主要用于在最小的限制条件下保存从远程服务器通过网络下载下来的地理空间数据,以便当用户处于离线状态时能够使用这些已经缓冲好的数据.Google Earth也采用类似机制处理用户离线浏览漫游问题.该类类图如下. 提供的主要参数设置有:缓冲区上限CacheUpperLimit(默认最大为2GB).缓冲区上限CacheUpperLimit(默认最大为2GB).缓冲区下限CacheLowerLimit(默认上限的75%,即1.5GB).缓冲区目录CacheDirectory.缓冲区清理频率

WorldWind源码剖析系列:角度类

PluginSDK中的角度结构体Angle类图如下所示. 角度结构体主要定义了一个弧度表示角度值的字段:double Radians.还有几个表示角度最大值.最小值.非数值和零角度等字段.定义了一个Degrees属性,分别用数学引擎类的弧度和角度相互转换函数完成Radians字段值的设置与获取. public double Degrees { get { return MathEngine.RadiansToDegrees(this.Radians);} set { this.Radians =

WorldWind源码剖析系列:日志类Log

Utility工程中的日志类Log主要用来输出Debug状态下的调试信息.该类的类图如下: 日志类Log中使用到的类和内嵌结构体类型主要有以下这些: public class LogEventArgs : EventArgs//日志事件参数 { public int level; public string category; public string message; public LogEventArgs(int _l, string _c, string _m) { level = _l

WorldWind源码剖析系列:BMNG类构造函数深入分析

BMNG构造函数深入分析 一.主要类图 二.主要功能: 1)        BMNG类 BMNG类将包含以“Blue Marble”为主题的所有可渲染影像的根节点添加到当前星球的可渲染对象列表中,包括“ \Data\Earth\BmngBathy\”目录下的随源代码发布的12幅图像.从NASA服务器上下载的经过分层分级过的瓦片影像.根节点m_RenderableList主要用来存放下面三个RenderableObjectList类型对象:m_BlueMarbleList.m_ShadedList

WorldWind源码剖析系列:相机类[未完]

PluginSDK中的相机类CameraBase是三维计算机图形学中的概念.观察者在三维场景中漫游时,通过眼睛看到的场景和相机拍摄过程非常一致.实际上,Direct3D和OpenGL都是先通过对现实世界中的场景先进行世界变换,再通过设置观察矩阵以在场景中安置一个虚拟相机,构建一个视景体来裁剪场景的可见区域,然后在通过投影变换(平行投影或透视投影),获取三维场景的“像”,最后再通过视口变换,将场景的“像”光栅化输出到二维显示屏幕上.如下图所示. 在三维地形系统中,通常定义一个虚拟相机来实现对三维场

WorldWind源码剖析系列:四元数类

PluginSDK中的Quaternion4d类可能是感觉Microsoft.DirectX. Quaternion类不太实用或不够用,自己有重新写的. 四元数是英国数学家哈密顿(W.R.Hamilton)在1843年发现的,由于矩阵论的不断丰富和不断完善,人们更乐意采用矩阵来解决实际工程中的问题,这导致四元数在相当长的时间里没有被人们重视,更没有得到实际的应用.随着计算机图形学的发展,人们发现利用四元数可以很好地处理解决旋转运算等问题,这一理论又开始被人们重视,并在许多领域逐渐得到应用. 四元

WorldWind源码剖析系列:星球球体的加载与渲染

WorldWind源码剖析系列:星球球体的加载与渲染 WorldWind中主函数Main()的分析 在文件WorldWind.cs中主函数Main()依次作以下几个事情: 1.  使用System.Version在内部,读取软件版本信息,并格式化输出.我们在外面配置软件版本,“关于”部分中版本自动更改. 获取格式化版本号 // Establish the version number string used for user display, // such as the Splash and 

WorldWind源码剖析系列:星球类World

星球类World代表通用的星球类,因为可能需要绘制除地球之外的其它星球,如月球.火星等.该类的类图如下. 需要说明的是,在WorldWind中星球球体的渲染和经纬网格的渲染时分别绘制的.经纬网格的渲染过程请参见文章<WorldWind源码剖析系列:星球经纬度格网的绘制>,是通过Form.OnPaint()函数激活.刷新和绘制的.星球球体的渲染过程请参见文章<WorldWind源码剖析系列:星球球体的加载与渲染>.而星球类World是绘制过程中从XML配置文件中读取参数构造的用来代表