support chaining calls

Author: LuckyStarry

.gitignore

@@ -0,0 +1,29 @@
+
+#ignore thumbnails created by windows
+Thumbs.db
+#Ignore files build by Visual Studio
+*.obj
+*.exe
+*.pdb
+*.user
+*.aps
+*.pch
+*.vspscc
+*_i.c
+*_p.c
+*.ncb
+*.suo
+*.tlb
+*.tlh
+*.bak
+*.cache
+*.ilk
+*.log
+[Bb]in
+[Dd]ebug*/
+*.lib
+*.sbr
+obj/
+[Rr]elease*/
+_ReSharper*/
+[Tt]est[Rr]esult*

Qiniu/Qiniu.csproj

@@ -20,6 +20,7 @@
     <DefineConstants>DEBUG;TRACE</DefineConstants>
     <ErrorReport>prompt</ErrorReport>
     <WarningLevel>4</WarningLevel>
+    <DocumentationFile>..\bin\Qiniu.XML</DocumentationFile>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
     <DebugType>pdbonly</DebugType>
@@ -48,7 +49,7 @@
     <Reference Include="System.Data" />
     <Reference Include="System.Xml" />
   </ItemGroup>
-  <ItemGroup>    
+  <ItemGroup>
     <Compile Include="Http\HttpCode.cs" />
     <Compile Include="Http\HttpFileType.cs" />
     <Compile Include="Http\HttpFormFile.cs" />
@@ -57,7 +58,7 @@
     <Compile Include="Storage\Model\CdnRefreshResult.cs" />
     <Compile Include="Common\Config.cs" />
     <Compile Include="Common\Zone.cs" />
-	<Compile Include="Common\ZoneHelper.cs" />
+    <Compile Include="Common\ZoneHelper.cs" />
     <Compile Include="Http\CancellationSignal.cs" />
     <Compile Include="Http\CompletionHandler.cs" />
     <Compile Include="Http\HttpResult.cs" />
@@ -85,9 +86,16 @@
     <Compile Include="Storage\UploadOptions.cs" />
     <Compile Include="Storage\UpProgressHandler.cs" />
     <Compile Include="Util\Auth.cs" />
+    <Compile Include="Util\IPersistentOps.cs" />
+    <Compile Include="Util\IPersistentOpsAvthumb.cs" />
+    <Compile Include="Util\IPersistentOpsAvthumbForAudio.cs" />
+    <Compile Include="Util\IPersistentOpsAvthumbForVideo.cs" />
     <Compile Include="Util\Mac.cs" />
     <Compile Include="Util\CRC32.cs" />
+    <Compile Include="Util\PersistentOps.Avthumb.cs" />
+    <Compile Include="Util\PersistentOps.cs" />
     <Compile Include="Util\PutPolicy.cs" />
+    <Compile Include="Util\PutPolicy.Extension.cs" />
     <Compile Include="Util\QETag.cs" />
     <Compile Include="Util\StringUtils.cs" />
   </ItemGroup>

Qiniu/Util/IPersistentOps.cs

@@ -0,0 +1,15 @@
+using System;
+namespace Qiniu.Util
+{
+    /// <summary>
+    /// 表示该对象是一个预处理操作。
+    /// </summary>
+    public interface IPersistentOps
+    {
+        /// <summary>
+        /// 获取操作字符串。
+        /// </summary>
+        /// <returns>操作字符串。</returns>
+        string GetOpsString();
+    }
+}

Qiniu/Util/IPersistentOpsAvthumb.cs

@@ -0,0 +1,30 @@
+using System;
+namespace Qiniu.Util
+{
+    /// <summary>
+    /// 表示该对象是一个音视频转码 (avthumb)操作。
+    /// </summary>
+    public interface IPersistentOpsAvthumb : IPersistentOps
+    {
+        /// <summary>
+        /// A/V 封装格式，具体细节请参考支持转换的封装格式。
+        /// </summary>
+        string Format { get; }
+        /// <summary>
+        /// A/V 指定视频截取的开始时间，单位：秒，支持精确到毫秒，例如3.345s。用于视频截取，从一段视频中截取一段视频。
+        /// </summary>
+        double? SeekStart { set; get; }
+        /// <summary>
+        /// A/V 指定视频截取的长度，单位：秒，支持精确到毫秒，例如1.500s。用于视频截取，从一段视频中截取一段视频。
+        /// </summary>
+        double? Duration { set; get; }
+        /// <summary>
+        /// A/V 是否清除文件的metadata，1为清除，0为保留。
+        /// </summary>
+        int? StripMeta { set; get; }
+        /// <summary>
+        /// 在数据处理命令后用管道符 | 拼接 saveas/<encodedEntryURI> 指令，指示七牛服务器使用EncodedEntryURI格式中指定的 Bucket 与 Key 来保存处理结果。
+        /// </summary>
+        string SaveAs { set; get; }
+    }
+}

Qiniu/Util/IPersistentOpsAvthumbForAudio.cs

@@ -0,0 +1,39 @@
+using System;
+namespace Qiniu.Util
+{
+    /// <summary>
+    /// 表示该对象是一个音频转码 (avthumb)操作。
+    /// </summary>
+    public interface IPersistentOpsAvthumbForAudio : IPersistentOpsAvthumb
+    {
+        /// <summary>
+        /// A 音频码率，单位：比特每秒（bit/s），常用码率：64k，128k，192k，256k，320k等。若指定码率大于原音频码率，则使用原音频码率进行转码。
+        /// </summary>
+        string BitRate { set; get; }
+        /// <summary>
+        /// A 音频质量，取值范围为0-9（mp3），10-500（aac），仅支持mp3和aac，值越小越高。不能与上述码率参数共用。
+        /// </summary>
+        int? AudioQuality { set; get; }
+        /// <summary>
+        /// A 音频采样频率，单位：赫兹（Hz），常用采样频率：8000，12050，22050，44100等。
+        /// </summary>
+        int? SamplingRate { set; get; }
+        /// <summary>
+        /// A 音频编码格式，具体细节请参考支持转换的音频编码格式。
+        /// </summary>
+        string AudioCodec { set; get; }
+        /// <summary>
+        /// A 设置音频的profile等级，支持：aac_he。注：需配合 libfdk_aac 编码方案使用，如 avthumb/m4a/acodec/libfdk_aac/audioProfile/aac_he。
+        /// </summary>
+        string Profile { set; get; }
+        /// <summary>
+        /// A 转码成mp3时是否写入xing header，默认1写入，写入会导致 file，afinfo 等命令识别出错误的码率。好处是在需要音频时长、帧数的时候只需要获取header。
+        /// </summary>
+        string Xing { set; get; }
+        /// <summary>
+        /// A 是否去除音频流，0为保留，1为去除。
+        /// 默认值为0。
+        /// </summary>
+        int? AudioNo { set; get; }
+    }
+}

Qiniu/Util/IPersistentOpsAvthumbForVideo.cs

@@ -0,0 +1,83 @@
+using System;
+namespace Qiniu.Util
+{
+    /// <summary>
+    /// 表示该对象是一个视频转码 (avthumb)操作。
+    /// </summary>
+    public interface IPersistentOpsAvthumbForVideo : IPersistentOpsAvthumb
+    {
+        /// <summary>
+        /// V 视频帧率，每秒显示的帧数，单位：赫兹（Hz），常用帧率：24，25，30等，一般用默认值。
+        /// </summary>
+        int? FrameRate { set; get; }
+        /// <summary>
+        /// V 视频码率，单位：比特每秒（bit/s），常用视频码率：128k，1.25m，5m等。若指定码率大于原视频码率，则使用原视频码率进行转码。
+        /// </summary>
+        string VideoBitRate { set; get; }
+        /// <summary>
+        /// V 视频编码格式，具体细节请参考支持转换的视频编码格式。
+        /// </summary>
+        string VideoCodec { set; get; }
+        /// <summary>
+        /// V 字幕编码方案，支持方案：mov_text。该参数仅用于修改带字幕视频的字幕编码。
+        /// </summary>
+        string SubtitleCodec { set; get; }
+        /// <summary>
+        /// V 添加字幕，支持：srt格式字幕（uft-8编码和和utf-8 BOM编码）、带有字幕的mkv文件、embed（将原视频的字幕流嵌入目标视频）。基于URL安全的base64编码。
+        /// </summary>
+        string SubtitleURL { set; get; }
+        /// <summary>
+        /// V 指定视频分辨率，格式为<width>x<height>或者预定义值，width 取值范围 [20,3840]，height 取值范围 [20,2160]。
+        /// </summary>
+        string Resolution { set; get; }
+        /// <summary>
+        /// V 配合参数/s/使用，指定为1时，把视频按原始比例缩放到/s/指定的矩形框内，0或者不指定会强制缩放到对应分辨率，可能造成视频变形。
+        /// </summary>
+        int? Autoscale { set; get; }
+        /// <summary>
+        /// V 该参数为视频在播放器中显示的宽高比，格式为<width>:<height>。例如：取值3:4表示视频在播放器中播放是宽:高=3:4（注：此处取值仅为体现演示效果）。
+        /// </summary>
+        string Aspect { set; get; }
+        /// <summary>
+        /// V 设置h264的crf值，整数，取值范围[18,28]，值越小，画质更清晰。注意：不可与vb共用
+        /// </summary>
+        int? H264Crf { set; get; }
+        /// <summary>
+        /// V 指定顺时针旋转的度数，可取值为90、180、270、auto，默认为不旋转。
+        /// </summary>
+        int? Degree { set; get; }
+        /// <summary>
+        /// V 水印图片的源路径，目前仅支持远程路径，需要经过urlsafe_base64_encode。水印具体介绍见视频水印。
+        /// </summary>
+        string EncodedRemoteImageUrl { set; get; }
+        /// <summary>
+        /// V 视频图片水印位置，存在/wmImage/时生效。
+        /// </summary>
+        string Gravity { set; get; }
+        /// <summary>
+        /// V 水印文本内容,需要经过urlsafe_base64_encode。
+        /// </summary>
+        string EncodedText { set; get; }
+        /// <summary>
+        /// V 文本位置（默认NorthEast）
+        /// </summary>
+        string GravityText { set; get; }
+        /// <summary>
+        ///  V 文本字体，需要经过urlsafe_base64_encode，默认为黑体,注意：中文水印必须指定中文字体。
+        /// </summary>
+        string Font { set; get; }
+        /// <summary>
+        /// V 水印文字颜色，需要经过urlsafe_base64_encode，RGB格式，可以是颜色名称（例如红色）或十六进制（例如#FF0000），参考RGB颜色编码表，默认为黑色。
+        /// </summary>
+        string FontColor { set; get; }
+        /// <summary>
+        ///  V 水印文字大小，单位: 缇，等于1/20磅，默认值0（默认大小）
+        /// </summary>
+        int? FontSize { set; get; }
+        /// <summary>
+        /// V 是否去除视频流，0为保留，1为去除。
+        /// 默认值为0。
+        /// </summary>
+        int? VideoNo { set; get; }
+    }
+}