Package akka.dispatch

Class Dispatchers


  • public class Dispatchers
    extends java.lang.Object
    The one and only default dispatcher.
    • Method Detail

      • DefaultDispatcherId

        public static final java.lang.String DefaultDispatcherId()
      • defaultDispatcherConfig

        public com.typesafe.config.Config defaultDispatcherConfig()
      • defaultGlobalDispatcher

        public MessageDispatcher defaultGlobalDispatcher()
        The one and only default dispatcher.
        Returns:
        (undocumented)
      • lookup

        public MessageDispatcher lookup​(java.lang.String id)
        Returns a dispatcher as specified in configuration. Please note that this method _may_ create and return a NEW dispatcher, _every_ call.

        Throws ConfigurationException if the specified dispatcher cannot be found in the configuration.

        Parameters:
        id - (undocumented)
        Returns:
        (undocumented)
      • hasDispatcher

        public boolean hasDispatcher​(java.lang.String id)
        Checks that the configuration provides a section for the given dispatcher. This does not guarantee that no ConfigurationException will be thrown when using this dispatcher, because the details can only be checked by trying to instantiate it, which might be undesirable when just checking.
        Parameters:
        id - (undocumented)
        Returns:
        (undocumented)
      • registerConfigurator

        public boolean registerConfigurator​(java.lang.String id,
                                            MessageDispatcherConfigurator configurator)
        Register a MessageDispatcherConfigurator that will be used by lookup(java.lang.String) and hasDispatcher(java.lang.String) instead of looking up the configurator from the system configuration. This enables dynamic addition of dispatchers, as used by the BalancingPool.

        A configurator for a certain id can only be registered once, i.e. it can not be replaced. It is safe to call this method multiple times, but only the first registration will be used. This method returns true if the specified configurator was successfully registered.

        Parameters:
        id - (undocumented)
        configurator - (undocumented)
        Returns:
        (undocumented)
      • config

        public com.typesafe.config.Config config​(java.lang.String id)
        INTERNAL API
        Parameters:
        id - (undocumented)
        Returns:
        (undocumented)
      • config

        public com.typesafe.config.Config config​(java.lang.String id,
                                                 com.typesafe.config.Config appConfig)
        INTERNAL API
        Parameters:
        id - (undocumented)
        appConfig - (undocumented)
        Returns:
        (undocumented)
      • from

        public MessageDispatcher from​(com.typesafe.config.Config cfg)
        INTERNAL API

        Creates a dispatcher from a Config. Internal test purpose only.

        ex: from(config.getConfig(id))

        The Config must also contain a id property, which is the identifier of the dispatcher.

        Throws: IllegalArgumentException if the value of "type" is not valid IllegalArgumentException if it cannot create the MessageDispatcherConfigurator

        Parameters:
        cfg - (undocumented)
        Returns:
        (undocumented)