C#编程总结（十二）断点续传

我们经常使用下载工具，如bit精灵、迅雷、FlashGet，这些软件都支持断点续传。

断点续传即下载任务暂停后可以继续，而无需重新下载，即下载时需要通知服务器的起始位置。如果允许多线程进行分片下载，必须提供起始-截止位置。说到底就是可以选择下载某个片段，整个文件的字节流，可以截取流的片段，也能实现流的累积，最终完成文件下载。

一、原理

在 HTTP/1.1里新增的一个头属性：Range，也是现在众多号称多线程下载工具（如 FlashGet、迅雷等）实现多线程下载的核心所在。老版本的HTTP协议不支持，所以一些老的服务器还不支持断点续传。

Range（请求参数）

用于请求头中，指定第一个字节的位置和最后一个字节的位置，一般格式：

Range:(unit=first byte pos)-[last byte pos]

例如：Range:100-199，取文件流的100至199之间的字节。

Range:100,取位置为100后的所有字节。如果range 为正值，服务器应该开始发送从指定的 range 参数到 HTTP 实体中数据的末尾之间的数据。

Range:-99,取开始的100个字节。如果range 为负值，服务器应该开始发送从 HTTP 实体中数据的开头到指定的 range 参数之间的数据。

Content-Range （响应参数）

用于响应头，指定整个实体中的一部分的插入位置，他也指示了整个实体的长度。在服务器向客户返回一个部分响应，它必须描述响应覆盖的范围和整个实体长度。

一般格式：　　

Content-Range: bytes (unit first byte pos) - [last byte pos]/[entity legth]

例如：Content-Range: bytes 1024000-1126399/7421120

HTTP协议：http://www.w3.org/Protocols/rfc2616/rfc2616.html

二、C#中实现

在C#中使用AddRange方法向请求添加指定范围的字节范围标头

System.Net.HttpWebRequest

所有的方法：

常用的方法为例：

void AddRange(long from, long to);
指定范围起始、终止位置，来请求该片段的数据。

        // 摘要:

        //     向请求添加指定范围的字节范围标头。

        //

        // 参数:

        //   from:

        //     开始发送数据的位置。

        //

        //   to:

        //     停止发送数据的位置。

        public void AddRange(long from, long to);

我们通过该方法，基于HTTP协议实现了断点续传，支持暂停、继续下载功能，为了更清晰显示效果，提供了进度条显示。效果图：

Request

请求的Range参数，我们可以清晰看到起具体值，这就是请求的片段。在这里可以清晰的看到HTTP协议版本、请求方法、请求地址等信息

Response

服务器根据请求的Range参数，只返回该片段的数据。我们可以清晰看到Content-Range的具体值。

注意：返回的StatusCode变为了PartialContent，说明是部分数据。

代码含义
200 OK 请求成功返回
206 Partial Content 部分数据

下载的核心代码：

        /// <summary>

        /// 下载

        /// </summary>

        public void Download()

        {

            //从0计数，需要减一

            long from = this.currentSize;

            if (from < )

            {

                from = ;

            }

            long to = this.currentSize + this.step - ;

            if (to >= this.totalSize && this.totalSize > )

            {

                to = this.totalSize - ;

            }

            this.Download(from, to);

        }

        /// <summary>

        /// 下载

        /// </summary>

        /// <param name="url"></param>

        /// <param name="range"></param>

        public void Download(long from,long to)

        {

            if (this.totalSize == )

            {

                GetTotalSize();

            }

            if (from >= this.totalSize || this.currentSize >= this.totalSize)

            {

                this.isFinished = true;

                return;

            }

            HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);

            //request.Method = "GET";

            request.AddRange("bytes", from, to);

            HttpWebResponse response = (HttpWebResponse)request.GetResponse();

            string result = string.Empty;

            if (response != null)

            {

                byte[] buffer = this.Buffer;

                using (Stream stream = response.GetResponseStream())

                {

                    int readTotalSize = ;

                    int size = stream.Read(buffer, , buffer.Length);

                    while (size > )

                    {

                        //只将读出的字节写入文件

                        fs.Write(buffer, , size);

                        readTotalSize += size;

                        size = stream.Read(buffer, , buffer.Length);

                    }

                    //更新当前进度

                    this.currentSize += readTotalSize;

                    //如果返回的response头中Content-Range值为空，说明服务器不支持Range属性，不支持断点续传,返回的是所有数据

                    if (response.Headers["Content-Range"] == null)

                    {

                        this.isFinished = true;

                    }

                }

            }

        }

项目源码：

http://files.cnblogs.com/yank/DownloadSample.rar

三、多线程下载

上述例子提供了简单的断点续传功能，如果想再进一步实现多线程下载。原理很简单，我们只需根据所要下载的文件大小，进行分块，没块启动一个线程进行下载，线程只负责下载自己负责的片段，一定要严格设置Range的值。具体实现这里不再介绍，如有兴趣，下来可以继续研究。

提醒一下：多线程下载的字节流如何保存为文件，是否必须按照先后顺序？