在现代的 Web 应用程序中，必须处理大量数据流和网络请求。其中最重要的是 URL 请求和响应，以及与它们相关的数据和元数据。

如果不妥善处理 URL 管理，则很容易失去对网络和服务器的完全控制，从而降低应用程序的可维护性和可扩展性。

所以，现代 Web 应用程序需要一个强大、智能的 URL 处理工具。

凭借着强大的 .NET 基础设施，我们已经能够从免费、开源的 Flurl 库中获得这样的工具，它是完美的 URL 处理解决方案。

## Flurl: 简介

Flurl 是一个 .NET 库，用于简化和统一所有与 URL 相关的通信操作。它是基于 [Fluent 风格](https://zh.wikipedia.org/zh-hans/流接口) 的，可以更轻松地构建 URL，管理参数以及执行 HTTP 请求和响应。

现在，让我们深入了解 Flurl，并看看它在 URL 处理中的真正能力和灵活性。

## 支持所有主流平台

Flurl 使用了 .NET Standard，这意味着它可以在几乎所有主流操作系统上工作，包括 Windows、Linux、MacOS 和移动平台（如 Android 和 iOS）。

此外，Flurl 还具有良好的可移植性，因此可以很容易地在不同的 .NET 后端中使用，包括 ASP.NET Core、WPF、Windows Forms 等。

## 极易上手

Flurl 的语法普遍易懂，并且构建 URL 的方法已经得到大量的标准化。例如，将基准 URL（一个字符串）添加到请求或响应时，可以使用相同的代码模式。

以下是一些主要的 Flurl 语法：

```csharp

using Flurl.Http;

// 创建基准 URL

var baseUrl = "https://www.example.com/api/";

// 发送 GET 请求

var response = await baseUrl.AppendPathSegment("users")

.SetQueryParam("id", 1)

.WithHeader("authorization", "Bearer " + authToken)

.GetAsync();

// 发送 POST 请求

var body = new { username = "exampleuser", password = "password123" };

var newUser = await baseUrl.AppendPathSegment("register")

.WithHeader("Content-Type", "application/json")

.WithHeader("authorization", "Bearer " + authToken)

.PostJsonAsync(body)

.ReceiveJson();

```

## 轻松构建 URL

在 Flurl 中构建 URL 极为简单。我们可以通过修改字符串得到与之关联的新 URL。例如，以下是一个使用 `.AppendPathSegment()` 方法扩展 URL，增加路径片段的示例：

```csharp

var url = "https://www.example.com/api/";

var path = "users";

var pathWithId = path + "/1";

var fullUrl = url.AppendPathSegment(path).AppendPathSegment(1);

var fullUrl2 = url.AppendPathSegments(pathWithId.Split('/'));

```

请注意，在第二个示例中，路径字符被使用 `.Split()` 方法分离，以便按顺序把它们添加到 URL 中（以获得正确的目标路径）。

## 管理 URL 参数

在 Flurl 中，可以轻松地管理 URL 参数。以下示例演示了如何通过添加查询字符串参数到 URL，从而构建新的 URL：

```csharp

var url = "https://www.example.com/api/";

var allParamsUrl = url.SetQueryParams(new {

searchQuery = "example",

userId = 123

});

var multipleParamsUrl = url

.SetQueryParam("searchQuery", "example")

.SetQueryParam("userId", 123);

```

除了 `.SetQueryParam()` 方法外，还有其他许多方法可以帮助我们轻松处理 URL 参数。例如，以下代码段演示了如何将 URL 参数解析为对象：

```csharp

var urlWithParams = "https://www.example.com/api/users?userId=1&limit=10";

var queryDict = urlWithParams

.Split('?')[1]

.Split('&')

.Select(x => x.Split('='))

.ToDictionary(x => x[0], x => x[1]);

var searchParams = new SearchParameters {

UserId = int.Parse(queryDict["userId"]),

Limit = int.Parse(queryDict["limit"])

};

```

## 发送 HTTP 请求

Flurl 还提供了一组优秀的方法，可以轻松地发送 HTTP 请求并获取响应。例如，以下示例演示了如何对某个 API 进行 HTTP GET 请求：

```csharp

var response = await "https://www.example.com/api/users"

.SetQueryParam("id", 1)

.WithHeader("authorization", "Bearer " + authToken)

.GetAsync();

if (response.IsSuccessStatusCode) {

var user = await response.Content.ReadAsAsync();

Console.WriteLine("User read: " + user.Username);

}

```

我们使用了 `.SetQueryParam()` 方法，并在请求头中添加了一个 OAuth2 Bearer Token。针对响应，我们可以先检查状态代码是否为 2xx，然后从 `Content` 属性中读取输出。

## JSON 解析支持

在许多 Web 应用程序中，我们需要发送和接收 JSON 数据。幸运的是，Flurl 是完美的 JSON 解析支持解决方案。

例如，以下代码示例演示了如何使用 Flurl 将 JSON 响应转换成对象：

```csharp

public class User {

public int Id { get; set; }

public string Username { get; set; }

}

var response = await "https://www.example.com/api/users/1"

.GetJsonAsync();

Console.WriteLine("User found: " + response.Username);

```

此外，Flurl 还支持通过 XML 序列化器（例如 `System.Xml.Serialization.XmlSerializer`）解析 XML 响应。

## 异常处理

网络通信可能出现异常，这是常见的情况。例如，HTTP 响应代码可能不是 2xx，或者响应内容格式不正确。

幸运的是，Flurl 抛出异常，以便在请求失败时查找问题。以下代码示例演示了如何使用 Flurl 处理 HTTP 响应无法解析（例如响应不是有效的 JSON）的情况：

```csharp

var response = await url

.AppendPathSegment("users/1")

.WithHeader("authorization", "Bearer " + authToken)

.PostJsonAsync(someUser)

.ReceiveString();

try {

var userJson = JObject.Parse(response);

Console.WriteLine("User saved with ID " + userJson["id"]);

}

catch (JsonException ex) {

Console.Error.WriteLine("Failed to parse JSON response: " + ex.Message);

}

```

如代码中所示，我们可以对 Flurl 异常进行适当的捕获和处理，以便更好地管理 HTTP 响应。

## 结论

到目前为止，Flurl 是处理 URL 表示和网络通信的优秀方式。通过其简单、标准化的语法和丰富的功能集，我们可以完全掌控 URL 表达式和网络请求的参数。

如果您现在正在开发 Web 应用程序，无论是 ASP.NET Core 还是其他 .NET 后端，Flurl 都是一个必不可少的工具。与其它 URL 处理库相比，Flurl 更易用和易学，并提供良好的可扩展性和可维护性，让您的应用程序始终掌握在自己的手中。