domino.java

Interface ServiceWatching

All Known Implementing Classes:

OsgiContext

public interface ServiceWatching

Provides convenient methods to add a service watcher to the current scope or wait until services are present.

Method Summary

Modifier and Type	Method and Description
<S> org.osgi.util.tracker.ServiceTracker<S,S>	watchAdvancedServices(java.lang.Class<S> type, java.lang.String filter, de.tototec.utils.functional.Procedure1<ServiceWatcherEvent<S>> f) Lets you react to service events for services with the specified type which match the given filter.
<S> org.osgi.util.tracker.ServiceTracker<S,S>	whenAdvancedServicePresent(java.lang.Class<S> type, java.lang.String filter, de.tototec.utils.functional.Procedure1<S> f) Activates the given inner logic as long as the first service of the given type is present.
<S> org.osgi.util.tracker.ServiceTracker<S,S>	whenServicePresent(java.lang.Class<S> type, de.tototec.utils.functional.Procedure1<S> f) Waits until a service of the specified type is available and executes the given event handler with it.
<S1,S2,S3,S4> org.osgi.util.tracker.ServiceTracker<S1,S1>	whenServicesPresent(java.lang.Class<S1> type1, java.lang.Class<S2> type2, java.lang.Class<S3> type3, java.lang.Class<S4> type4, de.tototec.utils.functional.Procedure4<S1,S2,S3,S4> f)
<S1,S2,S3> org.osgi.util.tracker.ServiceTracker<S1,S1>	whenServicesPresent(java.lang.Class<S1> type1, java.lang.Class<S2> type2, java.lang.Class<S3> type3, de.tototec.utils.functional.Procedure3<S1,S2,S3> f)
<S1,S2> org.osgi.util.tracker.ServiceTracker<S1,S1>	whenServicesPresent(java.lang.Class<S1> type1, java.lang.Class<S2> type2, de.tototec.utils.functional.Procedure2<S1,S2> f)

Method Detail

watchAdvancedServices

<S> org.osgi.util.tracker.ServiceTracker<S,S> watchAdvancedServices(java.lang.Class<S> type,
                                                                    java.lang.String filter,
                                                                    de.tototec.utils.functional.Procedure1<ServiceWatcherEvent<S>> f)

Lets you react to service events for services with the specified type which match the given filter.

Parameters:

type - The `Class` representing the service type.

filer - A filter criteria expression (LDAP-style filter) to further specify the service, or `null`.

f - Service event handler

Returns:

Underlying service tracker

whenAdvancedServicePresent

<S> org.osgi.util.tracker.ServiceTracker<S,S> whenAdvancedServicePresent(java.lang.Class<S> type,
                                                                         java.lang.String filter,
                                                                         de.tototec.utils.functional.Procedure1<S> f)

Activates the given inner logic as long as the first service of the given type is present. This implements the concept of required services. The inner logic is started as soon as a service s of the given type gets present and stopped when s is removed.

Parameters:

type - The `Class` representing the service type.

filer - A filter criteria expression (LDAP-style filter) to further specify the service, or `null`.

whenServicePresent

<S> org.osgi.util.tracker.ServiceTracker<S,S> whenServicePresent(java.lang.Class<S> type,
                                                                 de.tototec.utils.functional.Procedure1<S> f)

Waits until a service of the specified type is available and executes the given event handler with it. When the service disappears, the capsules added in the handlers are stopped. You can wait on a bunch of services if you nest `whenServicePresent` methods.

Parameters:

f - Handler

Returns:

Underlying service tracker

whenServicesPresent

<S1,S2> org.osgi.util.tracker.ServiceTracker<S1,S1> whenServicesPresent(java.lang.Class<S1> type1,
                                                                        java.lang.Class<S2> type2,
                                                                        de.tototec.utils.functional.Procedure2<S1,S2> f)

whenServicesPresent

<S1,S2,S3> org.osgi.util.tracker.ServiceTracker<S1,S1> whenServicesPresent(java.lang.Class<S1> type1,
                                                                           java.lang.Class<S2> type2,
                                                                           java.lang.Class<S3> type3,
                                                                           de.tototec.utils.functional.Procedure3<S1,S2,S3> f)

whenServicesPresent

<S1,S2,S3,S4> org.osgi.util.tracker.ServiceTracker<S1,S1> whenServicesPresent(java.lang.Class<S1> type1,
                                                                              java.lang.Class<S2> type2,
                                                                              java.lang.Class<S3> type3,
                                                                              java.lang.Class<S4> type4,
                                                                              de.tototec.utils.functional.Procedure4<S1,S2,S3,S4> f)