Changes between Initial Version and Version 1 of ExampleUsingXmlRpcCompliantTypes

Timestamp:

10/06/06 14:49:16 (18 years ago)

Author:

lauer

Comment:

--

ExampleUsingXmlRpcCompliantTypes

@@ +1 @@
+== Using XML-RPC compliant types in your API ==
+
+If ypu use types in your remote calls wich are XML-RPC compliant things are very easy:
+
+'''Server side'''
+
+ - The server side defines an API to be used remotely over XML-RPC. Additionaly an implementation
+   of the API is hosted on the server-side
+   
+{{{ 
+interface Api {
+  String getStatusMessage( int code );
+}
+
+class Impl implements Api {
+  public String getStatusMessage( int code ) {...}
+}
+}}}
+
+ - register implementation as XML-RPC handler with the server
+
+{{{
+WebServer xmlRpcServer = new WebServer( port );
+xmlRpcServer.addHandler( "handlerId", XmlRpcHandlerFactory.createHandlerFor( new Impl() );
+xmlRpcServer.start();
+}}}    
+
+'''Client side'''
+    
+ - create a remote client the use the API by simply calling a single method 
+
+{{{
+Api remote_api = XmlRpc.createClient( Api.class, "handlerId", host, port );
+String msg = remote_api.getStatusMessage( 42 );
+...
+}}} 
+