TestObjectHandler.php

Go to the documentation of this file.

<?php
namespace Magento\FunctionalTestingFramework\Test\Handlers;

use Magento\FunctionalTestingFramework\Exceptions\Collector\ExceptionCollector;
use Magento\FunctionalTestingFramework\Exceptions\TestReferenceException;
use Magento\FunctionalTestingFramework\Exceptions\XmlException;
use Magento\FunctionalTestingFramework\ObjectManager\ObjectHandlerInterface;
use Magento\FunctionalTestingFramework\ObjectManagerFactory;
use Magento\FunctionalTestingFramework\Test\Objects\TestObject;
use Magento\FunctionalTestingFramework\Test\Parsers\TestDataParser;
use Magento\FunctionalTestingFramework\Test\Util\ObjectExtensionUtil;
use Magento\FunctionalTestingFramework\Test\Util\TestObjectExtractor;
use Magento\FunctionalTestingFramework\Test\Util\AnnotationExtractor;

class TestObjectHandler implements ObjectHandlerInterface
{
    const XML_ROOT = 'tests';

    private static $testObjectHandler;

    private $tests = [];

    private $extendUtil;

    public static function getInstance()
    {
        if (!self::$testObjectHandler) {
            self::$testObjectHandler = new TestObjectHandler();
            self::$testObjectHandler->initTestData();
        }

        return self::$testObjectHandler;
    }

    private function __construct()
    {
        $this->extendUtil = new ObjectExtensionUtil();
    }

    public function getObject($testName)
    {
        if (!array_key_exists($testName, $this->tests)) {
            throw new TestReferenceException("Test ${testName} not defined in xml.");
        }
        $testObject = $this->tests[$testName];

        return $this->extendTest($testObject);
    }

    public function getAllObjects()
    {
        foreach ($this->tests as $testName => $test) {
            $this->tests[$testName] = $this->extendTest($test);
        }
        return $this->tests;
    }

    public function getTestsByGroup($groupName)
    {
        $relevantTests = [];
        foreach ($this->tests as $test) {
            if (in_array($groupName, $test->getAnnotationByName('group'))) {
                $relevantTests[$test->getName()] = $test;
                continue;
            }
        }

        return $relevantTests;
    }

    private function initTestData()
    {
        $testDataParser = ObjectManagerFactory::getObjectManager()->create(TestDataParser::class);
        $parsedTestArray = $testDataParser->readTestData();

        $testObjectExtractor = new TestObjectExtractor();

        if (!$parsedTestArray) {
            trigger_error("Could not parse any test in xml.", E_USER_NOTICE);
            return;
        }

        $exceptionCollector = new ExceptionCollector();
        foreach ($parsedTestArray[TestObjectHandler::XML_ROOT] as $testName => $testData) {
            if (!is_array($testData)) {
                continue;
            }
            try {
                $this->tests[$testName] = $testObjectExtractor->extractTestData($testData);
            } catch (XmlException $exception) {
                $exceptionCollector->addError(self::class, $exception->getMessage());
            }
        }
        $exceptionCollector->throwException();
        
        $testObjectExtractor->getAnnotationExtractor()->validateStoryTitleUniqueness();
        $testObjectExtractor->getAnnotationExtractor()->validateTestCaseIdTitleUniqueness();
    }

    private function extendTest($testObject)
    {
        if ($testObject->getParentName() !== null) {
            return $this->extendUtil->extendTest($testObject);
        }
        return $testObject;
    }
}