Pakete, Repositories und App-Kategorien suchen

Paketdetailsv0.2.1

rfc_6901

JSON Pointer (RFC 6901). Liest/schreibt referenzierte Werte in JSON-Dokumenten.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
898.000
Likes
32
Pub-Punkte
160

Paket installieren

flutter pub add rfc_6901

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das rfc_6901-Paket implementiert JSON Pointer (RFC 6901) für Dart und Flutter und ermöglicht sichere Navigation und Manipulation von JSON-Dokumenten. Es erlaubt das Lesen und Schreiben von Werten in verschachtelten JSON-Strukturen mithilfe von Zeiger-Syntax, beispielsweise /foo/0/bar. Dies ist besonders nützlich bei der dynamischen Datenverarbeitung in APIs, Konfigurationsdateien oder Zustandsverwaltung, wo präziser Zugriff auf JSON-Felder erforderlich ist, ohne die gesamte Struktur analysieren zu müssen. Das Paket unterstützt alle wichtigen Plattformen, einschließlich Mobilgeräte, Web und Desktop.

Anwendungsfälle

  • Dynamisches Zugreifen auf verschachtelte JSON-Werte
  • Spezifische Felder in einem JSON-Dokument aktualisieren
  • Parsing von API-Antworten mit variabler Struktur
  • Partielle Aktualisierungen in der Zustandsverwaltung implementieren
  • Arbeiten mit Konfigurationsdateien, die verschachtelte Schlüssel verwenden

Hauptmerkmale

  • Unterstützt das RFC 6901-JSON-Pointer-Standard
  • Sichere Wertabfrage und -zuweisung
  • Behandelt Arrays und Objekte einheitlich
  • Plattformübergreifende Kompatibilität
  • Minimale Abhängigkeits-Spur

Geeignet für

  • Entwickler, die mit dynamischen JSON-Daten arbeiten
  • API-Clients, die selektiven Feldzugriff benötigen
  • Statusverwaltungssysteme, die Patch-Operationen erfordern
  • Konfigurationsparser mit tiefer Verschachtelung

Hinweise

  • Gültige JSON-Pointer-Syntax erforderlich
  • Überprüft Zielpfade zur Laufzeit nicht
  • Beschränkt auf Lese-/Schreibvorgänge an bestehenden JSON
  • Nicht geeignet für komplexe JSON-Umwandlungen

Original-README

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

RFC 6901 JSON Pointer

JSON Pointer (RFC 6901) implementation in Dart.

Features:

  • Reads, writes, removes values
  • Fully implements the standard, including the - character
  • Can build the entire path, e.g. /foo/bar/-/baz
  • No external dependencies
  • 100% test coverage

Constructing pointers

A JSON Pointer object can be parsed from a string expression. The expression MUST be a valid non-empty JSON Pointer expression with "/" and "~" escaped.

final pointer = JsonPointer('/foo/0/bar'); // a valid non-empty pointer
final alsoPointer = JsonPointer('/foo/-'); // a valid non-empty pointer with a special "-" reference
final emptyPointer = JsonPointer(); // an empty pointer

JsonPointer('oops'); // throws a FormatException: expression doesn't start with "/"
JsonPointer('/foo/~'); // throws a FormatException: unescaped "~"

It can also be built from individual reference tokens. In such case, it will escape the tokens automatically.

final pointer = JsonPointer.build(['foo', '0', 'bar/']); // Makes "/foo/0/bar~1"
final longerPointer = JsonPointerSegment('-', pointer); // Makes "/foo/0/bar~1/-"
final evenLongerPointer = JsonPointerSegment('wow', longerPointer); // Makes "/foo/0/bar~1/-/wow"

Reading and writing values

The read() method returns the referenced value. The write() method returns a copy of the document with the referenced value replaced by the new value.

import 'dart:convert';

import 'package:rfc_6901/rfc_6901.dart';

void main() {
  const json = '{"foo": [{"bar": 42}]}';
  final document = jsonDecode(json);
  print('Original document: $document');

  [
    '/foo', // reads the array
    '/foo/0', // reads the first element of the array
    '/foo/0/bar', // reads 42
  ].forEach((expression) {
    final pointer = JsonPointer(expression);
    print('Pointer "$pointer" reads ${pointer.read(document)}');
  });

  [
    '/foo/0/bar', // {foo: [{bar: banana}]}
    '/foo/-', // {foo: [{bar: 42}, banana]}
    '/a/b/-/c/d', // {foo: [{bar: 42}], a: {b: [{c: {d: banana}}]}}
  ].forEach((expression) {
    final pointer = JsonPointer(expression);
    final d = pointer.write(document, 'banana');
    print('Add a banana at "$pointer": $d');
  });
}

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden