Package org.eclipse.ecf.remoteservice
Interface IRemoteServiceHost
- 
- All Superinterfaces:
- org.eclipse.core.runtime.IAdaptable
 - All Known Subinterfaces:
- IOSGiRemoteServiceContainerAdapter,- IRemoteServiceClientContainerAdapter,- IRemoteServiceContainerAdapter
 - All Known Implementing Classes:
- AbstractClientContainer,- AbstractRestClientContainer,- AbstractRSAClientContainer,- RegistrySharedObject,- RemoteServiceContainer,- RemoteServiceContainerAdapterImpl,- RestClientContainer,- RSARemoteServiceContainerAdapter,- ServletServerContainer
 
 public interface IRemoteServiceHost extends org.eclipse.core.runtime.IAdaptable- Since:
- 5.0
 
- 
- 
Method SummaryAll Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddRemoteServiceListener(IRemoteServiceListener listener)Add listener for remote service registration/unregistration for this containerIRemoteServiceIDgetRemoteServiceID(ID containerID, long containerRelativeID)Get a remote service ID from a containerID and a containerRelative long value.NamespacegetRemoteServiceNamespace()Get namespace to use for this remote service provider.IRemoteServiceRegistrationregisterRemoteService(String[] clazzes, Object service, Dictionary properties)Register a new remote service.voidremoveRemoteServiceListener(IRemoteServiceListener listener)Remove remote service registration/unregistration listener for this container.
 
- 
- 
- 
Method Detail- 
registerRemoteServiceIRemoteServiceRegistration registerRemoteService(String[] clazzes, Object service, Dictionary properties) Register a new remote service. This method is to be called by the service server...i.e. the client that wishes to make available a service to other client within this container.- Parameters:
- clazzes- the interface classes that the service exposes to remote clients. Must not be- nulland must not be an empty array.
- service- the service object. Under normal conditions this object must- not be null
- implement all of the classes specified by the first parameter
 - nullis if the service property- Constants.SERVICE_REGISTER_PROXYis set in the properties. If- Constants.SERVICE_REGISTER_PROXYis set in the properties parameter (to an arbitrary value), then the service object may then be- null.
- not be 
- properties- to be associated with service
- Returns:
- IRemoteServiceRegistration the service registration. Will not
         return null.
 
 - 
addRemoteServiceListenervoid addRemoteServiceListener(IRemoteServiceListener listener) Add listener for remote service registration/unregistration for this container- Parameters:
- listener- notified of service registration/unregistration events. Must not be- null.
 
 - 
removeRemoteServiceListenervoid removeRemoteServiceListener(IRemoteServiceListener listener) Remove remote service registration/unregistration listener for this container.- Parameters:
- listener- to remove. Must not be- null.
 
 - 
getRemoteServiceNamespaceNamespace getRemoteServiceNamespace() Get namespace to use for this remote service provider.- Returns:
- Namespace to use for creating IRemoteServiceID for this remote service provider.  Will
 not return null.
- Since:
- 3.0
 
 - 
getRemoteServiceIDIRemoteServiceID getRemoteServiceID(ID containerID, long containerRelativeID) Get a remote service ID from a containerID and a containerRelative long value. Will return a non-null value if the IRemoteServiceRegistration/Reference is currently 'known' to this container adapter.nullif not.- Parameters:
- containerID- the containerID that is the server/host for the remote service. Must not be- null. This must be the containerID for the server/host of the remote service.
- containerRelativeID- the long value identifying the remote service relative to the container ID.
- Returns:
- IRemoteServiceID instance if the associated IRemoteServiceRegistration/Reference is known to this container
 adapter, nullif it is not.
- Since:
- 3.0
 
 
- 
 
-