outaTiME / jquery-jsonrpc

jQuery JSON-RPC Plugin.

jQuery JSON-RPC Plugin

A JSON-RPC 2.0 implementation for jQuery.

What is JSON-RPC?

JSON-RPC is a lightweight remote procedure call protocol. It's designed to be simple!

Usage

Invocation

$.jsonrpc({
  id: 1,
  url: "foo",
  method: "method",
  params: {
    // pass
  },
  success: function (response) {
    // pass
  },
  fault: function (response, errordata) {
    // pass
  },
  error: function (request, status, error) {
    // pass
  }
});

Parameter detail

• id: The request id (optional).

• url: A string containing the URL to which the request is sent.

• method: A String containing the name of the method to be invoked.

• params: An object to pass as arguments to the method (optional).

• success: A function to be called if the request succeeds (optional).

• fault: A function to be called if the request succeeds (but with error response) (optional).

• error: A function to be called if the request fails (optional).

Examples

// A RPC call with named parameters
$.jsonrpc({
  url: "/rpc",
  method: "createUser",
  params: {
    name: "John Smith",
    userId: 1000
  },
  success: function (response) {
    // pass
  },
  fault: function (response, errordata) {
    // pass
  },
  error: function (request, status, error) {
    // pass
  }
});

// A Notification
$.jsonrpc({
  url: "/rpc",
  method: "notify",
  params: {
    action: "logout",
    userId: 1000
  }
});

// A Notification using console to debug and with timeout set
$.jsonrpc({
  url: "/rpc"
  method: "notify",
  params: {
    action: "logout",
    userId: 1000
  },
  timeout: 500
});