Package org.apache.felix.eventadmin.impl.handler

Class EventAdminImpl

java.lang.Object
org.apache.felix.eventadmin.impl.handler.EventAdminImpl
All Implemented Interfaces:
org.osgi.service.event.EventAdmin
public class EventAdminImpl
extends java.lang.Object
implements org.osgi.service.event.EventAdmin
This is the actual implementation of the OSGi R4 Event Admin Service (see the Compendium 113 for details). The implementation uses a HandlerTasks in order to determine applicable EventHandler for a specific event and subsequently dispatches the event to the handlers via DeliverTasks. To do this, it uses two different DeliverTasks one for asynchronous and one for synchronous event delivery depending on whether its post() or its send() method is called. Note that the actual work is done in the implementations of the DeliverTasks. Additionally, a stop method is provided that prevents subsequent events to be delivered.
Author:
Felix Project Team

  • Nested Class Summary

    Nested Classes 
    Modifier and Type Class Description
    static interface  EventAdminImpl.EventHandlerMBean  

  • Constructor Summary

    Constructors 
    Constructor Description
    EventAdminImpl​(org.osgi.framework.BundleContext bundleContext, DefaultThreadPool syncPool, DefaultThreadPool asyncPool, int timeout, java.lang.String[] ignoreTimeout, boolean requireTopic, java.lang.String[] ignoreTopics)
    The constructor of the EventAdmin implementation.

  • Method Summary

    Modifier and Type Method Description
    java.lang.Object getHandlerInfoMBean()  
    void postEvent​(org.osgi.service.event.Event event)
    Post an asynchronous event.
    void sendEvent​(org.osgi.service.event.Event event)
    Send a synchronous event.
    void stop()
    This method can be used to stop the delivery of events.
    void update​(int timeout, java.lang.String[] ignoreTimeout, boolean requireTopic, java.lang.String[] ignoreTopics)
    Update the event admin with new configuration.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • EventAdminImpl

      public EventAdminImpl​(org.osgi.framework.BundleContext bundleContext, DefaultThreadPool syncPool, DefaultThreadPool asyncPool, int timeout, java.lang.String[] ignoreTimeout, boolean requireTopic, java.lang.String[] ignoreTopics)
      The constructor of the EventAdmin implementation.
      Parameters:
      bundleContext - The event admin bundle context
      syncPool - The synchronous thread pool
      asyncPool - The asynchronous thread pool
      timeout - The timeout
      ignoreTimeout - The configuration for ignoring timeouts
      requireTopic - Are topics required?
      ignoreTopics - The configuration to ignore topics

  • Method Details

    • postEvent

      public void postEvent​(org.osgi.service.event.Event event)
      Post an asynchronous event.
      Specified by:
      postEvent in interface org.osgi.service.event.EventAdmin
      Parameters:
      event - The event to be posted by this service
      Throws:
      java.lang.IllegalStateException - - In case we are stopped
      See Also:
      EventAdmin.postEvent(org.osgi.service.event.Event)

    • sendEvent

      public void sendEvent​(org.osgi.service.event.Event event)
      Send a synchronous event.
      Specified by:
      sendEvent in interface org.osgi.service.event.EventAdmin
      Parameters:
      event - The event to be send by this service
      Throws:
      java.lang.IllegalStateException - - In case we are stopped
      See Also:
      EventAdmin.sendEvent(org.osgi.service.event.Event)

    • stop

      public void stop()
      This method can be used to stop the delivery of events.

    • update

      public void update​(int timeout, java.lang.String[] ignoreTimeout, boolean requireTopic, java.lang.String[] ignoreTopics)
      Update the event admin with new configuration.
      Parameters:
      timeout - The timeout
      ignoreTimeout - The configuration for ignoring timeouts
      requireTopic - Are topics required?
      ignoreTopics - The configuration to ignore topics

    • getHandlerInfoMBean

      public java.lang.Object getHandlerInfoMBean()