21 |
22 |
30 |
31 | The default compression used is deflate, then gzip, as deflate should be faster.
32 | This also supports streaming responses. The config allows you to disable deflate and streaming if you prefer.
33 |
34 |
35 | eTag-caching
36 | ----------
37 |
38 | 1. When the server reads the content before compression, it calculates a hash-code over it.
39 | 2. The hash-code is sent as ETag response header to the client with the response
40 | 3. The next time the client asks for the same resource, it sends an If-None-Match header in the request with the same value.
41 | 4. After the server reads the content before the compression, it calculates a hash-code over it. If it matches the If-None-Match of the request, the server can skip the compression and skip the sending and just send http status code 304 to the client which means "use what you have, it's not modified since".
42 |
43 |
44 | Example #1
45 | ----------
46 |
47 | This example demonstrates using MapCompressionModule-function defined in this sample library.
48 |
49 | ```csharp
50 | using System;
51 | using Owin;
52 | [assembly: Microsoft.Owin.OwinStartup(typeof(MyServer.MyWebStartup))]
53 | namespace MyServer
54 | {
55 | class MyWebStartup
56 | {
57 | public void Configuration(Owin.IAppBuilder app)
58 | {
59 | // This will compress the whole request, if you want to use e.g. Microsoft.Owin.StaticFiles server:
60 | // app.UseCompressionModule()
61 |
62 | var settings = OwinCompression.DefaultCompressionSettingsWithPath("c:\\temp\\"); //" server path
63 | //or var settings = new CompressionSettings( ... )
64 | app.MapCompressionModule("/zipped", settings);
65 | }
66 | }
67 |
68 | class Program
69 | {
70 | static void Main(string[] args)
71 | {
72 | Microsoft.Owin.Hosting.WebApp.Start
23 |
28 |
29 |
24 | The Owin.Compression library can be installed from NuGet:
25 |
27 | PM> Install-Package Owin.Compression26 |
83 |
84 | Even though the browser sees everything as plain text, the traffic is actually transferred in compressed format.
85 | You can monitor the traffic with e.g. Fiddler.
86 |
87 | Example #2
88 | ----------
89 |
90 | Running on OWIN Self-Host (Microsoft.Owin.Hosting) with static files server (Microsoft.Owin.StaticFiles)
91 | and compressing only the ".json"-responses (and files) on-the-fly, with only gzip and not deflate:
92 |
93 | ```csharp
94 | using System;
95 | using Owin;
96 | [assembly: Microsoft.Owin.OwinStartup(typeof(MyServer.MyWebStartup))]
97 | namespace MyServer
98 | {
99 | class MyWebStartup
100 | {
101 | public void Configuration(Owin.IAppBuilder app)
102 | {
103 | var settings = new CompressionSettings(
104 | serverPath: "",
105 | allowUnknonwnFiletypes: false,
106 | allowRootDirectories: false,
107 | cacheExpireTime: Microsoft.FSharp.Core.FSharpOption