com.supermap.services.event

Class EventUtils

  • java.lang.Object
    • com.supermap.services.event.EventUtils

  • public final class EventUtils
extends java.lang.Object

    Event message tool class. Used for getting the delegate object witch send messages, or registering message listener.

     public class EventUtilsTest {
 public static interface TestListener {
 void method();
 }
 public static class TestListenerImplOne implements TestListener {
 public boolean invoked = false;
 public void method() {
 invoked = true;
 System.out.println("TestListenerImplOne.method() invoked");
 }
 }
 public static class TestListenerImplTwo implements TestListener {
 public boolean invoked = false;
 public void method() {
 invoked = true;
 System.out.println("TestListenerImplTwo.method() invoked");
 }
 }
 public static void main(String[] args) {
 TestListenerImplOne listener1 = new TestListenerImplOne();
 EventUtils.registerEventListener(TestListener.class, listener1);
 TestListenerImplTwo listener2 = new TestListenerImplTwo();
 EventUtils.registerEventListener(TestListener.class, listener2);
 TestListener sender = EventUtils.getDelegate(TestListener.class);
 sender.method();
 while(!(listener1.invoked && listener2.invoked)) {
 Thread.yield();
 }
 //The application will output:
 //TestListenerImplTwo.method() invoked
 //TestListenerImplOne.method() invoked
 //Or
 //TestListenerImplOne.method() invoked
 //TestListenerImplTwo.method() invoked
 ///
 //The order and time of calling listener1 and listener2 are indeterminated.
 EventUtils.dipose();
 }
 }

    • Constructor Summary

      Constructors 
      Constructor and Description
      EventUtils() 

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      static void dipose()
      Destroy the thread pool which sends messages.
      static <T> T getDelegate(java.lang.Class<T> eventType)
      Gets a delegate object used for sending messages.
      static void init()
      Initialize the thread pool which sends messages.
      static <T> void registerEventListener(java.lang.Class<T> eventType, T listener)
      Register a message listener.
      static <T> void removeListener(java.lang.Class<T> eventType, T listener) 

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • EventUtils

        public EventUtils()

    • Method Detail

      • registerEventListener

        public static <T> void registerEventListener(java.lang.Class<T> eventType,
                             T listener)

        Register a message listener.

        Parameters:
        eventType - Register event listener interface types. This parameter must be a interface or else no operation will be performed.
        listener - The receive message instance.

      • removeListener

        public static <T> void removeListener(java.lang.Class<T> eventType,
                      T listener)

      • getDelegate

        public static <T> T getDelegate(java.lang.Class<T> eventType)

        Gets a delegate object used for sending messages. This function requires a instance which has a parameter interface and returns a instance of the same type. This function can send messages by directly call the corresponding method. Only call the methods with its return value void, or the action will be indeterminated.

        Parameters:
        eventType - The message interface type to get, this parameter must be a interface.
        Returns:
        A delegate object which sends messages.

      • dipose

        public static void dipose()

        Destroy the thread pool which sends messages.

      • init

        public static void init()

        Initialize the thread pool which sends messages. This method don't need to be called by default. Call this method is needed only when you want to use it after dipose() has been called.