uHttpSharp 项目启动与配置教程

uHttpSharp 项目启动与配置教程

uHttpSharp A very lightweight & simple embedded http server for c# 项目地址: https://gitcode.com/gh_mirrors/uht/uHttpSharp

1. 项目目录结构及介绍

uHttpSharp 是一个轻量级且简单的嵌入式 HTTP 服务器，适用于 C#。以下是项目的主要目录结构及其介绍：

• .ci/: 包含持续集成配置文件。
• .nuget/: 存放 NuGet 包管理相关的文件。
• uhttpsharp-demo/: 演示如何使用 uHttpSharp 的示例项目。
• uhttpsharp.Tests/: 包含对 uHttpSharp 的单元测试。
• uhttpsharp/: 主项目目录，包含源代码和资源文件。
  • Properties/: 存放项目属性和设置。
  • bin/: 编译后的输出文件存放目录。
  • obj/: 编译时的中间文件存放目录。
• LICENSE.txt: 项目使用的 LGPL-2.1 许可证文件。
• README.md: 项目说明文件。
• uhttpsharp.sln: 解决方案文件，用于在 Visual Studio 中打开项目。

2. 项目的启动文件介绍

项目的主要启动文件是 uhttpsharp.sln，它是一个 Visual Studio 解决方案文件，可以用来加载整个项目。打开这个文件后，你会看到以下项目：

• uHttpSharp: 主项目，包含了 HTTP 服务器的核心代码。
• uHttpSharp.Tests: 测试项目，包含了针对核心功能的单元测试。

要启动服务器，你可以在 Visual Studio 中直接运行 uHttpSharp 项目。或者，你也可以通过命令行编译并运行 uhttpsharp 目录中的代码。

以下是一个简单的命令行示例，它创建了一个 HTTP 服务器实例：

using (var httpServer = new HttpServer(new HttpRequestProvider()))
{
    httpServer.Use(new TcpListenerAdapter(new TcpListener(IPAddress.Loopback, 80)));
    httpServer.Use((context, next) => {
        Console.WriteLine("Got Request!");
        return next();
    });
    httpServer.Start();
    Console.ReadLine();
}

3. 项目的配置文件介绍

uHttpSharp 的配置主要是通过代码进行，而不是通过外部配置文件。在项目中，你可以通过添加不同的处理器（Handler）来配置服务器的行为。以下是一些常用的处理器：

• TimingHandler: 用于记录请求处理时间。
• HttpRouter: 用于路由请求到不同的处理类。
• FileHandler: 用于处理静态文件请求。
• ErrorHandler: 用于处理错误。

配置服务器时，你可以按照需要链式地添加这些处理器。例如：

httpServer.Use(new TimingHandler());
httpServer.Use(new HttpRouter().With(string.Empty, new IndexHandler()).With("about", new AboutHandler()));
httpServer.Use(new FileHandler());
httpServer.Use(new ErrorHandler());

以上代码将配置服务器以处理根路径的请求，将它们路由到 IndexHandler 类，处理 /about 路径的请求，将它们路由到 AboutHandler 类，同时处理静态文件请求和错误。

如果你需要更复杂的配置，如 SSL 支持，你需要创建或加载一个证书，并将其应用到服务器中：

var serverCertificate = X509Certificate.CreateFromCertFile(@"TempCert.cer");
httpServer.Use(new ListenerSslDecorator(new TcpListenerAdapter(new TcpListener(IPAddress.Loopback, 443)), serverCertificate));

这样，你就可以根据实际需求配置和启动 uHttpSharp 服务器了。

uHttpSharp A very lightweight & simple embedded http server for c# 项目地址: https://gitcode.com/gh_mirrors/uht/uHttpSharp