Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Initial mirror of pages/files from http://groups.google.com/group/jso…
- Loading branch information
0 parents
commit e5ccf4e
Showing
18 changed files
with
4,227 additions
and
0 deletions.
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,384 @@ | ||
<?xml version="1.0" encoding="utf-8" ?> | ||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> | ||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> | ||
<head> | ||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> | ||
<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" /> | ||
<title>JSON-RPC 1.2</title> | ||
<meta name="date" content="2007-12-24" /> | ||
<meta name="author" content="Roland Koebler (r dot koebler at yahoo dot de)" /> | ||
<style type="text/css"> | ||
|
||
/* | ||
:Author: David Goodger | ||
:Contact: goodger@users.sourceforge.net | ||
:Date: $Date: 2005-12-18 01:56:14 +0100 (Sun, 18 Dec 2005) $ | ||
:Revision: $Revision: 4224 $ | ||
:Copyright: This stylesheet has been placed in the public domain. | ||
|
||
Default cascading style sheet for the HTML output of Docutils. | ||
|
||
See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to | ||
customize this style sheet. | ||
*/ | ||
|
||
/* used to remove borders from tables and images */ | ||
.borderless, table.borderless td, table.borderless th { | ||
border: 0 } | ||
|
||
table.borderless td, table.borderless th { | ||
/* Override padding for "table.docutils td" with "! important". | ||
The right padding separates the table cells. */ | ||
padding: 0 0.5em 0 0 ! important } | ||
|
||
.first { | ||
/* Override more specific margin styles with "! important". */ | ||
margin-top: 0 ! important } | ||
|
||
.last, .with-subtitle { | ||
margin-bottom: 0 ! important } | ||
|
||
.hidden { | ||
display: none } | ||
|
||
a.toc-backref { | ||
text-decoration: none ; | ||
color: black } | ||
|
||
blockquote.epigraph { | ||
margin: 2em 5em ; } | ||
|
||
dl.docutils dd { | ||
margin-bottom: 0.5em } | ||
|
||
/* Uncomment (and remove this text!) to get bold-faced definition list terms | ||
dl.docutils dt { | ||
font-weight: bold } | ||
*/ | ||
|
||
div.abstract { | ||
margin: 2em 5em } | ||
|
||
div.abstract p.topic-title { | ||
font-weight: bold ; | ||
text-align: center } | ||
|
||
div.admonition, div.attention, div.caution, div.danger, div.error, | ||
div.hint, div.important, div.note, div.tip, div.warning { | ||
margin: 2em ; | ||
border: medium outset ; | ||
padding: 1em } | ||
|
||
div.admonition p.admonition-title, div.hint p.admonition-title, | ||
div.important p.admonition-title, div.note p.admonition-title, | ||
div.tip p.admonition-title { | ||
font-weight: bold ; | ||
font-family: sans-serif } | ||
|
||
div.attention p.admonition-title, div.caution p.admonition-title, | ||
div.danger p.admonition-title, div.error p.admonition-title, | ||
div.warning p.admonition-title { | ||
color: red ; | ||
font-weight: bold ; | ||
font-family: sans-serif } | ||
|
||
/* Uncomment (and remove this text!) to get reduced vertical space in | ||
compound paragraphs. | ||
div.compound .compound-first, div.compound .compound-middle { | ||
margin-bottom: 0.5em } | ||
|
||
div.compound .compound-last, div.compound .compound-middle { | ||
margin-top: 0.5em } | ||
*/ | ||
|
||
div.dedication { | ||
margin: 2em 5em ; | ||
text-align: center ; | ||
font-style: italic } | ||
|
||
div.dedication p.topic-title { | ||
font-weight: bold ; | ||
font-style: normal } | ||
|
||
div.figure { | ||
margin-left: 2em ; | ||
margin-right: 2em } | ||
|
||
div.footer, div.header { | ||
clear: both; | ||
font-size: smaller } | ||
|
||
div.line-block { | ||
display: block ; | ||
margin-top: 1em ; | ||
margin-bottom: 1em } | ||
|
||
div.line-block div.line-block { | ||
margin-top: 0 ; | ||
margin-bottom: 0 ; | ||
margin-left: 1.5em } | ||
|
||
div.sidebar { | ||
margin-left: 1em ; | ||
border: medium outset ; | ||
padding: 1em ; | ||
background-color: #ffffee ; | ||
width: 40% ; | ||
float: right ; | ||
clear: right } | ||
|
||
div.sidebar p.rubric { | ||
font-family: sans-serif ; | ||
font-size: medium } | ||
|
||
div.system-messages { | ||
margin: 5em } | ||
|
||
div.system-messages h1 { | ||
color: red } | ||
|
||
div.system-message { | ||
border: medium outset ; | ||
padding: 1em } | ||
|
||
div.system-message p.system-message-title { | ||
color: red ; | ||
font-weight: bold } | ||
|
||
div.topic { | ||
margin: 2em } | ||
|
||
h1.section-subtitle, h2.section-subtitle, h3.section-subtitle, | ||
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle { | ||
margin-top: 0.4em } | ||
|
||
h1.title { | ||
text-align: center } | ||
|
||
h2.subtitle { | ||
text-align: center } | ||
|
||
hr.docutils { | ||
width: 75% } | ||
|
||
img.align-left { | ||
clear: left } | ||
|
||
img.align-right { | ||
clear: right } | ||
|
||
ol.simple, ul.simple { | ||
margin-bottom: 1em } | ||
|
||
ol.arabic { | ||
list-style: decimal } | ||
|
||
ol.loweralpha { | ||
list-style: lower-alpha } | ||
|
||
ol.upperalpha { | ||
list-style: upper-alpha } | ||
|
||
ol.lowerroman { | ||
list-style: lower-roman } | ||
|
||
ol.upperroman { | ||
list-style: upper-roman } | ||
|
||
p.attribution { | ||
text-align: right ; | ||
margin-left: 50% } | ||
|
||
p.caption { | ||
font-style: italic } | ||
|
||
p.credits { | ||
font-style: italic ; | ||
font-size: smaller } | ||
|
||
p.label { | ||
white-space: nowrap } | ||
|
||
p.rubric { | ||
font-weight: bold ; | ||
font-size: larger ; | ||
color: maroon ; | ||
text-align: center } | ||
|
||
p.sidebar-title { | ||
font-family: sans-serif ; | ||
font-weight: bold ; | ||
font-size: larger } | ||
|
||
p.sidebar-subtitle { | ||
font-family: sans-serif ; | ||
font-weight: bold } | ||
|
||
p.topic-title { | ||
font-weight: bold } | ||
|
||
pre.address { | ||
margin-bottom: 0 ; | ||
margin-top: 0 ; | ||
font-family: serif ; | ||
font-size: 100% } | ||
|
||
pre.literal-block, pre.doctest-block { | ||
margin-left: 2em ; | ||
margin-right: 2em ; | ||
background-color: #eeeeee } | ||
|
||
span.classifier { | ||
font-family: sans-serif ; | ||
font-style: oblique } | ||
|
||
span.classifier-delimiter { | ||
font-family: sans-serif ; | ||
font-weight: bold } | ||
|
||
span.interpreted { | ||
font-family: sans-serif } | ||
|
||
span.option { | ||
white-space: nowrap } | ||
|
||
span.pre { | ||
white-space: pre } | ||
|
||
span.problematic { | ||
color: red } | ||
|
||
span.section-subtitle { | ||
/* font-size relative to parent (h1..h6 element) */ | ||
font-size: 80% } | ||
|
||
table.citation { | ||
border-left: solid 1px gray; | ||
margin-left: 1px } | ||
|
||
table.docinfo { | ||
margin: 2em 4em } | ||
|
||
table.docutils { | ||
margin-top: 0.5em ; | ||
margin-bottom: 0.5em } | ||
|
||
table.footnote { | ||
border-left: solid 1px black; | ||
margin-left: 1px } | ||
|
||
table.docutils td, table.docutils th, | ||
table.docinfo td, table.docinfo th { | ||
padding-left: 0.5em ; | ||
padding-right: 0.5em ; | ||
vertical-align: top } | ||
|
||
table.docutils th.field-name, table.docinfo th.docinfo-name { | ||
font-weight: bold ; | ||
text-align: left ; | ||
white-space: nowrap ; | ||
padding-left: 0 } | ||
|
||
h1 tt.docutils, h2 tt.docutils, h3 tt.docutils, | ||
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils { | ||
font-size: 100% } | ||
|
||
tt.docutils { | ||
background-color: #eeeeee } | ||
|
||
ul.auto-toc { | ||
list-style-type: none } | ||
|
||
</style> | ||
</head> | ||
<body> | ||
<div class="document" id="json-rpc-1-2"> | ||
<h1 class="title">JSON-RPC 1.2</h1> | ||
<table class="docinfo" frame="void" rules="none"> | ||
<col class="docinfo-name" /> | ||
<col class="docinfo-content" /> | ||
<tbody valign="top"> | ||
<tr><th class="docinfo-name">Date:</th> | ||
<td>2007-12-24</td></tr> | ||
<tr><th class="docinfo-name">Author:</th> | ||
<td>Roland Koebler (r <em>dot</em> koebler <em>at</em> yahoo <em>dot</em> de)</td></tr> | ||
</tbody> | ||
</table> | ||
<!-- -*- coding: utf-8 -*- --> | ||
<div class="section"> | ||
<h1><a id="differences-from-1-1wd" name="differences-from-1-1wd">Differences from 1.1WD</a></h1> | ||
<p>The <strong>most important</strong> differences are:</p> | ||
<ul> | ||
<li><p class="first"><strong>Transport independence</strong>: | ||
This specification is transport-independent, so you can use any | ||
transport you like. This removes <em>much</em> of the complexity of the 1.1WD. | ||
(1.1WD required HTTP.)</p> | ||
</li> | ||
<li><p class="first"><strong>Request</strong>:</p> | ||
<ul class="simple"> | ||
<li><tt class="docutils literal"><span class="pre">id</span></tt>: required for Requests (like in v1.0)</li> | ||
<li><tt class="docutils literal"><span class="pre">params</span></tt>: always required</li> | ||
<li><tt class="docutils literal"><span class="pre">version</span></tt>: removed (not necessary, because compatible to v1.0)</li> | ||
</ul> | ||
</li> | ||
<li><p class="first"><strong>Notifications:</strong> | ||
Notifications still exist (like in 1.0). Every Request with an <tt class="docutils literal"><span class="pre">id</span></tt> of | ||
Null is a notification. (1.1WD removed Notifications.)</p> | ||
</li> | ||
<li><p class="first"><strong>Parameter cleanup</strong>:</p> | ||
<ul> | ||
<li><div class="first line-block"> | ||
<div class="line">The <tt class="docutils literal"><span class="pre">params</span></tt>-syntax is <em>much</em> cleaner.</div> | ||
<div class="line">(1.1WD specified a complex syntax with some ambiguities.)</div> | ||
</div> | ||
</li> | ||
<li><div class="first line-block"> | ||
<div class="line">Either named or positional parameters are allowed, but not both in one | ||
call. (If needed, mixed named-and-positional parameters could be | ||
added later by an extension.)</div> | ||
<div class="line">(1.1WD allowed mixed parameters in a somehow strange way.)</div> | ||
</div> | ||
</li> | ||
<li><div class="first line-block"> | ||
<div class="line">"Null" is no special value. If any parameter has a value of "Null", that | ||
simply means that this parameter should be "Null".</div> | ||
<div class="line">(1.1WD used "Null" as a special value.)</div> | ||
</div> | ||
</li> | ||
<li><div class="first line-block"> | ||
<div class="line">"Null" is no special value, and a parameter-value of "Null" simply means | ||
that t parameter should be "Null".</div> | ||
<div class="line">(1.1WD used "Null" as a special value.)</div> | ||
</div> | ||
</li> | ||
</ul> | ||
</li> | ||
<li><p class="first"><strong>Response</strong>: | ||
- <tt class="docutils literal"><span class="pre">result</span></tt>, <tt class="docutils literal"><span class="pre">error</span></tt>: both are always required. | ||
- <tt class="docutils literal"><span class="pre">id</span></tt>: required | ||
- <tt class="docutils literal"><span class="pre">version</span></tt>: removed</p> | ||
</li> | ||
<li><p class="first"><strong>Error Object cleanup</strong>: | ||
The <tt class="docutils literal"><span class="pre">name</span></tt> member was removed, because it does not provide any | ||
information. The error-codes were defined.</p> | ||
</li> | ||
<li><p class="first"><strong>Service Description</strong>: | ||
Use different service descriptions than 1.1WD, and describe them in a | ||
separate specification.</p> | ||
</li> | ||
<li><p class="first"><strong>Member Sequence removed</strong>: | ||
No special member sequence is necessary. | ||
(1.1WD suggested the members of the JSON-RPC-object to be in a specific | ||
order, and allowed the server to refuse requests which do not stick to | ||
this order.)</p> | ||
</li> | ||
<li><p class="first"><strong>No magic</strong>: | ||
Procedure Call Parity and Call Approximation were removed in this | ||
specification. A Service must be called <em>exactly</em> as specified. | ||
The server must not "guess".</p> | ||
</li> | ||
</ul> | ||
</div> | ||
</div> | ||
</body> | ||
</html> |
Oops, something went wrong.