Changes between Initial Version and Version 1 of ExampleUsingConverterRegistry

Timestamp:

07/28/09 18:21:07 (16 years ago)

Author:

lauer

Comment:

--

ExampleUsingConverterRegistry

@@ +1 @@
+== Using Third Party Types in your API ==
+
+Sometimes it is dicouraged to have any XML-RPC or Delight reference in an interface class. In order to still use this interface
+with Delight a {{{ParameterConverterRegistry}}} has been introduced. See also [wiki:ExampleUsingThirdPartyTypes].
+
+{{{
+*** SOMETIMES DISCOURAGED ***
+@ConverterMappings( 
+      @Mapping(type=URL.class,converter=URLConverter.class) 
+)
+public interface Api
+{
+    URL getHomepageLocation();
+    void addSite( URL url );
+}
+}}}
+
+Alternative with '''ParameterConverterRegistry:'''
+
+{{{
+public interface Api
+{
+    URL getHomepageLocation();
+    void addSite( URL url );
+}
+}}}
+
+Now, without having to annotate the interface invoking the methods looks like this:
+{{{
+ParameterConverterRegistry.setParameterConverterForClass( URL.class, URLConverter.class );
+Api remote_api = XmlRpc.createClient( Api.class, "handlerId", host, port );
+
+URL homepageUrl = remote_api.getHomepageLocation();
+InputStream is = homepageUrl.openStream();
+...
+
+remote_api.addSite( new URL( "http://middle.of.nowhere" ) );
+
+...
+}}}
+
+'''NOTE:''' Client '''AND''' Server have to register the converter prior to a remote call.