org.apache.felix.dm.lambda

Interface ServiceCallbacksBuilder<S,B extends ServiceCallbacksBuilder<S,B>>

Type Parameters:

S - the service dependency type

B - the type of a sub interface that may extends this interface.

All Known Subinterfaces:

ServiceAdapterBuilder<T>, ServiceAspectBuilder<T>, ServiceDependencyBuilder<S>

public interface ServiceCallbacksBuilder<S,B extends ServiceCallbacksBuilder<S,B>>

Builds a service dependency callback.

A Service may be injected in a bind-method of a component or an object instance using this builder. The builder supports reflection based callbacks (same as with the original DM API), as well as java8 method reference based callbacks.

List of signatures supported using reflection based callbacks (same as original DM API):

 
 method(S service)
 method(S service, Map<String, Object> serviceProperties)
 method(S service, Dictionary<String, Object> serviceProperties)
 method(ServiceReference<S> serviceRef, S service),
 method(ServiceReference<S> serviceRef)
 method(Component serviceComponent)
 method(Component serviceComponent, ServiceReference<S> serviceRef)
 method(Component serviceComponent, S service) 
 method(Component serviceComponent, ServiceReference<S> serviceRef, S service)
 swapMethod(S oldService, S newService)
 swapMethod(ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService)
 swapMethod(Component component, S oldService, S newService)
 swapMethod(Component component, ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService)
 

List of signatures supported using java 8 method references:

 
 method(S service)
 method(S service, ServiceReference<S> serviceRef),
 method(S service, Map<String, Object> serviceProperties)
 method(S service, Dictionary<String, Object> serviceProperties)
 method(S service, Component serviceComponent)
 method(S service, Component serviceComponent, ServiceReference<S> serviceRef)
 swapMethod(S oldService, S newService)
 swapMethod(S oldService, S newService, Component component))
 swapMethod(ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService)
 swapMethod(ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService, Component component)
 

Here is an example of a Component that defines a dependency of a LogService which is injected in the "setLog" method using a ServiceCallbacksBuilder: The withSvc(...)" declaration defines a method reference on the "Pojo::setLog" method (using a lambda):

 
 public class Activator extends DependencyManagerActivator {
    public void init(BundleContext ctx, DependencyManager dm) throws Exception { 
       component(comp -> comp.impl(Pojo.class).withSvc(LogService.class, log -> log.add(Pojo::setLog)));
    }
 }

Same example, but we inject the dependency to an object instance that we already have in hand:

 
 public class Activator extends DependencyManagerActivator {
    public void init(BundleContext ctx, DependencyManager dm) throws Exception {
       Pojo impl = new Pojo();
       component(comp -> comp.impl(impl).withSvc(LogService.class, log -> log.add(impl::setLog)));
    }
 }

Here, we inject a service using method reflection (as it is the case in original DM api):

 
 public class Activator extends DependencyManagerActivator {
    public void init(BundleContext ctx, DependencyManager dm) throws Exception {
       component(comp -> comp.impl(Pojo::class).withSvc(LogService.class, log -> log.add("setLog")));
    }
 }

Method Summary

Modifier and Type	Method and Description
<T> B	add(CbService<T,S> add) Sets a component callback(Service) method reference.
<T> B	add(CbServiceComponent<T,S> add) Sets a component callback(Service, Component) method reference.
<T> B	add(CbServiceComponentRef<T,S> add) Sets a component callback(Service, Component, ServiceReference ref) method reference.
<T> B	add(CbServiceDict<T,S> add) Sets a component callback(Service, Dictionary<String, Object>) method reference.
<T> B	add(CbServiceMap<T,S> add) Sets a component callback(Service, Map<String, Object>) method reference.
<T> B	add(CbServiceRef<T,S> add) Sets a component callback(Service, ServiceReference) method reference.
B	add(InstanceCbService<S> add) Sets an Object instance callback(Service) method reference.
B	add(InstanceCbServiceComponent<S> add) Sets an Object instance callback(Service, Component) method reference.
B	add(InstanceCbServiceComponentRef<S> add) Sets an Object instance callback(Service, Component, ServiceReference) method reference.
B	add(InstanceCbServiceDict<S> add) Sets an Object instance callback(Service svc, Dictionary<String, Object> method reference.
B	add(InstanceCbServiceMap<S> add) Sets an Object instance callback(Service, Map<String, Object>) method reference.
B	add(InstanceCbServiceRef<S> add) Sets an Object instance callback(Service, ServiceReference) method reference.
B	add(java.lang.String callback) Sets a callback method to invoke when a service is added.
B	callbackInstance(java.lang.Object callbackInstance) Sets the callback instance used for reflection based callbacks.
<T> B	change(CbService<T,S> change) Sets a component callback(Service) method reference.
<T> B	change(CbServiceComponent<T,S> change) Sets a component callback(Service, Component) method reference.
<T> B	change(CbServiceComponentRef<T,S> change) Sets a component callback(Service, Component, ServiceReference) method reference.
<T> B	change(CbServiceDict<T,S> change) Sets a component callback(Service, Dictionary<String, Object>) method reference.
<T> B	change(CbServiceMap<T,S> change) Sets a component callback(Service, Map<String, Object>) method reference.
<T> B	change(CbServiceRef<T,S> change) Sets a component callback(Service, ServiceReference) method reference.
B	change(InstanceCbService<S> change) Sets an Object instance callback(Service) method reference.
B	change(InstanceCbServiceComponent<S> change) Sets an Object instance callback(Service, Component) method reference.
B	change(InstanceCbServiceComponentRef<S> change) Sets an Object instance callback(Service, Component, ServiceReference) method reference.
B	change(InstanceCbServiceDict<S> change) Sets an Object instance callback(Service, Dictionary<String, Object>) method reference.
B	change(InstanceCbServiceMap<S> change) Sets an Object instance callback(Service, Map<String, Object>) method reference.
B	change(InstanceCbServiceRef<S> change) Sets an Object instance callback(Service, ServiceReference) method reference.
B	change(java.lang.String callback) Sets a callback methods to invoke when a service is changed.
<T> B	remove(CbService<T,S> remove) Sets a component callback(Service) method reference.
<T> B	remove(CbServiceComponent<T,S> remove) Sets a component callback(Service, Component) method reference.
<T> B	remove(CbServiceComponentRef<T,S> remove) Sets a component callback(Service, Component, ServiceReference) method reference.
<T> B	remove(CbServiceDict<T,S> remove) Sets a component callback(Service, Dictionary<String, Object>) method reference.
<T> B	remove(CbServiceMap<T,S> remove) Sets a component callback(Service, Map<String, Object></code>) method reference.
<T> B	remove(CbServiceRef<T,S> remove) Sets a component callback(Service, ServiceReference) method reference.
B	remove(InstanceCbService<S> remove) Sets an Object instance callback(Service) method reference.
B	remove(InstanceCbServiceComponent<S> remove) Sets an Object instance callback(Service, Component) method reference.
B	remove(InstanceCbServiceComponentRef<S> remove) Sets an Object instance callback(Service, Component, ServiceReference) method reference.
B	remove(InstanceCbServiceDict<S> remove) Sets an Object instance callback(Service, Dictionary<String, Object>) method reference.
B	remove(InstanceCbServiceMap<S> remove) Sets an Object instance callback(Service, Map<String, Object>) method reference.
B	remove(InstanceCbServiceRef<S> remove) Sets an Object instance callback(Service, ServiceReference) method reference.
B	remove(java.lang.String callback) Sets a callback method to invoke when a service is removed.
<T> B	swap(CbRefServiceRefService<T,S> swap) Sets a swap component callback(ServiceReference, Service, ServiceReference, Service) method reference.
<T> B	swap(CbRefServiceRefServiceComponent<T,S> swap) Sets a swap component callback(ServiceReference, Service, ServiceReference, Service, Component method reference.
<T> B	swap(CbServiceService<T,S> swap) Sets a swap component callback(Service, Service) method reference.
<T> B	swap(CbServiceServiceComponent<T,S> swap) Sets a wap component callback(Service, Service, Component) method reference.
B	swap(InstanceCbRefServiceRefService<S> swap) Sets a swap instance callback(ServiceReference, Service, ServiceReference, Service) method reference.
B	swap(InstanceCbRefServiceRefServiceComponent<S> swap) Sets a swap instance callback(ServiceReference, Service, ServiceReference, Service, Component) method reference.
B	swap(InstanceCbServiceService<S> swap) Sets a swap instance callback(Service, Service) method reference.
B	swap(InstanceCbServiceServiceComponent<S> swap) Sets a swap instance callback(Service, Service, Component) method reference.
B	swap(java.lang.String callback) Sets a callback method to invoke when a service is swapped.

Method Detail

callbackInstance

B callbackInstance(java.lang.Object callbackInstance)

Sets the callback instance used for reflection based callbacks.

Parameters:

callbackInstance - the object on which reflection based callbacks are invoked on.

Returns:

this builder

add

B add(java.lang.String callback)

Sets a callback method to invoke when a service is added. When a service matches the service filter, then the service is injected using the specified callback method. The callback is invoked on the component implementation, or on the callback instance, is specified using the callbackInstance(Object) method. The following method signature are supported:

 method(S service)
 method(S service, Map<String, Object> serviceProperties)
 method(S service, Dictionary<String, Object> serviceProperties)
 method(ServiceReference<S> serviceRef, S service),
 method(ServiceReference<S> serviceRef)
 method(Component serviceComponent)
 method(Component serviceComponent, ServiceReference<S> serviceRef)
 method(Component serviceComponent, S service) 
 method(Component serviceComponent, ServiceReference<S> serviceRef, S service)
 

Parameters:

callback - the add callback

Returns:

this builder

See Also:

callbackInstance(Object)

change

B change(java.lang.String callback)

Sets a callback methods to invoke when a service is changed. When a changed service matches the service filter, then the service is injected using the specified callback method. The callback is invoked on the component implementation, or on the callback instance, is specified using the callbackInstance(Object) method. The following method signature are supported:

 method(S service)
 method(S service, Map<String, Object> serviceProperties)
 method(S service, Dictionary<String, Object> serviceProperties)
 method(ServiceReference<S> serviceRef, S service),
 method(ServiceReference<S> serviceRef)
 method(Component serviceComponent)
 method(Component serviceComponent, ServiceReference<S> serviceRef)
 method(Component serviceComponent, S service) 
 method(Component serviceComponent, ServiceReference<S> serviceRef, S service)
 

Parameters:

callback - the change callback

Returns:

this builder

See Also:

callbackInstance(Object)

remove

B remove(java.lang.String callback)

Sets a callback method to invoke when a service is removed. When a removed service matches the service filter, then the specified callback in invoked with the removed service. The callback is invoked on the component implementation, or on the callback instance, is specified using the callbackInstance(Object) method. The following method signature are supported:

 method(S service)
 method(S service, Map<String, Object> serviceProperties)
 method(S service, Dictionary<String, Object> serviceProperties)
 method(ServiceReference<S> serviceRef, S service),
 method(ServiceReference<S> serviceRef)
 method(Component serviceComponent)
 method(Component serviceComponent, ServiceReference<S> serviceRef)
 method(Component serviceComponent, S service) 
 method(Component serviceComponent, ServiceReference<S> serviceRef, S service)
 

Parameters:

callback - the remove callback

Returns:

this builder

See Also:

callbackInstance(Object)

swap

B swap(java.lang.String callback)

Sets a callback method to invoke when a service is swapped. The callback is invoked on the component implementation, or on the callback instance, is specified using the callbackInstance(Object) method. The following method signature are supported:

 swapMethod(S oldService, S newService)
 swapMethod(ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService)
 swapMethod(Component component, S oldService, S newService)
 swapMethod(Component component, ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService)
 

Parameters:

callback - the remove callback

Returns:

this builder

See Also:

callbackInstance(Object)

add

<T> B add(CbService<T,S> add)

Sets a component callback(Service) method reference. The callback is invoked when a service is added. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

<T> B change(CbService<T,S> change)

Sets a component callback(Service) method reference. The callback is invoked when a service is changed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

<T> B remove(CbService<T,S> remove)

Sets a component callback(Service) method reference. The callback is invoked when a service is removed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

<T> B add(CbServiceMap<T,S> add)

Sets a component callback(Service, Map<String, Object>) method reference. The callback is invoked when a service is added. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

<T> B change(CbServiceMap<T,S> change)

Sets a component callback(Service, Map<String, Object>) method reference. The callback is invoked when a service is changed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

<T> B remove(CbServiceMap<T,S> remove)

Sets a component callback(Service, Map<String, Object></code>) method reference. The callback is invoked when a service is removed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

<T> B add(CbServiceDict<T,S> add)

Sets a component callback(Service, Dictionary<String, Object>) method reference. The callback is invoked when a service is added. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

<T> B change(CbServiceDict<T,S> change)

Sets a component callback(Service, Dictionary<String, Object>) method reference. The callback is invoked when a service is changed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

<T> B remove(CbServiceDict<T,S> remove)

Sets a component callback(Service, Dictionary<String, Object>) method reference. The callback is invoked when a service is removed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

<T> B add(CbServiceRef<T,S> add)

Sets a component callback(Service, ServiceReference) method reference. The callback is invoked when a service is added. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

<T> B change(CbServiceRef<T,S> change)

Sets a component callback(Service, ServiceReference) method reference. The callback is invoked when a service is changed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

<T> B remove(CbServiceRef<T,S> remove)

Sets a component callback(Service, ServiceReference) method reference. The callback is invoked when a service is removed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

<T> B add(CbServiceComponent<T,S> add)

Sets a component callback(Service, Component) method reference. The callback is invoked when a service is added. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

<T> B change(CbServiceComponent<T,S> change)

Sets a component callback(Service, Component) method reference. The callback is invoked when a service is changed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

<T> B remove(CbServiceComponent<T,S> remove)

Sets a component callback(Service, Component) method reference. The callback is invoked when a service is removed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

<T> B add(CbServiceComponentRef<T,S> add)

Sets a component callback(Service, Component, ServiceReference ref) method reference. The callback is invoked when a service is added. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

<T> B change(CbServiceComponentRef<T,S> change)

Sets a component callback(Service, Component, ServiceReference) method reference. The callback is invoked when a service is changed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

<T> B remove(CbServiceComponentRef<T,S> remove)

Sets a component callback(Service, Component, ServiceReference) method reference. The callback is invoked when a service is removed. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

B add(InstanceCbService<S> add)

Sets an Object instance callback(Service) method reference. The callback is invoked when a service is added. The method reference must point to a method from an Object instance.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

B change(InstanceCbService<S> change)

Sets an Object instance callback(Service) method reference. The callback is invoked when a service is changed. The method reference must point to method from an Object instance.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

B remove(InstanceCbService<S> remove)

Sets an Object instance callback(Service) method reference. The callback is invoked when a service is removed. The method reference must point to method from an Object instance.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

B add(InstanceCbServiceMap<S> add)

Sets an Object instance callback(Service, Map<String, Object>) method reference. The callback is invoked when a service is added. The method reference must point to a method from an Object instance.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

B change(InstanceCbServiceMap<S> change)

Sets an Object instance callback(Service, Map<String, Object>) method reference. The callback is invoked when a service is changed. The method reference must point to method from an Object instance.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

B remove(InstanceCbServiceMap<S> remove)

Sets an Object instance callback(Service, Map<String, Object>) method reference. The callback is invoked when a service is removed. The method reference must point to method from an Object instance.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

B add(InstanceCbServiceDict<S> add)

Sets an Object instance callback(Service svc, Dictionary<String, Object> method reference. The callback is invoked when a service is added. The method reference must point to a method from an Object instance.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

B change(InstanceCbServiceDict<S> change)

Sets an Object instance callback(Service, Dictionary<String, Object>) method reference. The callback is invoked when a service is changed. The method reference must point to method from an Object instance.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

B remove(InstanceCbServiceDict<S> remove)

Sets an Object instance callback(Service, Dictionary<String, Object>) method reference. The callback is invoked when a service is removed. The method reference must point to method from an Object instance.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

B add(InstanceCbServiceRef<S> add)

Sets an Object instance callback(Service, ServiceReference) method reference. The callback is invoked when a service is added. The method reference must point to a method from an Object instance.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

B change(InstanceCbServiceRef<S> change)

Sets an Object instance callback(Service, ServiceReference) method reference. The callback is invoked when a service is changed. The method reference must point to method from an Object instance.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

B remove(InstanceCbServiceRef<S> remove)

Sets an Object instance callback(Service, ServiceReference) method reference. The callback is invoked when a service is removed. The method reference must point to method from an Object instance.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

B add(InstanceCbServiceComponent<S> add)

Sets an Object instance callback(Service, Component) method reference. The callback is when a service is added. The method reference must point to a method from an Object instance.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

B change(InstanceCbServiceComponent<S> change)

Sets an Object instance callback(Service, Component) method reference. The callback is when a service is changed. The method reference must point to method from an Object instance.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

B remove(InstanceCbServiceComponent<S> remove)

Sets an Object instance callback(Service, Component) method reference. The callback is invoked when a service is removed. The method reference must point to method from an Object instance.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

add

B add(InstanceCbServiceComponentRef<S> add)

Sets an Object instance callback(Service, Component, ServiceReference) method reference. The callback is invoked when a service is added. The method reference must point to a method from an Object instance.

Parameters:

add - the method reference invoked when a service is added.

Returns:

this builder

change

B change(InstanceCbServiceComponentRef<S> change)

Sets an Object instance callback(Service, Component, ServiceReference) method reference. The callback is invoked when a service is changed. The method reference must point to method from an Object instance.

Parameters:

change - the method reference invoked when a service is changed.

Returns:

this builder

remove

B remove(InstanceCbServiceComponentRef<S> remove)

Sets an Object instance callback(Service, Component, ServiceReference) method reference. The callback is invoked when a service is removed. The method reference must point to method from an Object instance.

Parameters:

remove - the method reference invoked when a service is removed.

Returns:

this builder

swap

<T> B swap(CbServiceService<T,S> swap)

Sets a swap component callback(Service, Service) method reference. The callback is invoked when a service is swapped. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder

swap

<T> B swap(CbServiceServiceComponent<T,S> swap)

Sets a wap component callback(Service, Service, Component) method reference. The callback is invoked when a service is swapped. The method reference must point to a Component implementation class method.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder

swap

<T> B swap(CbRefServiceRefService<T,S> swap)

Sets a swap component callback(ServiceReference, Service, ServiceReference, Service) method reference. The callback is invoked when a service is swapped. The method reference must point to a Component implementation class method. the new service.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder

swap

<T> B swap(CbRefServiceRefServiceComponent<T,S> swap)

Sets a swap component callback(ServiceReference, Service, ServiceReference, Service, Component method reference. The callback is invoked when a service is swapped. The method reference must point to a Component implementation class method. the new service.

Type Parameters:

T - the type of the component implementation class on which the callback is invoked.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder

swap

B swap(InstanceCbServiceService<S> swap)

Sets a swap instance callback(Service, Service) method reference. The callback is invoked when a service is swapped. The method reference must point to a method from an Object instance.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder

swap

B swap(InstanceCbServiceServiceComponent<S> swap)

Sets a swap instance callback(Service, Service, Component) method reference. The callback is invoked when a service is swapped. The method reference must point to a method from an Object instance.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder

swap

B swap(InstanceCbRefServiceRefService<S> swap)

Sets a swap instance callback(ServiceReference, Service, ServiceReference, Service) method reference. The callback is invoked when a service is swapped. The method reference must point to a method from an Object instance.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder

swap

B swap(InstanceCbRefServiceRefServiceComponent<S> swap)

Sets a swap instance callback(ServiceReference, Service, ServiceReference, Service, Component) method reference. The callback is invoked when a service is swapped. The method reference must point to a method from an Object instance.

Parameters:

swap - the method reference invoked when the service is swapped.

Returns:

this builder