Refit C#（對於開發者的運行原理）

類型安全的API可用性

Refit在編譯時檢測錯誤並確保方法簽名與API端點匹配。 這種類型安全降低了由不匹配的端點或不正確的請求配置引起的運行時錯誤的可能性。

HTTP客戶端聲明式

開發人員可以使用C#界面和屬性來構建API端點，從而生成更清晰、更可維護的HTTP請求代碼。 這種聲明式方法抽象化了為每個客戶端實現HTTP請求方法的複雜性。

自動序列化和反序列化

Refit自動處理C#對象到JSON數據的轉換。 由於開發人員不再需要手動序列化請求主體或反序列化回應，數據處理變得更加簡單。

基於屬性的配置

屬性用於定義HTTP方法（比如GET、POST、PUT和DELETE）和參數。 由於它包含標頭、請求主體、內容、路徑參數和查詢參數，因此使配置簡單且易於理解。

異步程式設計支援

Refit使用基於任務的方法來處理異步HTTP請求，並設計為能夠與.NET中的異步程式設計模型輕鬆互動。

可調適的Web瀏覽器

開發人員可以通過更改超時數字、默認標頭設置以及用於日誌記錄、身份驗證和重試策略的消息處理器配置來自定義核心HTTP客戶端。

集成的錯誤管理

Refit具有內置功能來處理HTTP問題，使開發人員可以輕鬆集成自己的自定義錯誤處理邏輯。

適應性

開發人員可以使用Refit對自定義序列化和反序列化轉換器的支援來利用多種格式或處理不尋常的數據類型。

結合依賴性注入整合

對於遵循依賴性注入（DI）推薦實踐的現代.NET應用程式來說，Refit適合在DI應用中整合。

驗證的協助

要保護API調用，Refit使配置認證標頭、界面方法如承載令牌和基本身份驗證變得簡單。

使用Visual Studio建立Console專案很容易。 要在Visual Studio中創建Console應用程式，請按照下列步驟操作：

在使用Visual Studio之前，請確認已在您的電腦上安裝。

啟動新專案

打開Visual Studio，點擊"創建新專案"選項。

在"創建新專案"框的左側選擇您喜歡的程式設計語言（例如C#）。

從後續的專案範本參考列表中，您可以選擇"Console App"或"Console App (.NET Core)"模板。

給您的專案命名，並選擇專案的儲存位置。

選擇適當的.NET Framework。 然後點擊"創建"以創建Console應用專案。

創建一個介面來表示您的API。 使用Refit屬性定義HTTP方法和端點。

using Refit;
using System.Threading.Tasks;

// Define the API interface
public interface IMyApi
{
    // Get user details by ID
    [Get("/users/{id}")]
    Task<User> GetUserAsync(int id);

    // Create a new user
    [Post("/users")]
    Task<User> CreateUserAsync([Body] User user);
}

// Define the User class
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    // Other properties...
}

using Refit;
using System.Threading.Tasks;

// Define the API interface
public interface IMyApi
{
    // Get user details by ID
    [Get("/users/{id}")]
    Task<User> GetUserAsync(int id);

    // Create a new user
    [Post("/users")]
    Task<User> CreateUserAsync([Body] User user);
}

// Define the User class
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    // Other properties...
}

創建和配置Refit客戶端

啟動Refit客戶端並根據需要調整其設置。 這可以直接在您的主代碼中或在應用中的其他位置實施，例如服務。

using Refit;
using System;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        // Define the base URL of your API
        var apiClient = RestService.For<IMyApi>("https://api.example.com");

        // Use the API client to make requests
        var user = await apiClient.GetUserAsync(1);
        Console.WriteLine($"User ID: {user.Id}, Name: {user.Name}");

        // Create a new user
        var newUser = new User { Name = "John Doe" };
        var createdUser = await apiClient.CreateUserAsync(newUser);
        Console.WriteLine($"Created User ID: {createdUser.Id}, Name: {createdUser.Name}");
    }
}

using Refit;
using System;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        // Define the base URL of your API
        var apiClient = RestService.For<IMyApi>("https://api.example.com");

        // Use the API client to make requests
        var user = await apiClient.GetUserAsync(1);
        Console.WriteLine($"User ID: {user.Id}, Name: {user.Name}");

        // Create a new user
        var newUser = new User { Name = "John Doe" };
        var createdUser = await apiClient.CreateUserAsync(newUser);
        Console.WriteLine($"Created User ID: {createdUser.Id}, Name: {createdUser.Name}");
    }
}

進階配置

透過設置底層HttpClient，您可以進一步個性化Refit客戶端。 例如，您可以設置超時、應用標頭屬性、添加默認標頭或使用消息處理器進行重試策略、身份驗證和日誌記錄。

using System.Net.Http;
using Refit;
using System;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        // Configure HttpClient with custom handler and timeout
        var httpClient = new HttpClient(new HttpClientHandler
        {
            // Customize the HttpClientHandler as needed
        })
        {
            BaseAddress = new Uri("https://api.example.com"),
            Timeout = TimeSpan.FromSeconds(30)
        };

        // Add default headers if needed
        httpClient.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_TOKEN_HERE");

        // Create the Refit API client
        var apiClient = RestService.For<IMyApi>(httpClient);

        // Use the API client to make requests
        var user = await apiClient.GetUserAsync(1);
        Console.WriteLine($"User ID: {user.Id}, Name: {user.Name}");

        // Create a new user
        var newUser = new User { Name = "John Doe" };
        var createdUser = await apiClient.CreateUserAsync(newUser);
        Console.WriteLine($"Created User ID: {createdUser.Id}, Name: {createdUser.Name}");
    }
}

using System.Net.Http;
using Refit;
using System;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        // Configure HttpClient with custom handler and timeout
        var httpClient = new HttpClient(new HttpClientHandler
        {
            // Customize the HttpClientHandler as needed
        })
        {
            BaseAddress = new Uri("https://api.example.com"),
            Timeout = TimeSpan.FromSeconds(30)
        };

        // Add default headers if needed
        httpClient.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_TOKEN_HERE");

        // Create the Refit API client
        var apiClient = RestService.For<IMyApi>(httpClient);

        // Use the API client to make requests
        var user = await apiClient.GetUserAsync(1);
        Console.WriteLine($"User ID: {user.Id}, Name: {user.Name}");

        // Create a new user
        var newUser = new User { Name = "John Doe" };
        var createdUser = await apiClient.CreateUserAsync(newUser);
        Console.WriteLine($"Created User ID: {createdUser.Id}, Name: {createdUser.Name}");
    }
}

您可以按照以下說明在C#中創建和配置Refit客戶端，從而使用類型安全且可維護的RESTful API消耗。

將HTML轉換為PDF

IronPDF允許使用您可以使用HTML內容創建高品質的PDF文檔，包括CSS和JavaScript。 此功能非常有用，適用於從動態內容或網頁創建PDF。

編輯和操作PDFs

IronPDF提供了現有PDF文檔的修改工具。可以從PDF中提取頁面、添加文字、圖像、水印或註釋，並將多個PDF合併成一個文檔。

從頭開始創建PDF

使用IronPDF的API，您可以程式化地向新的PDF文檔中添加文字、圖像、形狀和其他對象。 這使得動態生成PDF發票、報告和其他基於文檔的輸出成為可能。

PDF的安全性

您可以使用IronPDF加密PDF文件並添加密碼保護來管理訪問和保護重要數據。

PDF的表單

用戶可以透過將數據放入表單字段來與PDF文檔互動，從而使用IronPDF創建和填寫PDF表單。

文字提取

IronPDF透過從PDF文檔中提取文字內容，方便的進行文字數據的簡單搜索、分析和操作。

轉換為圖片格式

IronPDF適用於需要圖像而非PDF情況，因為它可以將PDF文檔轉換成常見的圖像格式，包括PNG、JPEG和BMP。