Core - Add StreamResponseFilter

- Moved from the Cefsharp.Example.Filters.StreamResponseFilter
- Added CanWrite checks in InitFilter
- Updated example to reflect namespace change.

CefSharp.Example/CefSharp.Example.csproj

@@ -81,7 +81,6 @@
     <Compile Include="Filters\FindReplaceMultiResponseFilter.cs" />
     <Compile Include="Filters\FindReplaceResponseFilter.cs" />
     <Compile Include="Filters\ExperimentalStreamResponseFilter.cs" />
-    <Compile Include="Filters\StreamResponseFilter.cs" />
     <Compile Include="FlashResourceHandler.cs" />
     <Compile Include="Filters\PassThruResponseFilter.cs" />
     <Compile Include="Handlers\BrowserProcessHandler.cs" />

CefSharp.Example/Handlers/ExampleResourceRequestHandler.cs

@@ -7,6 +7,7 @@
 using System.Text;
 using CefSharp.Example.Filters;
 using CefSharp.Handler;
+using CefSharp.ResponseFilter;
 
 namespace CefSharp.Example.Handlers
 {

CefSharp/CefSharp.csproj

@@ -148,6 +148,7 @@
     <Compile Include="RenderProcess\IV8Context.cs" />
     <Compile Include="RenderProcess\V8Exception.cs" />
     <Compile Include="RequestContextExtensions.cs" />
+    <Compile Include="ResponseFilter\StreamResponseFilter.cs" />
     <Compile Include="Structs\TouchEvent.cs" />
     <Compile Include="V8Extension.cs" />
     <Compile Include="CefLibraryHandle.cs" />

CefSharp.Example/Filters/StreamResponseFilter.cs → CefSharp/ResponseFilter/StreamResponseFilter.cs

@@ -5,30 +5,29 @@
 using System;
 using System.IO;
 
-namespace CefSharp.Example.Filters
+namespace CefSharp.ResponseFilter
 {
     /// <summary>
     /// StreamResponseFilter - copies all data from IResponseFilter.Filter
-    /// to the provided Stream. This is provided as an example to get you started and has not been
-    /// production tested. If you experience problems you should refer to the CEF documentation
-    /// and ask any questions you have on http://magpcss.org/ceforum/index.php
-    /// Make sure to ask your question in the context of the CEF API (remember that CefSharp is just a wrapper).
-    /// https://magpcss.org/ceforum/apidocs3/projects/(default)/CefResponseFilter.html#Filter(void*,size_t,size_t&,void*,size_t,size_t&)
+    /// to the provided Stream. The <see cref="Stream"/> must be writable, no data will be copied otherwise.
+    /// The StreamResponseFilter will release it's reference (set to null) to the <see cref="Stream"/> when it's Disposed.
     /// </summary>
     public class StreamResponseFilter : IResponseFilter
     {
         private Stream responseStream;
 
+        /// <summary>
+        /// StreamResponseFilter constructor
+        /// </summary>
+        /// <param name="stream">a writable stream</param>
         public StreamResponseFilter(Stream stream)
         {
             responseStream = stream;
         }
 
         bool IResponseFilter.InitFilter()
         {
-            //Will only be called a single time.
-            //The filter will not be installed if this method returns false.
-            return true;
+            return responseStream != null && responseStream.CanWrite;
         }
 
         FilterStatus IResponseFilter.Filter(Stream dataIn, out long dataInRead, Stream dataOut, out long dataOutWritten)