remoteservice.jar

Description
This bundle defines a service interface that enables to serve objects remotely by various middleware such as CORBA/IIOP, HTTP/SOAP, ...
For more details on how to use this bundle, refer to the /doc/readme.html file embedded in the bundle jarfile.

Contributors
Didier Donsez (Didier.Donsez@ieee.org)

License
LGPL

Services
org.ungoverned..osgi.service.remote.RemoteService

Properties
None

Requirements
None


Download

Build

  1. configure the build properties in build.xml
  2. then build with ant

The org.ungoverned.osgi.service.remote.RemoteService interface
This service interface defines a generic way to register a servant (also called handler) for serving remote invocations with various middlewares (CORBA IIOP, XMLRPC, SOAP/HTTP, ...)

RemoteService

Registered objets are served remotely by the bundle that provides the RemoteService.
RemoteService services must be registered with the RemoteService.TRANSPORT_TYPE property in the gateway since RemoteService services could have optional or mandatory properties for handler registration
The method Object registerHandler(Object handler, Dictionary properties) registers a handler (i.e. a servant) to the RemoteService with at least the RemoteService.TRANSPORT_TYPE property.
Other mandatory and optional properties could be provided and are specific to the "transport" middleware. Example, for CORBA IIOP, the list of the IDL interfaces names is required and the binding to a CosNaming service is mandatory.
The returned object is also specific to the "transport" layer but it must be used as parameter for handler unregistration with the unregisterHandler(Object registrationref)

Tested gateways