JoinBuilder - Code Metrics - Inspection of "Add many2many tests" - rambler-digital-solutions/hydrogen - Measure and Improve Code Quality continuously with Scrutinizer

Test Failed

Push — master ( 1845c4...b386f4 )

by Kirill

created 2018-09-06 10:12 UTC

JoinBuilder A

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	137
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	6

Test Coverage

Coverage

76.47%

Importance

Changes

Metric	Value
wmc	16
lcom	1
cbo	6
dl	0
loc	137
ccs	39
cts	51
cp	0.7647
rs	10
c	0
b	0
f	0

7 Methods

Rating	Name	Size	Complexity
A	apply()	14	2
A	joinAll()	29	5
A	join()	16	4
A	getKey()	4	1
A	hasAlias()	6	1
A	getCachedAlias()	14	2
A	getAlias()	7	1

<?php
/**
 * This file is part of Hydrogen package.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
declare(strict_types=1);

namespace RDS\Hydrogen\Processor\DatabaseProcessor;

use Doctrine\ORM\Mapping\ClassMetadata;
use Doctrine\ORM\QueryBuilder;
use RDS\Hydrogen\Criteria\Common\Field;
use RDS\Hydrogen\Criteria\CriterionInterface;
use RDS\Hydrogen\Criteria\Join;

/**
 * Class JoinBuilder
 */
class JoinBuilder extends WhereBuilder
{
    /**
     * @var array
     */
    private $relations = [];

    /**
     * @param QueryBuilder $builder
     * @param CriterionInterface|Join $join
     * @return iterable|null
     */
    public function apply($builder, CriterionInterface $join): ?iterable
    {
        [$entity, $alias] = $this->joinAll($builder, $join);


        if ($join->hasJoinQuery()) {
interface User
{
    /** @return string */
    public function getPassword();
}

class MyUser implements User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}
            $repository = $this->processor->getProcessor($entity)->getRepository();

            $query = $this->query->create()
                ->from($repository)
                ->withAlias($alias);

            yield $join->getJoinQuery($query);
interface User
{
    /** @return string */
    public function getPassword();
}

class MyUser implements User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}
        }
    }

    /**
     * @param QueryBuilder $builder
     * @param Join $join
     * @return array
     */
    private function joinAll(QueryBuilder $builder, Join $join): array
    {
        [$alias, $relation] = [$join->getQueryAlias(), []];
function someFunction() {
    $x = 5;
    echo $x;
}

        foreach ($join->getRelations($this->processor) as $isLast => $relation) {

            // Is the relation already loaded in current query execution
            $exists = $this->hasAlias($relation);

            // Resolve relation alias
            $relationAlias = $isLast && $join->hasJoinQuery()
                ? $this->getAlias($relation)
                : $this->getCachedAlias($relation);

            if (! $exists) {
                // Create join
                $relationField = Field::new($relation['fieldName'])->toString($alias);
function myFunction($a) {
    switch ($a) {
        case 'foo':
            $x = 1;
            break;

        case 'bar':
            $x = 2;
            break;
    }

    // $x is potentially undefined here.
    echo $x;
}
                $this->join($builder, $join, $relationField, $relationAlias);

                // Add join to selection statement
                $builder->addSelect($relationAlias);
            }

            // Shift parent
            $alias = $relationAlias;
        }

        return [$relation['targetEntity'], $alias];
foreach ($a as $b) {
}

// $b is defined here only if $a has elements, for example if $a is array()
// then $b would not be defined here. To avoid that, we recommend to set a
// default value for $b.


// Better
$b = 0; // or whatever default makes sense in your context
foreach ($a as $b) {
}

// $b is now guaranteed to be defined here.
    }

    /**
     * @param QueryBuilder $builder
     * @param Join $join
     * @param string $field
     * @param string $relationAlias
     * @return void
     */
    private function join(QueryBuilder $builder, Join $join, string $field, string $relationAlias): void
    {
        switch ($join->getType()) {
            case Join::TYPE_JOIN:
                $builder->join($field, $relationAlias);
                break;

            case Join::TYPE_INNER_JOIN:
                $builder->innerJoin($field, $relationAlias);
                break;

            case Join::TYPE_LEFT_JOIN:
                $builder->leftJoin($field, $relationAlias);
                break;
        }
    }

    /**
     * @param array $relation
     * @return string
     */
    private function getKey(array $relation): string
    {
        return $relation['sourceEntity'] . '_' . $relation['targetEntity'];
    }

    /**
     * @param array $relation
     * @return bool
     */
    private function hasAlias(array $relation): bool
    {
        $key = $this->getKey($relation);

        return isset($this->relations[$key]);
    }

    /**
     * @param array $relation
     * @return string
     */
    private function getCachedAlias(array $relation): string
    {
        $key = $this->getKey($relation);

        if (! isset($this->relations[$key])) {
            return $this->relations[$key] =
                $this->query->createAlias(
                    $relation['sourceEntity'],
                    $relation['targetEntity']
                );
        }

        return $this->relations[$key];
    }

    /**
     * @param array $relation
     * @return string
     */
    private function getAlias(array $relation): string
    {
        return $this->query->createAlias(
            $relation['sourceEntity'],
            $relation['targetEntity']
        );
    }
}


1		<?php
2		/**
3		* This file is part of Hydrogen package.
4		*
5		* For the full copyright and license information, please view the LICENSE
6		* file that was distributed with this source code.
7		*/
8		declare(strict_types=1);
9
10		namespace RDS\Hydrogen\Processor\DatabaseProcessor;
11
12		use Doctrine\ORM\Mapping\ClassMetadata;
13		use Doctrine\ORM\QueryBuilder;
14		use RDS\Hydrogen\Criteria\Common\Field;
15		use RDS\Hydrogen\Criteria\CriterionInterface;
16		use RDS\Hydrogen\Criteria\Join;
17
18		/**
19		* Class JoinBuilder
20		*/
21		class JoinBuilder extends WhereBuilder
22		{
23		/**
24		* @var array
25		*/
26		private $relations = [];
27
28		/**
29		* @param QueryBuilder $builder
30		* @param CriterionInterface\|Join $join
31		* @return iterable\|null
32		*/
33	2	public function apply($builder, CriterionInterface $join): ?iterable
34		{
35	2	[$entity, $alias] = $this->joinAll($builder, $join);
		0 ignored issues – show Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report The variable `$entity` does not exist. Did you forget to declare it? This check marks access to variables or properties that have not been declared yet. While PHP has no explicit notion of declaring a variable, accessing it before a value is assigned to it is most likely a bug. Loading history... Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report The variable `$alias` does not exist. Did you forget to declare it? This check marks access to variables or properties that have not been declared yet. While PHP has no explicit notion of declaring a variable, accessing it before a value is assigned to it is most likely a bug. Loading history... Compatibility introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report `$join` of type `object<RDS\Hydrogen\Criteria\CriterionInterface>` is not a sub-type of `object<RDS\Hydrogen\Criteria\Join>`. It seems like you assume a concrete implementation of the interface `RDS\Hydrogen\Criteria\CriterionInterface` to be always present. This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass. Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type. Loading history...
36
37	2	if ($join->hasJoinQuery()) {
		0 ignored issues – show Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report It seems like you code against a concrete implementation and not the interface `RDS\Hydrogen\Criteria\CriterionInterface` as the method `hasJoinQuery()` does only exist in the following implementations of said interface: `RDS\Hydrogen\Criteria\Join`. Let’s take a look at an example: interface User { /** @return string / public function getPassword(); } class MyUser implements User { public function getPassword() { // return something } public function getDisplayName() { // return some name. } } class AuthSystem { public function authenticate(User $user) { $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName())); // do something. } } In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different implementation of User which does not have a getDisplayName() method, the code will break. Available Fixes Change the type-hint for the parameter: class AuthSystem { public function authenticate(MyUser $user) { / ... / } } Add an additional type-check: class AuthSystem { public function authenticate(User $user) { if ($user instanceof MyUser) { $this->logger->info(/* ... /); } // or alternatively if ( ! $user instanceof MyUser) { throw new \LogicException( '$user must be an instance of MyUser, ' .'other instances are not supported.' ); } } } Note:* PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case. Add the method to the interface: interface User { /** @return string / public function getPassword(); /* @return string */ public function getDisplayName(); } Loading history...
38		$repository = $this->processor->getProcessor($entity)->getRepository();
39
40		$query = $this->query->create()
41		->from($repository)
42		->withAlias($alias);
43
44		yield $join->getJoinQuery($query);
		0 ignored issues – show Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report It seems like you code against a concrete implementation and not the interface `RDS\Hydrogen\Criteria\CriterionInterface` as the method `getJoinQuery()` does only exist in the following implementations of said interface: `RDS\Hydrogen\Criteria\Join`. Let’s take a look at an example: interface User { /** @return string / public function getPassword(); } class MyUser implements User { public function getPassword() { // return something } public function getDisplayName() { // return some name. } } class AuthSystem { public function authenticate(User $user) { $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName())); // do something. } } In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different implementation of User which does not have a getDisplayName() method, the code will break. Available Fixes Change the type-hint for the parameter: class AuthSystem { public function authenticate(MyUser $user) { / ... / } } Add an additional type-check: class AuthSystem { public function authenticate(User $user) { if ($user instanceof MyUser) { $this->logger->info(/* ... /); } // or alternatively if ( ! $user instanceof MyUser) { throw new \LogicException( '$user must be an instance of MyUser, ' .'other instances are not supported.' ); } } } Note:* PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case. Add the method to the interface: interface User { /** @return string / public function getPassword(); /* @return string */ public function getDisplayName(); } Loading history...
45		}
46	2	}
47
48		/**
49		* @param QueryBuilder $builder
50		* @param Join $join
51		* @return array
52		*/
53	2	private function joinAll(QueryBuilder $builder, Join $join): array
54		{
55	2	[$alias, $relation] = [$join->getQueryAlias(), []];
		0 ignored issues – show Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report The variable `$alias` seems only to be defined at a later point. Did you maybe move this code here without moving the variable definition? This error can happen if you refactor code and forget to move the variable initialization. Let’s take a look at a simple example: function someFunction() { $x = 5; echo $x; } The above code is perfectly fine. Now imagine that we re-order the statements: function someFunction() { echo $x; $x = 5; } In that case, `$x` would be read before it is initialized. This was a very basic example, however the principle is the same for the found issue. Loading history... Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report The variable `$relation` seems only to be defined at a later point. Did you maybe move this code here without moving the variable definition? This error can happen if you refactor code and forget to move the variable initialization. Let’s take a look at a simple example: function someFunction() { $x = 5; echo $x; } The above code is perfectly fine. Now imagine that we re-order the statements: function someFunction() { echo $x; $x = 5; } In that case, `$x` would be read before it is initialized. This was a very basic example, however the principle is the same for the found issue. Loading history...
56
57	2	foreach ($join->getRelations($this->processor) as $isLast => $relation) {
58
59		// Is the relation already loaded in current query execution
60	2	$exists = $this->hasAlias($relation);
61
62		// Resolve relation alias
63	2	$relationAlias = $isLast && $join->hasJoinQuery()
64		? $this->getAlias($relation)
65	2	: $this->getCachedAlias($relation);
66
67	2	if (! $exists) {
68		// Create join
69	2	$relationField = Field::new($relation['fieldName'])->toString($alias);
		0 ignored issues – show Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report The variable `$alias` does not seem to be defined for all execution paths leading up to this point. If you define a variable conditionally, it can happen that it is not defined for all execution paths. Let’s take a look at an example: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } // $x is potentially undefined here. echo $x; } In the above example, the variable `$x` is defined if you pass “foo” or “bar” as argument for `$a`. However, since the `switch` statement has no default case statement, if you pass any other value, the variable `$x` would be undefined. Available Fixes Check for existence of the variable explicitly: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } if (isset($x)) { // Make sure it's always set. echo $x; } } Define a default value for the variable: function myFunction($a) { $x = ''; // Set a default which gets overridden for certain paths. switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } echo $x; } Add a value for the missing path: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; // We add support for the missing case. default: $x = ''; break; } echo $x; } Loading history...
70	2	$this->join($builder, $join, $relationField, $relationAlias);
71
72		// Add join to selection statement
73	2	$builder->addSelect($relationAlias);
74		}
75
76		// Shift parent
77	2	$alias = $relationAlias;
78		}
79
80	2	return [$relation['targetEntity'], $alias];
		0 ignored issues – show Bug introduced 2018-09-05 02:06 UTC by Report Bug Copy Issue Report The variable `$relation` seems to be defined by a `foreach` iteration on line `57`. Are you sure the iterator is never empty, otherwise this variable is not defined? It seems like you are relying on a variable being defined by an iteration: foreach ($a as $b) { } // $b is defined here only if $a has elements, for example if $a is array() // then $b would not be defined here. To avoid that, we recommend to set a // default value for $b. // Better $b = 0; // or whatever default makes sense in your context foreach ($a as $b) { } // $b is now guaranteed to be defined here. Loading history...
81		}
82
83		/**
84		* @param QueryBuilder $builder
85		* @param Join $join
86		* @param string $field
87		* @param string $relationAlias
88		* @return void
89		*/
90	2	private function join(QueryBuilder $builder, Join $join, string $field, string $relationAlias): void
91		{
92	2	switch ($join->getType()) {
93	2	case Join::TYPE_JOIN:
94	1	$builder->join($field, $relationAlias);
95	1	break;
96
97	1	case Join::TYPE_INNER_JOIN:
98		$builder->innerJoin($field, $relationAlias);
99		break;
100
101	1	case Join::TYPE_LEFT_JOIN:
102	1	$builder->leftJoin($field, $relationAlias);
103	1	break;
104		}
105	2	}
106
107		/**
108		* @param array $relation
109		* @return string
110		*/
111	2	private function getKey(array $relation): string
112		{
113	2	return $relation['sourceEntity'] . '_' . $relation['targetEntity'];
114		}
115
116		/**
117		* @param array $relation
118		* @return bool
119		*/
120	2	private function hasAlias(array $relation): bool
121		{
122	2	$key = $this->getKey($relation);
123
124	2	return isset($this->relations[$key]);
125		}
126
127		/**
128		* @param array $relation
129		* @return string
130		*/
131	2	private function getCachedAlias(array $relation): string
132		{
133	2	$key = $this->getKey($relation);
134
135	2	if (! isset($this->relations[$key])) {
136	2	return $this->relations[$key] =
137	2	$this->query->createAlias(
138	2	$relation['sourceEntity'],
139	2	$relation['targetEntity']
140		);
141		}
142
143	1	return $this->relations[$key];
144		}
145
146		/**
147		* @param array $relation
148		* @return string
149		*/
150		private function getAlias(array $relation): string
151		{
152		return $this->query->createAlias(
153		$relation['sourceEntity'],
154		$relation['targetEntity']
155		);
156		}
157		}
158

rambler-digital-solutions / hydrogen

Push — master ( 1845c4...b386f4 )

JoinBuilder A

Complexity

Size/Duplication

Coupling/Cohesion

Test Coverage

Importance

7 Methods

Available Fixes

Available Fixes

Available Fixes

Duplication Side-by-Side

Filter issues like