imported>Trustable: Einleitung

2023-10-05T23:51:58Z

Einleitung

Neue Seite

'''JSON-RPC''' ([[JavaScript Object Notation]] [[Remote Procedure Call]]) ist ein Protokoll zum Aufruf von [[Methode (Programmierung)|Methoden]] in [[Verteiltes System|entfernten Computersystemen]], ähnlich wie [[XML-RPC]] (die Daten werden jedoch in [[JavaScript Object Notation|JSON]] statt in [[Extensible Markup Language|XML]] gesendet).
Bei der Spezifikation wurde darauf geachtet, dass JSON-RPC möglichst keine unnötige Komplexität enthält und über verschiedene [[Kommunikationsprotokoll]]e genutzt werden kann. Dadurch kann es sehr flexibel eingesetzt werden. Zudem unterstützt das Protokoll
[[asynchrone Kommunikation]], da alle Anfragen und Antworten eine ID enthalten, was eine einfache Zuordnung von Antworten zu den entsprechenden Anfragen ermöglicht.

JSON-RPC 1.0 erlaubt Anfragen in beide Richtungen ([[Peer-to-Peer]]), die meisten JSON-RPC 1.0 Implementierungen unterstützen jedoch standardmäßig nur eine Richtung ([[Client-Server-Modell]]).

JSON-RPC 2.0 verwendet ein [[Client-Server-Modell]]. Anfragen in beide Richtungen sind möglich, indem auf beiden Seiten ein JSON-RPC-Server verwendet wird.

== Funktionsweise ==
=== Anfrage ===
Ein JSON-RPC-Call besteht aus einem [[JavaScript Object Notation#Datenstruktur und Formatdefinition|JSON-Objekt]], das vom [[Client]] an einen [[Server]] geschickt wird. Mögliche Anfragetypen sind
* Request (englisch für: „Anfrage“): Der Server soll eine Antwort liefern.
* Notification (englisch für: „Benachrichtigung“): Einwegkommunikation, vom Server wird keine Antwort erwartet.
* Batch Request (englisch für: „Stapelanfrage“): Mehrere Anfragen (''Notifications'' oder ''Requests'') werden zusammengefasst als JSON-Array gesendet, dessen Elemente dann die einzelnen Request-Objekte sind. (Verfügbar ab Version 2.0)

In der folgenden Tabelle sind die Bestandteile eines Request-Objekts aufgelistet.
{| class="wikitable"
|-
! Bestandteil
! Beschreibung
! Bemerkung
|-
| <code>jsonrpc</code>
| Ein String mit dem Namen der JSON-RPC-Version ("2.0")
| Ab Version 2.0
|-
| <code>method</code>
| Ein String mit dem Namen der Funktion, die aufgerufen werden soll.
|
|-
| <code>params</code>
| Ein Array oder Objekt mit den Parametern, die der Funktion übergeben werden sollen.
| Objekt ab Version 2.0 möglich
|-
| <code>id</code>
| Ein eindeutiger Identifikator für die Nachricht. Kann jeden beliebigen [[Datentyp]] haben (i. d. R. Integer).
|
|}

Eine Notification zeichnet sich dadurch aus, dass:

* JSON-RPC Version 2.0: <code>id</code> fehlt
* JSON-RPC Version 1.0: <code>id</code> <code>null</code> ist

=== Antwort ===
Im Fall eines Requests schickt der Server nach der Ausführung der angeforderten Methode eine Antwort als JSON-Objekt zurück an den Client. Die Bestandteile eines Response-Objektes sind in der folgenden Tabelle aufgelistet.

{| class="wikitable"
|-
! Bestandteile
! Beschreibung
! Bemerkung
|-
| <code>jsonrpc</code>
| Ein String mit dem Namen der JSON-RPC-Version („2.0“)
| Ab Version 2.0
|-
| <code>result</code>
| Das Rückgabeobjekt der Funktion, falls kein RPC-Fehler auftrat. Andernfalls:
* Version 2.0: wird dieses Feld weggelassen.
* Version 1.0: hat dieses Feld den Wert <code>null</code>.
|
|-
| <code>error</code>
| Das Fehlerobjekt, falls ein RPC-Fehler auftrat. Andernfalls:
* Version 2.0: wird dieses Feld weggelassen.
* Version 1.0: hat dieses Feld den Wert <code>null</code>.
|
|-
| <code>id</code>
| Enthält den gleichen Wert wie <code>id</code> des Requests, der diese Response verursacht hat.
|
|}

Erhält der Server eine Notification, führt er die angegebene Methode aus, sendet jedoch keine Antwort.
Erhält er einen Batch-Request, führt er die aufgelisteten Methoden aus, und sendet eine Batch-Response (d. h. die Antworten auf alle Requests im Batch-Request in einer Nachricht).

== Beispiele ==
In diesen Beispielen steht <code>--></code> für eine Nachricht vom Client an der Server, und <code><--</code> umgekehrt.

=== Version 2.0 ===
Ein einfaches Beispiel mit einer Anfrage und einer Antwort:
<code><pre>
--> { "jsonrpc": "2.0", "method": "gibAus", "params": ["Hallo JSON-RPC"], "id": 1}
<-- { "jsonrpc": "2.0", "result": "Hallo JSON-RPC", "id": 1}
</pre></code>

Gleiches Beispiel mit "named parameters":
<code><pre>
--> { "jsonrpc": "2.0", "method": "gibAus", "params": {"Nachricht": "Hallo JSON-RPC"}, "id": 2}
<-- { "jsonrpc": "2.0", "result": "Hallo JSON-RPC", "id": 2}
</pre></code>

Weitere Beispiele finden sich am Ende der JSON-RPC 2.0 Spezifikation.

=== Version 1.0 ===
Ein einfaches Beispiel mit einer Anfrage und einer Antwort
<pre>
--> { "method": "gibAus", "params": ["Hallo JSON-RPC"], "id": 1}
<-- { "result": "Hallo JSON-RPC", "error": null, "id": 1}
</pre>

Dieses Beispiel zeigt einen Teil der Kommunikation in einer Chat-Anwendung. Der Chat-Dienst sendet eine ''Notification'' für jede Nachricht, die der Client erhalten soll. Der Client sendet einen ''Request'', um eine Nachricht zu senden und erwartet eine positive Rückmeldung, um zu wissen, dass die Nachricht veröffentlicht wurde.<ref>{{Webarchiv |url=http://json-rpc.org/wiki/specification |text=specification – JSON-RPC – Trac. |wayback=20080517011921 |archiv-bot=2018-04-16 15:11:42 InternetArchiveBot}} json-rpc.org</ref>
<pre>
...
--> {"method": "veröffentlicheNachricht", "params": ["Hallo an alle!"], "id": 99}
<-- {"result": 1, "error": null, "id": 99}
<-- {"method": "empfangeNachricht", "params": ["Benutzer1", "Wir unterhielten uns gerade"], "id": null}
<-- {"method": "empfangeNachricht", "params": ["Benutzer3", "Ich muss jetzt los, tschüss"], "id": null}
--> {"method": "veröffentlicheNachricht", "params": ["Ich habe eine Frage!"], "id": 101}
<-- {"method": "ändereStatus", "params": ["abwesend","Benutzer3"], "id": null}
<-- {"result": 1, "error": null, "id": 101}
...
</pre>

== Versionsgeschichte ==
Die erste Version vom JSON-RPC stammt von 2005. Die Version 2.0 wurde 2010 verabschiedet.

{| class="wikitable"
|-
! Version
! Beschreibung
! Datum
|-
| 1.0
| Original-Version<ref>{{Webarchiv |url=http://json-rpc.org/wiki/specification |text=json-rpc.org |wayback=20080517011921 |archiv-bot=2018-04-16 15:11:42 InternetArchiveBot}}</ref>
| 2005
|-
| Entwurf „1.1 WD“
| Auf HTTP eingeschränkt, benannte Parameter, spezifische Fehlercodes und introspektive Funktionen hinzugefügt.
| 07.08.2006
|-
| Entwurf „1.1 Alt“
| Alternativer (vereinfachter) Vorschlag für 1.1 WD.
| 06.05.2007
|-
| Entwurf „1.2“
| Leicht modifizierte Variante von 1.1 Alt. Eine spätere Version wurde in 2.0 umbenannt.
| 27.12.2007
|-
| 2.0
| aktuelle Spezifikation<ref>[http://www.simple-is-better.org/json-rpc/jsonrpc20.html simple-is-better.org]</ref>
| 2010
|}

== Implementierungen ==
JSON-RPC wurde in verschiedenen Programmiersprachen implementiert, darunter [[JavaScript]], [[C++]], [[C (Programmiersprache)|C]], [[C-Sharp|C#]], [[Java (Programmiersprache)|Java]], [[Python (Programmiersprache)|Python]] und [[PHP]]. Da JSON aus Unicode-Zeichen besteht, kann JSON-RPC jedoch auch in anderen Programmiersprachen relativ einfach implementiert werden.<ref>{{RFC-Internet |RFC=4627 |Titel=application/json }}</ref>

== Verbreitung ==
Wo überall JSON-RPC eingesetzt wird, ist in der Öffentlichkeit selten ein Thema. Google hat am 31. Juli 2019 verkündet, dass ab dem 12. August 2020 für den Zugriff auf die Google-APIs statt JSON-RPC nur noch [[Representational State Transfer|REST]] verwendet werden kann.<ref>{{Internetquelle |autor=Rainald Menge-Sonnentag |url=https://www.heise.de/developer/meldung/Google-schickt-JSON-RPC-Zugriff-in-Rente-4487087.html |titel=Google schickt JSON-RPC-Zugriff in Rente |werk=heise online |datum=2019-08-02 |abruf=2019-08-04}}</ref>

== Weblinks ==
* [http://jsonrpc.org/ Die offizielle JSON-RPC Website]
* [http://groups.google.com/group/json-rpc JSON-RPC-Google Group] diskutiert Themen rund um JSON-RPC.
* [http://www.simple-is-better.org/json-rpc/ JSON-RPC Spezifikationen, Links usw.] simple-is-better.org
* [http://json-rpc.org/ Die offizielle JSON-RPC 1.0 Website] enthält unter anderem eine Liste der verfügbaren JSON-RPC 1.0 Implementierungen (veraltet).

== Einzelnachweise ==
<references />

{{SORTIERUNG:JSON RPC}}
[[Kategorie:Webservice]]
[[Kategorie:JSON]]

JSON-RPC - Versionsgeschichte

imported>Trustable: Einleitung