所以我想利用Brotli,但我不熟悉Python和C++。
我知道有人把它编译成一个Windows.exe。但是,如何将其包装到 DLL 或 .NET 应用可以引用的内容中呢?我知道有IronPython,我是否只是将所有源文件引入IronPython项目并编写一个.NET适配器来调用Brotli API并公开它们?但实际上,我甚至不确定Brotli API是Python还是C++。
看tools/bro.cc
,看起来"入口"方法在encode.c
和decode.c
中被定义为BrotliCompress()
、BrotliDecompressBuffer()
、BrotliDecompressStream()
方法。所以我想可以从C++类编译一个 DLL。
Python的需求,我 https://github.com/smourier/brotli 在这里分叉了原始的brotli源代码,并创建了一个Windows DLL版本,你可以与.NET一起使用。我添加了一个目录,其中包含一个包含两个项目的"WinBrotli"Visual Studio 2015解决方案:
- WinBrotli:一个Windows DLL(x86和x64),包含原始未更改的C/C++ brotli代码。
- Brotli:用C#编写的Windows控制台应用程序(任何CPU),包含WinBrotli的P/Invoke互操作代码。
要重用 Winbrotli DLL,只需将 WinBrotli.x64.dll 和 WinBrotli.x86.dll(您可以在 WinBrotli/binaries 文件夹中找到已经构建的发布版本)复制到 .NET 应用程序旁边,并将 BrotliCompression.cs 文件合并到 C# 项目中(或者如果 C# 不是你最喜欢的语言,则将其移植到 VB 或其他语言)。互操作代码将自动选取与当前进程的位数(X86 或 X64)相对应的正确 DLL。
完成此操作后,使用它就相当简单(输入和输出可以是文件路径或标准 .NET 流):
// compress
BrotliCompression.Compress(input, output);
// decompress
BrotliCompression.Decompress(input, output);
要创建WinBrotli,这是我所做的(对于其他想要使用其他Visual Studio版本的人)
- 创建了一个标准 DLL 项目,删除了预编译标头
- 包括所有编码器和解码器原始 brotli C/C++ 文件(从未更改过其中的任何内容,因此我们可以在需要时更新原始文件)
- 将项目配置为删除对 MSVCRT 的依赖项(因此我们不需要部署其他 DLL)
- 禁用了 4146 警告(否则我们无法编译)
- 添加了一个非常标准的 dllmain.cpp 文件,它没有任何特殊作用
- 添加了一个 WinBrotli.cpp 文件,该文件向外部 Windows 世界公开 brotli 压缩和解压缩代码(具有非常薄的适配层,因此更容易在 .NET 中进行互操作)
- 添加了一个导出 4 个函数的 WinBrotli.def 文件
我将展示一种通过从.NET代码调用python本机库来实现此目的的方法。您需要什么:
- 你需要安装python 2.7(希望这是显而易见的)
-
你需要从源代码编译 brotli。希望这很容易。首先安装 Visual C++ 编译器Microsoft Python 2.7。然后通过
git clone https://github.com/google/brotli.git
克隆brotli存储库并使用python setup.py build_ext
进行编译。完成后,buildlib.win32-2.7
目录中您将找到brotli.pyd
文件。这是python c ++模块 - 我们稍后会用到它。 -
您需要下载pythonnet二进制文件或从源代码编译它。我们在这里使用pythonnet的原因,而不是例如Iron Python,是因为Iron Python不支持原生(C\C++)python模块,而这正是我们在这里所需要的。因此,要从源代码编译,请通过
git clone https://github.com/pythonnet/pythonnet.git
克隆,然后通过python setup.py build
编译。结果你会得到Python.Runtime.dll(在buildlib.win32-2.7
目录中),这就是我们需要的。
完成所有这些操作后,创建控制台项目,引用 Python.Runtime.dll然后:
public static void Main()
{
PythonEngine.Initialize();
var gs = PythonEngine.AcquireLock();
try {
// import brotli module
dynamic brotli = PythonEngine.ImportModule(@"brotli");
// this is a string we will compress
string original = "XXXXXXXXXXYYYYYYYYYY";
// compress and interpret as byte array. This array you can save to file for example
var compressed = (byte[]) brotli.compress(original);
// little trick to pass byte array as python string
dynamic base64Encoded = new PyString(Convert.ToBase64String(compressed));
// decompress and interpret as string
var decompressed = (string) brotli.decompress(base64Encoded.decode("base64"));
// works
Debug.Assert(decompressed == original);
}
finally {
PythonEngine.ReleaseLock(gs);
PythonEngine.Shutdown();
}
Console.ReadKey();
}
然后构建它并将您上面的 brotli.pyc 放在与.exe文件相同的目录中。完成所有这些操作后,您将能够从 .NET 代码压缩和解压缩,如上所示。
提供完整流支持的 Brotli.NET。
- GitHub:https://github.com/XieJJ99/brotli.net/。
- 努格特:https://www.nuget.org/packages/Brotli.NET/。
要将流压缩为 brotli 数据,请执行以下操作:
public Byte[] Encode(Byte[] input)
{
Byte[] output = null;
using (System.IO.MemoryStream msInput = new System.IO.MemoryStream(input))
using (System.IO.MemoryStream msOutput = new System.IO.MemoryStream())
using (BrotliStream bs = new BrotliStream(msOutput, System.IO.Compression.CompressionMode.Compress))
{
bs.SetQuality(11);
bs.SetWindow(22);
msInput.CopyTo(bs);
bs.Close();
output = msOutput.ToArray();
return output;
}
}
要解压缩 brotli 流:
public Byte[] Decode(Byte[] input)
{
using (System.IO.MemoryStream msInput = new System.IO.MemoryStream(input))
using (BrotliStream bs = new BrotliStream(msInput, System.IO.Compression.CompressionMode.Decompress))
using (System.IO.MemoryStream msOutput = new System.IO.MemoryStream())
{
bs.CopyTo(msOutput);
msOutput.Seek(0, System.IO.SeekOrigin.Begin);
output = msOutput.ToArray();
return output;
}
}
若要在 Web 应用程序中支持动态压缩,请在 Global.asax.cs 中添加如下代码:
protected void Application_PostAcquireRequestState(object sender, EventArgs e)
{
var app = Context.ApplicationInstance;
String acceptEncodings = app.Request.Headers.Get("Accept-Encoding");
if (!String.IsNullOrEmpty(acceptEncodings))
{
System.IO.Stream baseStream = app.Response.Filter;
acceptEncodings = acceptEncodings.ToLower();
if (acceptEncodings.Contains("br") || acceptEncodings.Contains("brotli"))
{
app.Response.Filter = new Brotli.BrotliStream(baseStream, System.IO.Compression.CompressionMode.Compress);
app.Response.AppendHeader("Content-Encoding", "br");
}
else
if (acceptEncodings.Contains("deflate"))
{
app.Response.Filter = new System.IO.Compression.DeflateStream(baseStream, System.IO.Compression.CompressionMode.Compress);
app.Response.AppendHeader("Content-Encoding", "deflate");
}
else if (acceptEncodings.Contains("gzip"))
{
app.Response.Filter = new System.IO.Compression.GZipStream(baseStream, System.IO.Compression.CompressionMode.Compress);
app.Response.AppendHeader("Content-Encoding", "gzip");
}
}
}