Grapevine .NET (Como funciona para desenvolvedores)

O que é Grapevine C#?

Um serviço web RESTful e uma API leves, rápidos e adaptáveis ​​podem ser criados com a ajuda do Grapevine , um microframework web em C#. É perfeito para projetos pequenos, protótipos e microsserviços que precisam lidar com solicitações HTTP de forma eficiente, graças aos seus padrões simples e arquitetura básica, que garantem configuração rápida e excelente desempenho.

O Grapevine facilita o processo de identificação e gerenciamento de endpoints, fornecendo um mecanismo de roteamento flexível e fácil de usar. Simplifica a criação de operações CRUD e APIs RESTful bem organizadas, oferecendo suporte a diversos métodos HTTP, incluindo GET, POST, PUT e DELETE. Ele também oferece suporte a middleware, permitindo que os programadores adicionem mais funcionalidades criando componentes personalizados para registro de logs, autenticação e tratamento de erros.

Como o framework segue os princípios REST, os desenvolvedores podem criar APIs escaláveis ​​e confiáveis. Sua simplicidade e facilidade de uso o tornam uma ótima opção para desenvolvedores que precisam prototipar e lançar serviços web rapidamente, sem lidar com as complexidades de frameworks maiores. Seu design leve torna o Grapevine adequado para microsserviços e aplicativos que não precisam da sobrecarga de uma estrutura web complexa.

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

Começando

Configurar um projeto onde você possa usar o Grapevine para estabelecer serviços web RESTful e o IronPDF para criar ou modificar documentos PDF é o primeiro passo para começar a usar o Grapevine e o IronPDF em C#. Aqui está um tutorial passo a passo para você começar:

dotnet add package IronPdf

dotnet add package IronPdf

Videira com IronPDF

Para que seu primeiro servidor lide com solicitações e respostas HTTP dentro do programa, uma instância do Grapevine RestServer deve ser inicializada executando o arquivo Program.cs. Usando os métodos Start() e Stop() do servidor REST, o servidor é gerenciado, com instruções no console para pausar ao pressionar uma tecla.

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

Uma classe PdfResource é definida na configuração do Grapevine para gerenciar solicitações HTTP específicas associadas à criação de PDFs. O atributo [RestResource], quando presente, indica que esta classe possui métodos que podem responder a rotas RESTful.

A anotação [RestRoute(HttpMethod = HttpMethod.GET, PathInfo = "/generate-pdf")] no método GeneratePdf dentro de PdfResource indica que este método responde a solicitações GET no endpoint /generate-pdf. No âmbito do procedimento:

• O conteúdo que será transformado em PDF é representado por uma string de conteúdo HTML (htmlContent), que está definida.
• Um documento PDF (pdf) é criado a partir do texto HTML usando o ChromePdfRenderer do IronPDF.
• Um array de bytes (pdfBytes) é criado a partir do documento PDF final.
• O contexto HTTP (context) está configurado para responder com um tipo de conteúdo PDF e usa SendResponse para transmitir a matriz de bytes do PDF de volta para o cliente.

Conclusão

Em conclusão, os desenvolvedores que desejam incorporar recursos de serviços web com geração dinâmica de PDFs em seus aplicativos encontrarão uma solução sólida na integração do Grapevine C# com o IronPDF. A configuração e implementação de endpoints RESTful são simplificadas pelo framework web minimalista, leve e fácil de usar do Grapevine, que também facilita o processamento de requisições HTTP e a criação de rotas personalizadas. O IronPDF, por outro lado, aprimora o aplicativo, permitindo a fácil conversão de informações HTML em excelentes documentos PDF, incluindo integração com JavaScript e suporte para estilização CSS.

Essa conexão permite que os desenvolvedores criem PDFs dinâmicos e com aparência profissional e os distribuam, simplificando também a criação de serviços web interativos e orientados a dados. Em conjunto, o Grapevine e o IronPDF oferecem um conjunto de ferramentas flexível que satisfaz as necessidades do desenvolvimento de aplicações online contemporâneas, seja para a produção de relatórios, faturas ou outros tipos de documentos. Combinando os recursos robustos de criação de PDFs do IronPDF com a interface amigável do Grapevine, os desenvolvedores podem criar soluções escaláveis ​​e eficazes que atendem a uma ampla gama de requisitos de usuários e objetivos corporativos.

Com o IronPDF e o suporte da Iron Software , os desenvolvedores obtêm mais aplicativos web e funcionalidades, além de um desenvolvimento mais eficiente. Isso é conseguido através da combinação de suporte abrangente com os sistemas e o conjunto de ferramentas incrivelmente flexíveis da Iron Software , oferecendo opções de licenciamento claramente definidas e específicas para cada projeto, que permitem aos desenvolvedores selecionar facilmente modelos otimizados. Esses benefícios permitem que os desenvolvedores implementem soluções de forma rápida, coesa e eficaz para uma ampla gama de desafios.