<commit_before><?php

namespace core;

/**
 * Абстрактный класс приложения. Определяет центральную точку входа для всех запросов, 
 * создает конфигурированное приложение. 
 * Реализует шаблон Front Controller, является Singleton-ом.
 * @author coon
 */
abstract class AApplication extends AAutoAccessors implements IFrontController, IRunnable {

    /** @var string Путь к корню файла конфигурации. */
    public $configFile = NULL;

    /** @var self Объект-singleton текущего класса. */
    protected static $_instance = NULL;

    /**
     * @ignore.
     */
    protected function __construct() {
        // nothing here...
    }

    /**
     * Возвращает singleton-экземпляр контекстно-вызываемого класса. Реализует
     * позднее статическое связывание.
     * @return self.
     */
    public static function getInstance() {
        if (is_null(static::$_instance)) {
            static::$_instance = new static();
        }
        return static::$_instance;
    }

    /**
     * Устанавливает путь к файлу с основной конфигурацией приложения относительно
     * его корня.
     * @param string $sFilePath.
     * @return self.
     */
    public function setConfigFile($sFilePath) {
        $this->configFile = $sFilePath;
        return static::$_instance;
    }

    /**
     * {@inheritdoc}
     */
    public function run() {
        $this->init();
    }

    /**
     * {@inheritdoc}
     */
    public function init() {
        $this->_initHelper();
        $this->_initAutoload();
        $this->_initUserProcess();
        $this->handleRequest();
        $this->_stopUserProcess();
    }

    /**
     * {@inheritdoc}
     */
    abstract public function handleRequest();

    /**
     * Инициализирует Помощник приложения.
     * @return void.
     */
    private function _initHelper() {
        if (!$this->isConfigFileSet()) {
            throw new Exception("Main config file isn't define.");
        }
        AppHelper::getInstance()
                ->setAppRoot(Autoloader::getInstance()->getAppRoot())
                ->setConfigFile($this->getConfigFile())
                ->run();
    }

    /**
     * Инициализация автоподгрузки всех классов приложения. Объект Автоподгрузчика 
     * получает все корни директорий из объекта Помощника приложения, после чего 
     * связывает их с автоподгрузкой. 
     * @return void.
     */
    private function _initAutoload() {
        $mRoot = AppHelper::getInstance()->getConfig('autoloadingRootSet');
        foreach ($mRoot ? : array() as $sRoot) {
            Autoloader::getInstance()->add($sRoot);
        }
        Autoloader::getInstance()->run();
    }

    /**
     * Метод выполняет запуск пользовательских процессов.
     * @return void.
     */
    private function _initUserProcess() {
        \extensions\core\Process::getInstance()->run();
    }

    /**
     * Метод останавливает пользовательские процессы.
     * @return void.
     */
    private function _stopUserProcess() {
        \extensions\core\Process::getInstance()->stop();
    }

}<commit_msg>The phpDoc was corrected.<commit_after><?php

namespace core;

/**
 * This's an abstract application class. It determines the central entry point for
 * the all requests, creates the configured application. It implements Front 
 * Controller pattern, it's Singleton-instance.
 * @author coon
 */
abstract class AApplication extends AAutoAccessors implements IFrontController, IRunnable {

    /** @var string This's path to the config file root. */
    public $configFile = NULL;

    /** @var self This's singleton object of the current class. */
    protected static $_instance = NULL;

    /**
     * @ignore.
     */
    protected function __construct() {
        // Nothing here...
    }

    /**
     * It returns the context called singleton-instance. It implements late static
     * binding.
     * @return self.
     */
    public static function getInstance() {
        if (is_null(static::$_instance)) {
            static::$_instance = new static();
        }
        return static::$_instance;
    }

    /**
     * It sets the path to the main application config file referenced to its root.
     * @param string $sFilePath.
     * @return self.
     */
    public function setConfigFile($sFilePath) {
        $this->configFile = $sFilePath;
        return static::$_instance;
    }

    /**
     * {@inheritdoc}
     */
    public function run() {
        $this->init();
    }

    /**
     * {@inheritdoc}
     */
    public function init() {
        $this->_initHelper();
        $this->_initAutoload();
        $this->_initUserProcess();
        $this->handleRequest();
        $this->_stopUserProcess();
    }

    /**
     * {@inheritdoc}
     */
    abstract public function handleRequest();

    /**
     * It inits the application helper.
     * @return void.
     */
    private function _initHelper() {
        if (!$this->isConfigFileSet()) {
            throw new Exception("Main config file isn't define.");
        }
        AppHelper::getInstance()
                ->setAppRoot(Autoloader::getInstance()->getAppRoot())
                ->setConfigFile($this->getConfigFile())
                ->run();
    }

    /**
     * It inits class autoloading. The Autoloader object gets all directory roots 
     * from the Application Helper, after that it assignes them with autoloading 
     * process. 
     * @return void.
     */
    private function _initAutoload() {
        $mRoot = AppHelper::getInstance()->getConfig('autoloadingRootSet');
        foreach ($mRoot ?
                : array() as $sRoot) {
            Autoloader::getInstance()->add($sRoot);
        }
        Autoloader::getInstance()->run();
    }

    /**
     * The method runs custom processes.
     * @return void.
     */
    private function _initUserProcess() {
        \extensions\core\Process::getInstance()->run();
    }

    /**
     * The method kills user's processes.
     * @return void.
     */
    private function _stopUserProcess() {
        \extensions\core\Process::getInstance()->stop();
    }

}
{'fraction_non_alphanumeric': 0.1251855517070757, 'fraction_numerical': 0.0, 'mean_word_length': 2.211864406779661, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 39, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6580867', 'n_tokens_mistral': 1776, 'n_tokens_neox': 1806, 'n_words': 421}