Class PMController


  • public class PMController
    extends Object
    The PMController class allows to merge several input PEAR files in one PEAR file and generate an aggregate analysis engine from the components encapsulated in the input PEARs.
    See Also:
    PMControllerHelper, PMUimaAgent
    • Constructor Summary

      Constructors 
      Constructor Description
      PMController​(File[] inpPearFiles, String outCompName, File outPearFile)
      Constructor that takes a given array of input PEAR files, a given output component name (ID) and a given output PEAR file.
    • Constructor Detail

      • PMController

        public PMController​(File[] inpPearFiles,
                            String outCompName,
                            File outPearFile)
                     throws IOException
        Constructor that takes a given array of input PEAR files, a given output component name (ID) and a given output PEAR file.
        Parameters:
        inpPearFiles - The given array of input PEAR files.
        outCompName - The given output component name (ID).
        outPearFile - The given output PEAR file.
        Throws:
        IOException - If any I/O exception occurred during initialization.
    • Method Detail

      • main

        public static void main​(String[] args)
        The command line application entry point. This method expects the following command line arguments:
        • pear_file_1 ... pear_file_n - input PEAR files (required)
        • -n agg_name - a name of the output aggregate analysis engine (required)
        • -f agg_pear_file - output aggregate PEAR file (optional).
          If the output PEAR file is not specified, the default output PEAR file is created in the current working directory.
        Parameters:
        args - pear_file_1 ... pear_file_n -n agg_name [-f agg_pear_file]
      • getLogger

        public static Logger getLogger()
        Returns the instance of the class-specific Logger object.
        Returns:
        The instance of the class-specific Logger object.
      • logErrorMessage

        public static void logErrorMessage​(String message)
        Logs a given error message to the log file and prints it to the standard error console stream.
        Parameters:
        message - The given error message.
      • logInfoMessage

        public static void logInfoMessage​(String message)
        Logs a given info message to the log file and prints it to the standard output console stream.
        Parameters:
        message - The given info message.
      • logWarningMessage

        public static void logWarningMessage​(String message)
        Logs a given warning message to the log file and prints it to the standard error console stream.
        Parameters:
        message - The given warning message.
      • setLogFileEnabled

        public static void setLogFileEnabled​(boolean enable)
        Enables/disables PM log file. By default, the log file is disabled.
        Parameters:
        enable - if true, the log file is enabled, otherwise it is disabled.
      • cleanUp

        public void cleanUp()
                     throws IOException
        Deletes all temporary directories and files after the merging operation is completed.
        Throws:
        IOException - If an I/O exception occurred.
      • mergePears

        public boolean mergePears()
                           throws IOException
        Merges specified input PEARs into one PEAR, which encapsulates aggregate AE that refers to input components, as delegates. Returns true, if the merging operation completed successfully, false otherwise.
        Returns:
        true, if the merge operation completed successfully, false otherwise.
        Throws:
        IOException - If an I/O exception occurred during the merging operation.