Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.0.0

relic

Um servidor web leve e flexível inspirado no Shelf para criar APIs e serviços de back-end.

AndroidiOSmacOSWindowsLinux
Downloads em 30 dias
228 mil
Curtidas
119
Pontos Pub
160

Instalar pacote

flutter pub add relic

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Relic é um servidor web leve e flexível para Dart, inspirado no Shelf, projetado para criar APIs e serviços de backend. Ele oferece uma abordagem simples e modular para lidar com requisições e respostas HTTP, tornando-o ideal para desenvolvedores que buscam desempenho e facilidade de uso em múltiplas plataformas. Com suporte a Android, iOS, macOS, Windows e Linux, o Relic permite um desenvolvimento backend sem interrupções em aplicativos Flutter ou serviços autônomos. Seu pequeno tamanho e API limpa permitem prototipagem rápida e implantação escalonável.

Casos de uso

  • Construindo APIs RESTful
  • Criando serviços de backend para aplicativos Flutter
  • Desenvolvendo lógica do lado do servidor multiplataforma
  • Prototipagem de microserviços
  • Gerenciamento de roteamento de solicitação HTTP

Principais recursos

  • Leve e rápido
  • Suporte a middleware modular
  • Compatibilidade multiplataforma
  • API simples e intuitiva
  • Tratamento de solicitação/resposta embutido

Indicado para

  • Desenvolvedores Flutter que precisam de funcionalidade de backend
  • Equipes construindo microserviços
  • Desenvolvedores individuais prototipando APIs
  • Projetos que exigem lógica do lado do servidor em múltiplas plataformas
  • Aplicações com requisitos de baixa latência

Considerações

  • Não adequado para cargas de trabalho de produção de alta concorrência sem escalabilidade adicional
  • Autenticação embutida limitada em comparação com frameworks completos
  • Requer configuração manual para integração com banco de dados
  • Mais adequado para aplicativos de pequeno a médio porte
  • Sem suporte embutido de WebSocket no pacote principal

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Relic web server banner

build codecov Stars on Github License: BSD-3-Clause

Relic web server

Relic is a modern, high-performance web server framework inspired by Shelf and built by the Serverpod team to meet the demanding requirements of modern web applications. Relic provides a robust, type-safe, and efficient foundation for building scalable web services.

👉 Full documentation available here 📚

Why Relic?

While Shelf has been a solid foundation for Dart web applications, several areas for improvement were identified. Rather than work around these limitations, Relic was created as a next-generation framework that maintains Shelf's familiar structure while delivering significant enhancements. These are some of the improvements:

  • Strongly typed APIs with validated HTTP headers.
  • Simplified interface for setting up routing and middleware.
  • Unified encoding model for HTTP bodies.
  • Built-in trie-based router, which improves performance.
  • Static file handling with support for cache busting and etags.
  • Built-in support for WebSockets.
  • Improvements in hot reload and running with multiple isolates.

Quick start

  1. Install Dart 3.7 or newer and verify with dart --version.
  2. Add Relic: dart pub add relic
  3. Create a new console app and drop in the hello world server below.
dart create -t console-full hello_world
cd hello_world
dart pub add relic
Run your first Relic server

Place this file in bin/hello_world.dart (runnable example is also under example/example.dart):

import 'package:relic/io_adapter.dart';
import 'package:relic/relic.dart';

/// A simple 'Hello World' server demonstrating basic Relic usage.
Future<void> main() async {
  // Setup the app.
  final app =
      RelicApp()
        // Route with parameters (:name & :age).
        ..get('/user/:name/age/:age', helloHandler)
        // Middleware on all paths below '/'.
        ..use('/', logRequests())
        // Custom fallback - optional (default is 404 Not Found).
        ..fallback = respondWith(
          (_) => Response.notFound(
            body: Body.fromString("Sorry, that doesn't compute.\n"),
          ),
        );

  // Start the server (defaults to using port 8080).
  await app.serve();
}

const _ageParam = PathParam<int>(#age, int.parse);
/// Handles requests to the hello endpoint with path parameters.
Response helloHandler(final Request req) {
  final name = req.pathParameters.raw[#name];
  final age = req.pathParameters.get(_ageParam);

  return Response.ok(
    body: Body.fromString('Hello, $name! To think you are $age years old.\n'),
  );
}

Run it with dart run bin/hello_world.dart and visit http://localhost:8080/user/Nova/age/27.

Additional examples

Relic comes with an extensive set of examples. To run them, clone the Relic repository from GitHub and navigate to the example directory.

git clone https://github.com/serverpod/relic.git
cd relic/example
dart example.dart

Migrating from Shelf

Are you on Shelf? Moving over is straightforward. Relic's APIs are very similar while giving you typed requests, built-in routing, and WebSockets out of the box. Follow the step-by-step guide at docs.dartrelic.dev/getting-started/shelf-migration to upgrade your project in minutes.

Categorias

Dependências

Lista de dependências 2 itens

  • relic_core^2.0.0
  • relic_io^2.0.0

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.