Page History

<binding.jsonrpc>

The Tuscany Java SCA runtime supports JSON-RPC as a protcol for use with SCA services by using the <binding.jsonrpc> SCDL extension.

This binding has no attributes or elements so to include it on a service simply requires the following SCDL:

   <binding.jsonrpc/>

The most common use of JSON-RPC is web browser clients making RPC style calls to server-side SCA services. To facilitate this Apache Tuscany provides a client-side script to initialize the SCA environement within the browser client.

    <script type="text/javascript" src="SCA/SCADomain/scaDomain.js" />

Using SCA JSON-RPC services with Dojo

Apache Tuscany JSON-RPC services provide built-in support for Dojo RPC. The Dojo toolkit is a popular framework for writing Ajax/Web 2.0 style browser client applications. Tuscany SCA services which use <binding.jsonrpc> will by default support the Simple Method Description (SMD) protocol. SMD is similar to ?wsdl for Web services, entering a service endpoint appended with ?smd will return a SMD descriptor for the service.

Using Tuscany SCA services with Dojo can therefore be as simple as the following:

  var myService = new dojo.rpc.JsonService("SCA/SCADomain/MyService?smd");

Some examples: