Class Mama


  • public class Mama
    extends java.lang.Object
    • Method Detail

      • loadBridge

        public static MamaBridge loadBridge​(java.lang.String middleware,
                                            java.lang.String path)
      • loadBridge

        public static MamaBridge loadBridge​(java.lang.String middleware)
      • loadPayloadBridge

        public static MamaPayloadBridge loadPayloadBridge​(java.lang.String name)
      • open

        public static void open()
        Initialize MAMA. MAMA employs a reference count to track multiple calls to Mama.open() and Mama.close(). The count is incremented every time Mama.open() is called and decremented when Mama.close() is called. The resources are not actually released until the count reaches zero. If entitlements are enabled for the library, the available entitlement server names are read from the entitlement.servers property in the mama.properties file located in the \$WOMBAT_PATH directory. This function is thread safe.
      • open

        public static void open​(java.lang.String path,
                                java.lang.String filename)
        Initialize MAMA. Allows users of the API to override the default behavior of Mama.open() where a file mama.properties is required to be located in the directory specified by \$WOMBAT_PATH. The properties file must have the same structure as a standard mama.properties file. If null is passed as the path the API will look for the properties file on the \$WOMBAT_PATH. If null is passed as the filename the API will look for the default filename of mama.properties.
      • start

        public static void start​(MamaBridge bridge)
        Start processing messages on the internal queue. This starts Mama's internal throttle, refresh logic, and other internal Mama processes as well as dispatching messages from the internal queue.

        Mama.start( ) blocks until an invocation of Mama.stop() occurs. MAMA employs a reference count to track multiple calls to Mama.start() and Mama.stop(). The count is incremented every time Mama.start() is called and decremented when Mama.stop() is called. The first Mama.start() call does not unblock until the count reaches zero. This function is thread safe.

      • startBackground

        public static void startBackground​(MamaBridge bridge,
                                           MamaStartBackgroundCallback callback)
        Start processing MAMA internal events in the background. This method invokes Mama::start () in a separate thread.
      • stop

        public static void stop​(MamaBridge bridge)
        Stop dispatching on the default event queue for the specified bridge. MAMA employs a reference count to track multiple calls to Mama.start() and Mama.stop(). The count is incremented every time Mama.start() is called and decremented when Mama.stop() is called. The first Mama.start() call does not unblock until the count reaches zero. This function is thread safe.
      • close

        public static void close()
        Close MAMA and free all associated resource. MAMA employs a reference count to track multiple calls to Mama.open() and Mama.close(). The count is incremented every time Mama.open() is called and decremented when Mama.close() is called. The resources are not actually released until the count reaches zero. This function is thread safe.
      • enableLogging

        public static void enableLogging​(java.util.logging.Level level)
      • setLogCallback

        public static void setLogCallback​(MamaLogFileCallback2 callback)
                                   throws java.lang.IllegalArgumentException
        Throws:
        java.lang.IllegalArgumentException
      • log

        public static void log​(MamaLogLevel level,
                               java.lang.String message)
      • enableLogging

        public static void enableLogging​(java.util.logging.Level level,
                                         java.lang.String file)
                                  throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
      • logToFile

        public static void logToFile​(java.lang.String file,
                                     java.util.logging.Level level)
                              throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
      • disableLogging

        public static void disableLogging()
      • getLogLevel

        public static java.util.logging.Level getLogLevel()
      • setLogLevel

        public static void setLogLevel​(java.util.logging.Level level)
      • setLogFilePolicy

        public static void setLogFilePolicy​(MamaLogFilePolicy policy)
      • getProperty

        public static java.lang.String getProperty​(java.lang.String name)
      • setProperty

        public static void setProperty​(java.lang.String name,
                                       java.lang.String value)
      • setLogSize

        public static void setLogSize​(long size)
      • setNumLogFiles

        public static void setNumLogFiles​(int numFiles)
      • setAppendToLogFile

        public static void setAppendToLogFile​(boolean append)
      • loggingToFile

        public static boolean loggingToFile()
      • getMamaLogLevelForLevel

        public static MamaLogLevel getMamaLogLevelForLevel​(java.util.logging.Level level)
      • getMamaLevelForLevel

        public static int getMamaLevelForLevel​(java.util.logging.Level level)
      • setApplicationName

        public static void setApplicationName​(java.lang.String applicationName)
      • setApplicationClassName

        public static void setApplicationClassName​(java.lang.String applicationClassName)
      • getApplicationName

        public static java.lang.String getApplicationName()
      • getApplicationClassName

        public static java.lang.String getApplicationClassName()
      • getCUserName

        public static java.lang.String getCUserName()
      • getCHostName

        public static java.lang.String getCHostName()
      • getUserName

        public static java.lang.String getUserName()
        getUserName get the user name for the application
        Returns:
        String the user name
      • getHostName

        public static java.lang.String getHostName()
        getHostName get the host name of the machine
        Returns:
        String the hostname
      • getIpAddress

        public static java.lang.String getIpAddress()
        getIpAddress get the ip address of the machine
        Returns:
        String the IP address
      • getVersion

        public static java.lang.String getVersion​(MamaBridge bridge)
      • getLastErrorCode

        public static int getLastErrorCode()
      • getLastErrorText

        public static java.lang.String getLastErrorText()