jsonstream

JSONSTREAM

Beschreibung

JSONSONDREAM ist eine Bibliothek, die eine Low-Level-Streaming-API zum Lesen und Schreiben von JSON-Markup bietet. Es findet keine automatische Serialisierung oder Deserialisierung statt, und es werden keine Objekte im Speicher erstellt. Infolgedessen gibt es nur sehr wenig Overhead und Sie können sogar JSON -Markup umgehen, das zu groß ist, um in den Speicher zu passen. Der Parser ist ebenfalls tolerant und kann bestimmte Fehler wie ein falsches Nisten oder ein fehlendes Komma melden und wiederherstellen. Es ist einfach zu bedienen und an Ihre eigenen Anwendungsfälle anzupassen.

Was unterscheidet diese Bibliothek?

Andere JSON -Bibliotheken tun eine Menge Dinge gleichzeitig. Wenn sie JSON analysieren, analysieren sie nicht nur das Markup in einen Objektbaum oder verwenden sogar Reflexion/RTTI, um automatisch zwischen Ihren eigenen Objekten und ihrer JSON -Darstellung zu kartieren. Der Parser in Jauchern hingegen ist nur ein Parser. Was Sie mit den Daten machen, liegt ganz bei Ihnen. Dies bedeutet auch, dass Ihre Klassen/Strukturen/Datensätze keine 1: 1 -Darstellung des JSON sein müssen, was bei der Arbeit mit vorhandenen JSON -APIs sehr nützlich sein kann.

Während andere JSON -Bibliotheken Sie dazu zwingen, die JSON -Struktur deklarativ zu definieren, wird die Struktur in JSonstrom als Code definiert, was sie viel flexibler und ausdrucksvoller macht. Wenn es beispielsweise einen Wert gibt, der entweder null oder eine Ganzzahl sein kann, können Sie einfach dafür testen, anstatt einen speziellen Nullable<int> -Typ mit einer Reihe von überlasteten Methoden deklarieren zu müssen. Wenn Ihre JSON -Spezifikation komplexer wird, wird der deklarative Ansatz anderer Bibliotheken schwer zu lesen und zu warten und führt zu vielen Boilerplate -Code. Sie schreiben am Ende Turing-Complete-Code mit der Vorlagensyntax, die Sie nicht wollen. Mit JSonstrom hingegen können Sie nur die bereits zur Verfügung stehende Turing-Sprache verwenden.

Beispiel

Lektüre:

 var
  s: string;
  i: integer;
  ...
begin
  Stream := TStringStream.Create( ' ["Hello", "World", 42] ' );
  Reader := TJsonReader.Create(Stream);
  if Reader.List then
    while Reader.Advance <> jsListEnd do
    begin
      if Reader.Str(s) then
        WriteLn(s)
      else if Reader.Number(i) then
        WriteLn(i)
    end ;
end ;

Schreiben:

 begin
  Stream := TIOStream.Create(iosOutput);
  Writer := TJsonWriter.Create(Stream,[],true);
  Writer.Dict;
    Writer.Key( ' Hello ' );
    Writer.Str( ' World ' );
    Writer.Key( ' Flag ' );
    Writer.Bool(true);
    Writer.Key( ' Numbers ' );
    Writer.List;
      Writer.Number( 1 );
      Writer.Number( 2 );
      Writer.Number( 3 );
    Writer.ListEnd;
  Writer.DictEnd;
end ;

=>

{
  "Hello" : " World " ,
  "Flag" : true ,
  "Numbers" : [
    1 ,
    2 ,
    3
  ]
}

Weitere Beispiele finden Sie hier.

Merkmale

Diese Bibliothek kann die folgenden Standards lesen und schreiben:

• JSON
• JSON5 (muss explizit aktiviert werden)

Es hält sich eng an die Standards und kann verwendet werden, um JSON -Markup zu validieren oder zu sanieren. Es kann sogar nach einem Fehler analysieren, falls gewünscht. Ein Beispiel für eine solche Verwendung in Pascal/Beispiel/JSONECHO.

Die Bibliothek kann beliebige Eingaben mit vorhersehbaren Laufzeiteigenschaften verarbeiten. Saiten und Objektschlüssel können mit den Methoden StrBuf und KeyBuf verarbeitet werden und müssen daher nicht in ihrer Gesamtheit im Speicher sein. Die Semantik dieser Funktionen ähnelt der read -Systeme auf POSIX -Systemen.

Die Zeit, die erforderlich ist, um eine JSON -Datei zu analysieren, ist durch o (n + e*k) begrenzt, wobei n die Länge in Bytes ist, E die Anzahl der korrigierten Fehler und k die maximale Nisttiefe ist. Bei den meisten Anwendungsfällen ist die Abbrüche beim ersten Fehler in Ordnung (es ist auch der Standard). In diesem Fall wird die Laufzeit O (n). Die Speicherverwendung ist durch O (k) begrenzt. Sie können während der Initialisierung eine maximal zulässige Nisttiefe angeben. Der Parser wird dann abbrechen, sobald diese Grenze erreicht ist.

Die Ausgabe kann bei Bedarf ziemlich gedruckt werden oder eine kompakte Darstellung ohne zusätzliche Weißespace verwenden.

Dateien

Dieses Repository verfügt über Unterordner für die verschiedenen Sprachimplementierungen der Bibliothek. Derzeit ist die einzige Implementierung in Pascal geschrieben, andere Implementierungen (z. B. C) sind jedoch geplant.

Unterordner:

Ordner	Beschreibung
Pascal	Pascal -Implementierung von JSONSONTREAM

Lizenz

Dieses Projekt ist unter der MIT -Lizenz lizenziert.

 Copyright 2021 Philip Zander

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.