Grapevine .NET（開發者使用指南）

什麼是 C#？

在 Grapevine 這個 C# 微型 Web 框架的協助下，可以建立輕量、快速、適應性強的 RESTful Web 服務和 API。 它非常適合需要有效處理 HTTP 請求的微小專案、原型和微服務，這都歸功於它簡單的模式和基本架構，保證了快速的設定和優異的效能。

Grapevine 透過提供彈性且易於使用的路由機制，讓識別和管理端點的過程變得更容易。 它透過支援多種 HTTP 方法（包括 GET、POST、PUT 和 DELETE），簡化了 CRUD 操作和組織良好的 RESTful API 的建立。 它也支援中間件，讓程式設計師能夠透過建立自訂元件來增加更多功能，如記錄、驗證和錯誤處理。

由於此架構遵循 REST 原則，因此開發人員可以建立可擴充且可靠的 API。它的簡單性及易用性使其成為需要快速建立原型並啟動 Web 服務的開發人員的最佳選擇，而無需處理大型框架的複雜性。 輕量級的設計使 Grapevine 適用於不需要複雜 Web 框架的微服務和應用程式。

dotnet new console -n GrapevineExample
cd GrapevineExample

dotnet new console -n GrapevineExample
cd GrapevineExample

dotnet add package Grapevine

dotnet add package Grapevine

using Grapevine;
using Grapevine.Interfaces.Server;
using Grapevine.Server;
using Grapevine.Server.Attributes;
using Grapevine.Shared;

public class Program
{
    public static void Main(string[] args)
    {
        // Create and start a new REST server
        var server = new RestServer();
        server.Start();
        Console.WriteLine("Server is running...");
        Console.WriteLine("Press enter to stop the server.");
        Console.ReadKey();
        server.Stop();
    }
}

[RestResource]
public class SampleResource
{
    // Defines a route method for the /hello endpoint
    [RestRoute(HttpMethod = HttpMethod.GET, PathInfo = "/hello")]
    public IHttpContext HelloWorld(IHttpContext context)
    {
        // Send a response for the GET request at /hello
        context.Response.SendResponse("Hello, World!");
        return context;
    }
}

using Grapevine;
using Grapevine.Interfaces.Server;
using Grapevine.Server;
using Grapevine.Server.Attributes;
using Grapevine.Shared;

public class Program
{
    public static void Main(string[] args)
    {
        // Create and start a new REST server
        var server = new RestServer();
        server.Start();
        Console.WriteLine("Server is running...");
        Console.WriteLine("Press enter to stop the server.");
        Console.ReadKey();
        server.Stop();
    }
}

[RestResource]
public class SampleResource
{
    // Defines a route method for the /hello endpoint
    [RestRoute(HttpMethod = HttpMethod.GET, PathInfo = "/hello")]
    public IHttpContext HelloWorld(IHttpContext context)
    {
        // Send a response for the GET request at /hello
        context.Response.SendResponse("Hello, World!");
        return context;
    }
}

開始

建立一個專案，讓您可以使用 Grapevine 建立 RESTful 網路服務，並使用 IronPDF 建立或修改 PDF 文件，這是開始使用 C# 中的 Grapevine 和 IronPDF 的第一步。 以下是一步一步的教學，讓您能輕鬆上手：

dotnet add package IronPdf

dotnet add package IronPdf

使用 IronPdf 閱讀。

為了讓您的第一個伺服器在程式中處理 HTTP 請求與回應，必須透過執行 Program.cs 檔案來初始化一個 Grapevine RestServer 實例。使用 Rest 伺服器的 Start() 和 Stop() 方法來管理伺服器，並使用控制台指示在按下按鍵時暫停。

using Grapevine.Interfaces.Server;
using Grapevine.Server.Attributes;
using Grapevine.Server;
using Grapevine.Shared;
using IronPdf;
using System.Threading.Tasks;
using System;

class Program
{
    [RestResource]
    public class PdfResource
    {
        // Route method for PDF generation
        [RestRoute(HttpMethod = Grapevine.Shared.HttpMethod.GET, PathInfo = "/generate-pdf")]
        public IHttpContext GeneratePdf(IHttpContext context)
        {
            // HTML content to be converted to PDF
            var htmlContent = "<h1>Hello, PDF!</h1><p>This is a PDF generated using IronPDF.</p>";

            // Create a new PDF renderer
            var renderer = new ChromePdfRenderer();

            // Render the PDF from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Convert PDF to byte array
            var pdfBytes = pdf.BinaryData;

            // Set response content type and length
            context.Response.ContentType = ContentType.CUSTOM_BINARY;
            context.Response.ContentLength64 = pdfBytes.Length;

            // Send PDF byte array as response
            context.Response.SendResponse(pdfBytes);

            return context;
        }
    }

    static async Task Main(string[] args)
    {
        // Create and start a new REST server
        var server = new RestServer();
        server.LogToConsole().Start();
        Console.WriteLine("Server is running...");
        Console.WriteLine("Press any key to stop the server.");
        Console.ReadKey();
        server.Stop();
    }
}

using Grapevine.Interfaces.Server;
using Grapevine.Server.Attributes;
using Grapevine.Server;
using Grapevine.Shared;
using IronPdf;
using System.Threading.Tasks;
using System;

class Program
{
    [RestResource]
    public class PdfResource
    {
        // Route method for PDF generation
        [RestRoute(HttpMethod = Grapevine.Shared.HttpMethod.GET, PathInfo = "/generate-pdf")]
        public IHttpContext GeneratePdf(IHttpContext context)
        {
            // HTML content to be converted to PDF
            var htmlContent = "<h1>Hello, PDF!</h1><p>This is a PDF generated using IronPDF.</p>";

            // Create a new PDF renderer
            var renderer = new ChromePdfRenderer();

            // Render the PDF from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Convert PDF to byte array
            var pdfBytes = pdf.BinaryData;

            // Set response content type and length
            context.Response.ContentType = ContentType.CUSTOM_BINARY;
            context.Response.ContentLength64 = pdfBytes.Length;

            // Send PDF byte array as response
            context.Response.SendResponse(pdfBytes);

            return context;
        }
    }

    static async Task Main(string[] args)
    {
        // Create and start a new REST server
        var server = new RestServer();
        server.LogToConsole().Start();
        Console.WriteLine("Server is running...");
        Console.WriteLine("Press any key to stop the server.");
        Console.ReadKey();
        server.Stop();
    }
}

在 Grapevine 配置中定義了一個 PdfResource 類，用於管理與 PDF 創建相關的特定 HTTP 請求。 [RestResource]屬性出現時，表示此類別擁有可以回應 RESTful 路由的方法。

PdfResource 中 GeneratePdf 方法上的 [RestRoute(HttpMethod = HttpMethod.GET, PathInfo = "/generate-pdf")] 註釋表示此方法回應 /generate-pdf 端點的 GET 請求。 在程序內：

• 將轉成 PDF 的內容由 HTML 內容字串 (htmlContent) 表示，其定義為
• 使用 IronPDF 的 ChromePdfRenderer 從 HTML 文字建立 PDF 文件 (pdf)。
• 從最後的 PDF 文件建立一個位元組陣列 (pdfBytes)。
• HTTP 上下文 (context) 設定為以 PDF 內容類型回覆，並使用 SendResponse 將 PDF 位元組傳送回客戶端。

結論

總而言之，希望在其應用程式中整合 Web 服務功能與動態 PDF 製作的開發人員，將可在 Grapevine C# 與 IronPDF 的整合中找到穩固的解決方案。 RESTful 端點的設定與實作透過 Grapevine 輕量且友善的極簡網頁框架得以簡化，同時也方便處理 HTTP 請求與建立自訂路由。 IronPdf 則可增強應用程式的功能，讓 HTML 資訊輕鬆轉換成優異的 PDF 文件，包括 JavaScript 整合和 CSS 造型支援。

此連結可讓開發人員建立動態、專業外觀的 PDF 並加以散佈，同時簡化互動式資料驅動網路服務的建立。 Grapevine 和 IronPDF 共同提供了一個靈活的工具箱，滿足當代線上應用程式開發的需求，無論是用於製作報表、發票或其他文件類型。 透過結合 IronPdf 強大的 PDF 創作能力和 Grapevine 友善的使用者介面，開發人員可以建立可擴充的有效解決方案，滿足廣泛的使用者需求和企業目標。

有了 IronPdf 以及 Iron Software 的支持，開發人員可以獲得更多 Web 應用程式和功能，以及更有效率的開發。 為了達到這個目的，它將全面的支援與極其靈活的 Iron Software 系統和套件融合在一起，提供明確定義的專案專用授權選項，讓開發人員可以輕鬆選擇最佳化的模型。 這些優點可讓開發人員快速、連貫且有效地實作解決方案，以因應各種挑戰。