Pakete, Repositories und App-Kategorien suchen

Paketdetailsv2.0.0

relic

Ein leichter und flexibler Webserver, inspiriert durch Shelf, zum Erstellen von APIs und Backend-Diensten.

AndroidiOSmacOSWindowsLinux
30-Tage-Downloads
228.000
Likes
119
Pub-Punkte
160

Paket installieren

flutter pub add relic

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Relic ist ein leichtgewichtiger und flexibler Webserver für Dart, der von Shelf inspiriert wurde und für die Erstellung von APIs und Backend-Diensten konzipiert ist. Er bietet einen einfachen, modularen Ansatz zur Behandlung von HTTP-Anfragen und -Antworten und ist daher ideal für Entwickler, die Leistung und Benutzerfreundlichkeit auf mehreren Plattformen suchen. Mit Unterstützung für Android, iOS, macOS, Windows und Linux ermöglicht Relic eine nahtlose Backend-Entwicklung innerhalb von Flutter-Anwendungen oder eigenständigen Diensten. Sein geringer Ressourcenverbrauch und seine saubere API erlauben schnelle Prototypentwicklung und skalierbare Bereitstellung.

Anwendungsfälle

  • RESTful APIs erstellen
  • Erstellen von Backend-Diensten für Flutter-Apps
  • Entwicklung plattformübergreifender Server-Logik
  • Prototyping von Microservices
  • Behandlung der HTTP-Anforderungsweiterleitung

Hauptmerkmale

  • Leicht und schnell
  • Modulare Middleware-Unterstützung
  • Plattformübergreifende Kompatibilität
  • Einfaches und intuitives API
  • Eingebaute Anfrage-/Antwortverarbeitung

Geeignet für

  • Flutter-Entwickler, die Backend-Funktionalität benötigen
  • Teams, die Microservices bauen
  • Solo-Entwickler, die APIs prototypisch erstellen
  • Projekte, die serverseitige Logik auf mehreren Plattformen erfordern
  • Anwendungen mit geringen Latenzanforderungen

Hinweise

  • Nicht geeignet für hochkonzentrierte Produktionslasten ohne zusätzliche Skalierung
  • Eingeschränkte integrierte Authentifizierung im Vergleich zu vollständigen Frameworks
  • Benötigt manuelle Einrichtung für Datenbankintegration
  • Am besten geeignet für kleine bis mittelgroße Anwendungen
  • Kein eingebauter WebSocket-Support im Kernpaket

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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.

Kategorien

Abhängigkeiten

Abhängigkeiten 2 Einträge

  • relic_core^2.0.0
  • relic_io^2.0.0

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.