Package org.osgi.service.cdi.reference

Interface BindServiceReference<S>

Type Parameters:
S - the service argument type.
@ProviderType public interface BindServiceReference<S>
A bean provided by CCR for binding actions to life cycle events of matching services.
See Also:

  • Method Details

    • adding

      BindServiceReference<S> adding(Consumer<ServiceReference<S>> action)
      Subscribe an action to the adding service event.

      Only the last adding action is used.

      Parameters:
      action - the action, whose argument is the service reference, to subscribe to the adding service event
      Returns:
      self
      Throws:
      IllegalStateException - when called after bind()

    • adding

      BindServiceReference<S> adding(BiConsumer<ServiceReference<S>,S> action)
      Subscribe an action to the adding service event.

      Only the last adding action is used.

      Parameters:
      action - the action, whose arguments are the service reference and the service object, to subscribe to the adding service event
      Returns:
      self
      Throws:
      IllegalStateException - when called after bind()

    • modified

      BindServiceReference<S> modified(Consumer<ServiceReference<S>> action)
      Subscribe an action to the modified service event.

      Only the last modified action is used.

      Parameters:
      action - the action, whose argument is the service reference, to subscribe to the modified service event
      Returns:
      self
      Throws:
      IllegalStateException - when called after bind()

    • modified

      BindServiceReference<S> modified(BiConsumer<ServiceReference<S>,S> action)
      Subscribe an action to the modified service event.

      Only the last modified action is used.

      Parameters:
      action - the action, whose arguments are the service reference and the service object, to subscribe to the modified service event
      Returns:
      self
      Throws:
      IllegalStateException - when called after bind()

    • removed

      BindServiceReference<S> removed(Consumer<ServiceReference<S>> action)
      Subscribe an action to the removed service event.

      Only the last removed action is used.

      Parameters:
      action - the action, whose argument is the service reference, to subscribe to the removed service event
      Returns:
      self
      Throws:
      IllegalStateException - when called after bind()

    • removed

      BindServiceReference<S> removed(BiConsumer<ServiceReference<S>,S> action)
      Subscribe an action to the removed service event.

      Only the last removed action is used.

      Parameters:
      action - the action, whose arguments are the service reference and the service object, to subscribe to the removed service event
      Returns:
      self
      Throws:
      IllegalStateException - when called after bind()

    • bind

      void bind()
      The bind terminal operation is required to instruct CCR that all the bind actions have been specified, otherwise bind actions will never be called by CCR.

      Calling bind() again has no effect.