Grapevine .NET (Jak to dziala dla programistow)

Czym jest Grapevine C#?

Za pomocą Grapevine, mikroframeworka internetowego w języku C#, można stworzyć lekką, szybką i elastyczną usługę internetową RESTful oraz API. Dzięki prostym wzorcom i podstawowej architekturze, które gwarantują szybką konfigurację i doskonałą wydajność, rozwiązanie to idealnie nadaje się do niewielkich projektów, prototypów i mikrousług, które wymagają wydajnej obsługi żądań HTTP.

Grapevine ułatwia proces identyfikacji i zarządzania punktami końcowymi, zapewniając elastyczny i przyjazny dla użytkownika mechanizm routingu. Ułatwia tworzenie operacji CRUD i dobrze zorganizowanych interfejsów API RESTful poprzez obsługę wielu metod HTTP, w tym GET, POST, PUT i DELETE. Obsługuje również oprogramowanie pośredniczące, umożliwiając programistom dodawanie kolejnych funkcji poprzez tworzenie niestandardowych komponentów do rejestrowania, uwierzytelniania i obsługi błędów.

Ponieważ framework działa zgodnie z zasadami REST, programiści mogą tworzyć skalowalne i niezawodne interfejsy API. Jego prostota i łatwość użytkowania sprawiają, że jest to świetna opcja dla programistów, którzy muszą szybko tworzyć prototypy i uruchamiać usługi internetowe bez zajmowania się złożonością większych frameworków. Dzięki swojej lekkości Grapevine nadaje się do mikrousług i aplikacji, które nie wymagają obciążenia związanego ze złożonym frameworkiem internetowym.

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

Pierwsze kroki

Skonfigurowanie projektu, w którym można używać Grapevine do tworzenia usług internetowych RESTful oraz IronPDF do tworzenia lub modyfikowania dokumentów PDF, jest pierwszym krokiem do rozpoczęcia pracy z Grapevine i IronPDF w języku C#. Oto przewodnik krok po kroku, który pomoże Ci rozpocząć pracę:

dotnet add package IronPdf

dotnet add package IronPdf

Grapevine z IronPDF

Aby Twój pierwszy serwer mógł obsługiwać żądania i odpowiedzi HTTP w ramach programu, należy zainicjować instancję Grapevine RestServer poprzez uruchomienie pliku Program.cs. Korzystając z metod Start() i Stop() serwera REST, serwer jest zarządzany, a instrukcje konsoli powodują wstrzymanie działania po naciśnięciu klawisza.

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

W konfiguracji Grapevine zdefiniowano klasę PdfResource w celu zarządzania konkretnymi żądaniami HTTP związanymi z tworzeniem plików PDF. Atrybut [RestResource], jeśli występuje, oznacza, że ta klasa posiada metody, które mogą odpowiadać na trasy RESTful.

Adnotacja [RestRoute(HttpMethod = HttpMethod.GET, PathInfo = "/generate-pdf")] w metodzie GeneratePdf w ramach PdfResource wskazuje, że metoda ta odpowiada na żądania GET w punkcie końcowym /generate-pdf. W ramach procedury:

• Treść, która zostanie przekształcona w plik PDF, jest reprezentowana przez ciąg znaków HTML (htmlContent), który jest zdefiniowany.
• Dokument PDF (pdf) jest tworzony na podstawie tekstu HTML przy użyciu funkcji ChromePdfRenderer biblioteki IronPdf.
• Z końcowego dokumentu PDF tworzona jest tablica bajtów (pdfBytes).
• Kontekst HTTP (context) jest skonfigurowany tak, aby odpowiadał z typem zawartości PDF, i wykorzystuje SendResponse do przesłania tablicy bajtów PDF z powrotem do klienta.

Wnioski

Podsumowując, programiści pragnący włączyć do swoich aplikacji funkcje usług internetowych wraz z dynamicznym tworzeniem plików PDF znajdą solidne rozwiązanie w integracji Grapevine C# z IronPDF. Konfiguracja i wdrażanie punktów końcowych RESTful jest uproszczone dzięki lekkiemu i przyjaznemu dla użytkownika minimalistycznemu frameworkowi internetowemu Grapevine, który ułatwia również przetwarzanie żądań HTTP i tworzenie niestandardowych tras. Z kolei IronPDF wzbogaca aplikację, umożliwiając łatwą konwersję informacji HTML na doskonałe dokumenty PDF, w tym integrację z JavaScriptem i obsługę stylów CSS.

To połączenie pozwala programistom tworzyć dynamiczne, profesjonalnie wyglądające pliki PDF i rozpowszechniać je, jednocześnie upraszczając tworzenie interaktywnych, opartych na danych usług internetowych. Grapevine i IronPDF razem tworzą elastyczny zestaw narzędzi, który zaspokaja potrzeby współczesnego tworzenia aplikacji internetowych, niezależnie od tego, czy chodzi o generowanie raportów, faktur czy innych rodzajów dokumentów. Dzięki połączeniu solidnych możliwości tworzenia plików PDF przez IronPDF oraz przyjaznego dla użytkownika interfejsu Grapevine programiści mogą tworzyć skalowalne i skuteczne rozwiązania, które spełniają szeroki zakres wymagań użytkowników i celów korporacyjnych.

Dzięki IronPDF i wsparciu Iron Software programiści zyskują dostęp do większej liczby aplikacji internetowych i funkcji, a także mogą pracować wydajniej. Osiąga to poprzez połączenie kompleksowego wsparcia z niezwykle elastycznymi systemami i Suite Iron Software, oferując jasno zdefiniowane opcje licencji dostosowane do projektu, które pozwalają programistom łatwo wybierać zoptymalizowane modele. Korzyści te pozwalają programistom na szybkie, spójne i skuteczne wdrażanie rozwiązań w obliczu szerokiego zakresu wyzwań.