Grapevine .NET（對開發者如何理解的工作）

什麼是 Grapevine C#?

借助Grapevine，一個 C# 微型網路框架，可以創建輕量級、快速、靈活的 RESTful 網路服務和 API。 它非常適合小型項目、原型設計和需要有效處理 HTTP 請求的微服务，其簡單的設計模式和基本結構確保快速設置和卓越的性能。

Grapevine 提供靈活且用戶友好的路由機制，使端點的識別和管理過程更加簡便。 通過支持包括 GET、POST、PUT 和 DELETE 在內的多種 HTTP 方法，簡化了 CRUD 操作和結構良好的 RESTful API 的創建。 它還支持中間件，使程式設計師能夠通過創建自定義組件來擴展日志記錄、身份驗證和錯誤處理等功能。

因為該框架遵循 REST 原則，開發者可以創建可擴展和可靠的 API。其簡單性和易用性使其成為需要快速原型設計和啟動網路服務的開發者的理想選擇，無需處理複雜框架的複雜性。 其輕量化設計使得 Grapevine 適合不需要複雜網路框架開銷的微服務和應用程式。

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;
    }
}

Imports Grapevine
Imports Grapevine.Interfaces.Server
Imports Grapevine.Server
Imports Grapevine.Server.Attributes
Imports Grapevine.Shared

Public Class Program
	Public Shared Sub Main(ByVal args() As String)
		' Create and start a new REST server
		Dim server = New RestServer()
		server.Start()
		Console.WriteLine("Server is running...")
		Console.WriteLine("Press enter to stop the server.")
		Console.ReadKey()
		server.Stop()
	End Sub
End Class

<RestResource>
Public Class SampleResource
	' Defines a route method for the /hello endpoint
	<RestRoute(HttpMethod := HttpMethod.GET, PathInfo := "/hello")>
	Public Function HelloWorld(ByVal context As IHttpContext) As IHttpContext
		' Send a response for the GET request at /hello
		context.Response.SendResponse("Hello, World!")
		Return context
	End Function
End Class

入門指南

設置一個可以使用 Grapevine 建立 RESTful 網路服務和使用 IronPDF 創建或修改 PDF 文檔的項目是啟動 Grapevine 和 IronPDF 在 C# 中的第一步。 以下是開始的逐步教程：

dotnet add package IronPdf

dotnet add package IronPdf

Grapevine 與 IronPDF

要讓您的第一個服務器在程式中處理 HTTP 請求和回應，必須通過執行 Program.cs 文件來初始化 Grapevine RestServer 實例。透過使用休息服務器的 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();
    }
}

Imports Grapevine.Interfaces.Server
Imports Grapevine.Server.Attributes
Imports Grapevine.Server
Imports Grapevine.Shared
Imports IronPdf
Imports System.Threading.Tasks
Imports System

Friend Class Program
	<RestResource>
	Public Class PdfResource
		' Route method for PDF generation
		<RestRoute(HttpMethod := Grapevine.Shared.HttpMethod.GET, PathInfo := "/generate-pdf")>
		Public Function GeneratePdf(ByVal context As IHttpContext) As IHttpContext
			' HTML content to be converted to PDF
			Dim htmlContent = "<h1>Hello, PDF!</h1><p>This is a PDF generated using IronPDF.</p>"

			' Create a new PDF renderer
			Dim renderer = New ChromePdfRenderer()

			' Render the PDF from the HTML content
			Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

			' Convert PDF to byte array
			Dim 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
		End Function
	End Class

	Shared Async Function Main(ByVal args() As String) As Task
		' Create and start a new REST server
		Dim server = New RestServer()
		server.LogToConsole().Start()
		Console.WriteLine("Server is running...")
		Console.WriteLine("Press any key to stop the server.")
		Console.ReadKey()
		server.Stop()
	End Function
End Class

在 Grapevine 配置中定義一個 PdfResource 類來管理與 PDF 生成相關的特定 HTTP 請求。 當 [RestResource] 屬性存在時，表明此類具有可響應 RESTful 路徑的方法。

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

• 定義了一個 HTML 內容字符串 (htmlContent)，表示將轉換為 PDF 的內容。
• 使用 IronPDF 的 ChromePdfRenderer 從 HTML 文本創建 PDF 文件 (pdf)。
• 從最終的 PDF 文件中創建一個字節數組 (pdfBytes)。
• 設置 HTTP 上下文 (context) 以 PDF 內容類型響應，並使用 SendResponse 將 PDF 字節數組傳回給客戶端。

結論

總之，對於旨在於應用程式中整合 web 服務功能和動態 PDF 生成的開發者來說，Grapevine C# 與 IronPDF 的結合提供了一個可靠的方案。 Grapevine 的輕量且用戶友好的極簡網路框架簡化了 RESTful 端點的設置和實施，並且便於處理 HTTP 請求和創建自定義路徑。 相反地，IronPDF 透過簡單將 HTML 信息轉換為優質 PDF 文件，包含 JavaScript 集成和支持 CSS 樣式來加強應用程式。

這種聯結允許開發者創建動態、專業外觀的 PDF 並進行分發，同時簡化了交互式、以數據驅動的 web 服務的創建。 Grapevine 和 IronPDF 一起提供了滿足現代網路應用程式開發需求的靈活工具集合，無論是生成報告、發票還是其他文檔類型。 通過結合 IronPDF 的強大 PDF 生成功能和 Grapevine 的用戶友好界面，開發者可以創建滿足各種用户需求和企業目標的可擴展且有效的解決方案。

使用 IronPDF 及 Iron Software 的支持，開發人員獲得更多的網路應用和功能以及更高效的開發。 它通過將全面的支持與高度靈活的 Iron Software 系統和套件結合在一起，提供清晰定義的許可選項，專門針對特定項目，讓開發者可以輕易選擇最佳模式。 這些好處使開發人員能夠快速、連貫且有效地應對各種挑戰。