eZ\Publish\Core\Persistence\Legacy\Content\Language\MaskGenerator

Complexity

Total Complexity

28

Size/Duplication

Total Lines	217
Duplicated Lines	7.37 %

Coupling/Cohesion

Components	1
Dependencies	2

Importance

Changes

0

12 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	4	1
A	generateLanguageMask()	0	4	1
B	generateLanguageMaskFromLanguageMap()	0	20	6
A	generateLanguageMaskFromLanguageCodes()	0	13	4
A	generateLanguageMaskFromLanguageIds()	0	11	3
A	generateLanguageIndicator()	0	4	2
A	isLanguageAlwaysAvailable()	0	6	2
A	isAlwaysAvailable()	0	4	1
A	removeAlwaysAvailableFlag()	0	4	1
A	extractLanguageIdsFromMask()	16	16	3
A	extractLanguageCodesFromMask()	0	10	2
A	isLanguageMaskComposite()	0	13	2

<?php

/**
 * File containing the Language MaskGenerator class.
 *
 * @copyright Copyright (C) eZ Systems AS. All rights reserved.
 * @license For full copyright and license information view LICENSE file distributed with this source code.
 */
namespace eZ\Publish\Core\Persistence\Legacy\Content\Language;

use eZ\Publish\API\Repository\Exceptions\NotFoundException;
use eZ\Publish\SPI\Persistence\Content\Language\Handler as LanguageHandler;
use RuntimeException;

/**
 * Language MaskGenerator.
 */
class MaskGenerator
{
    /**
     * Language lookup.
     *
     * @var \eZ\Publish\Core\Persistence\Legacy\Content\Language\Handler
     */
    protected $languageHandler;

    /**
     * Creates a new Language MaskGenerator.
     *
     * @param \eZ\Publish\SPI\Persistence\Content\Language\Handler $languageHandler
     */
    public function __construct(LanguageHandler $languageHandler)
    {
        $this->languageHandler = $languageHandler;

$languageHandler is of type object<eZ\Publish\SPI\Persistence\Content\Language\Handler>, but the property $languageHandler was declared to be of type object<eZ\Publish\Core\Persistence\Legacy\Content\Language\Handler>. Are you sure that you always receive this specific sub-class here, or does it make sense to add an instanceof check?

    }

    /**
     * @deprecated Move towards using {@see generateLanguageMaskFromLanguageMap()}
     */
    public function generateLanguageMask(array $languageMap)
    {
        return $this->generateLanguageMaskFromLanguageMap($languageMap);
    }

    /**
     * Generates a language mask from the keys of $languages.
     *
     * Typically used for ->name values to get language mask directly from such structure.
     *
     * @param array $languageMap Key values are language code, value is ignored.
     *                           Exception is 'always-available' key, if set and true, always available flag is added.
     *
     * @throws \RuntimeException If non allowed values are provided as keys.
     *
     * @return int
     */
    public function generateLanguageMaskFromLanguageMap(array $languageMap): int
    {
        $mask = 0;
        if (isset($languageMap['always-available'])) {
            $mask |= $languageMap['always-available'] ? 1 : 0;
            unset($languageMap['always-available']);
        }

        foreach ($languageMap as $languageCode => $value) {
            try {
                $mask |= $this->languageHandler->loadByLanguageCode($languageCode)->id;
            } catch (NotFoundException $e) {
                if (\is_int($languageCode)) {
                    throw new RuntimeException("Keys expected as language codes, got: $languageCode", 0, $e);
                }
            }
        }

        return $mask;
    }

    /**
     * Generates a language mask for $translations argument.
     *
     * @param string[] $languageCodes Array of Language codes.
     * @param bool $useAlwaysAvailable
     *
     * @return int
     */
    public function generateLanguageMaskFromLanguageCodes(array $languageCodes, bool $useAlwaysAvailable): int
    {
        $mask = 0;
        $mask |= $useAlwaysAvailable ? 1 : 0;

        foreach ($languageCodes as $languageCode) {
            try {
                $mask |= $this->languageHandler->loadByLanguageCode($languageCode)->id;
            } catch (NotFoundException $e) {}

Consider adding a comment why this CATCH block is empty.

        }

        return $mask;
    }

    /**
     * Generates a language mask from pre-loaded Language Ids.
     *
     * @param int[] $languageIds
     * @param bool $alwaysAvailable
     *
     * @return int
     */
    public function generateLanguageMaskFromLanguageIds(array $languageIds, $alwaysAvailable): int
    {
        // make sure alwaysAvailable part of bit mask always results in 1 or 0
        $languageMask = $alwaysAvailable ? 1 : 0;

        foreach ($languageIds as $languageId) {
            $languageMask |= $languageId;
        }

        return $languageMask;
    }

    /**
     * Generates a language indicator from $languageCode and $alwaysAvailable.
     *
     * @param string $languageCode
     * @param bool $alwaysAvailable
     *
     * @return int
     */
    public function generateLanguageIndicator($languageCode, $alwaysAvailable)
    {
        return $this->languageHandler->loadByLanguageCode($languageCode)->id | ($alwaysAvailable ? 1 : 0);
    }

    /**
     * Checks if $language is always available in $languages;.
     *
     * @param string $language
     * @param array $languages
     *
     * @return bool
     */
    public function isLanguageAlwaysAvailable($language, array $languages)
    {
        return isset($languages['always-available'])
           && ($languages['always-available'] == $language)
        ;
    }

    /**
     * Checks if $languageMask contains the alwaysAvailable bit field.
     *
     * @param int $languageMask
     *
     * @return bool
     */
    public function isAlwaysAvailable($languageMask)
    {
        return (bool)($languageMask & 1);
    }

    /**
     * Removes the alwaysAvailable flag from $languageId and returns cleaned up $languageId.
     *
     * @param int $languageId
     *
     * @return int
     */
    public function removeAlwaysAvailableFlag($languageId)
    {
        return $languageId & ~1;
    }

    /**
     * Extracts every language Ids contained in $languageMask.
     *
     * @param int $languageMask
     *
     * @return array Array of language Id
     */
    public function extractLanguageIdsFromMask($languageMask)
    {
        $exp = 2;
        $result = array();

        // Decomposition of $languageMask into its binary components.
        while ($exp <= $languageMask) {
            if ($languageMask & $exp) {
                $result[] = $exp;
            }

            $exp *= 2;
        }

        return $result;
    }

    /**
     * Extracts Language codes contained in given $languageMask.
     *
     * @param int $languageMask
     *
     * @return array
     */
    public function extractLanguageCodesFromMask($languageMask)
    {
        $languageCodes = array();

        foreach ($this->extractLanguageIdsFromMask($languageMask) as $languageId) {
            $languageCodes[] = $this->languageHandler->load($languageId)->languageCode;
        }

        return $languageCodes;
    }

    /**
     * Checks if given $languageMask consists of multiple languages.
     *
     * @param int $languageMask
     *
     * @return bool
     */
    public function isLanguageMaskComposite($languageMask)
    {
        // Ignore first bit
        $languageMask = $this->removeAlwaysAvailableFlag($languageMask);

        // Special case
        if ($languageMask === 0) {
            return false;
        }

        // Return false if power of 2
        return (bool)($languageMask & ($languageMask - 1));
    }
}