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

什麼是 Grapevine C#？

using Grapevine，可以建立一個輕量、快速且可適應的 RESTful 網路服務和 API，這是一個 C# 微型網頁框架。 由於其簡單的模式和基本的架構，保証了快速設置和卓越的性能，因此非常適合需要高效處理 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

入門

設置一個專案，透過在 C# 中結合使用 Grapevine 建立 RESTful 網路服務和 IronPDF 來建立或修改 PDF 文件，是熟悉 Grapevine 和 IronPDF 的第一步。 這裡有一個逐步教程幫助您開始：

dotnet add package IronPdf

使用 IronPDF 的 Grapevine

要讓您的第一台伺服器在程式中處理 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();
    }
}

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 字節陣列傳回給客戶端。

結論

總之，開發人員希望在其應用程式中整合具有動態 PDF 生成功能的網路服務，Grapevine C# 與 IronPDF 的整合將成為堅固的解決方案。 Grapevine 的輕量且使用者友好的極簡網頁框架簡化了 RESTful 端點的設置和實作，還促進了 HTTP 請求的處理和自定義路由的建立。 另一方面，IronPDF 可通過支持包含 JavaScript 和 CSS 造型整合的 HTML 資訊，輕鬆轉換為優秀的 PDF 文件，以提升應用程式。

此連接允許開發人員建立動態的、專業的 PDF，並且簡化了交互性、資料驅動網路服務的建立和分發。 Grapevine 和 IronPDF 的結合提供了一個靈活的工具箱，無論是生成報告、發票或其他型別的文件，都滿足當代網路應用程式開發的需求。 透過結合 IronPDF 的強大 PDF 建立功能和 Grapevine 的使用者友好介面，開發人員可以建立滿足使用者需求和企業目標的靈活高效解決方案。

有了 IronPDF，並在Iron Software的支持下，開發人員獲得更多網頁應用程式和功能以及更高效的開發。 這是通過將全面的支持與極具靈活性的 Iron Software 系統和套件相結合，提供特定於專案的明確授權選項，讓開發人員可以輕鬆選擇最佳化的模型來完成的。 這些好處使開發人員能夠快速、連貫且有效地實施解決方案，適用於各種挑戰。