Completed
Push — feature/fga-amend-ra-info ( 0b39c9...7949e9 )
by
unknown
57:57 queued 54:55
created

RaListingSearchQuery::setInstitution()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 8

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
dl 0
loc 8
rs 10
c 0
b 0
f 0
cc 1
nc 1
nop 1
1
<?php
2
3
/**
4
 * Copyright 2014 SURFnet bv
5
 *
6
 * Licensed under the Apache License, Version 2.0 (the "License");
7
 * you may not use this file except in compliance with the License.
8
 * You may obtain a copy of the License at
9
 *
10
 *     http://www.apache.org/licenses/LICENSE-2.0
11
 *
12
 * Unless required by applicable law or agreed to in writing, software
13
 * distributed under the License is distributed on an "AS IS" BASIS,
14
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
 * See the License for the specific language governing permissions and
16
 * limitations under the License.
17
 */
18
19
namespace Surfnet\StepupMiddlewareClient\Identity\Dto;
20
21
use Assert;
22
use Surfnet\StepupMiddlewareClient\Dto\HttpQuery;
23
24
final class RaListingSearchQuery implements HttpQuery
25
{
26
    /**
27
     * @var string
28
     */
29
    private $actorInstitution;
30
31
    /**
32
     * @var int
33
     */
34
    private $pageNumber;
35
36
    /**
37
     * @var string|null
38
     */
39
    private $orderBy = 'commonName';
40
41
    /**
42
     * @var string|null
43
     */
44
    private $orderDirection = 'asc';
45
46
    /**
47
     * @param string $institution
0 ignored issues
show
Documentation introduced by
There is no parameter named $institution. Did you maybe mean $actorInstitution?

This check looks for PHPDoc comments describing methods or function parameters that do not exist on the corresponding method or function. It has, however, found a similar but not annotated parameter which might be a good fit.

Consider the following example. The parameter $ireland is not defined by the method finale(...).

/**
 * @param array $germany
 * @param array $ireland
 */
function finale($germany, $island) {
    return "2:1";
}

The most likely cause is that the parameter was changed, but the annotation was not.

Loading history...
48
     * @param int    $pageNumber
49
     */
50 View Code Duplication
    public function __construct($actorInstitution, $pageNumber)
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
51
    {
52
        $this->assertNonEmptyString($actorInstitution, 'actorInstitution');
53
        Assert\that($pageNumber)
54
            ->integer('Page number must be an integer')
55
            ->min(0, 'Page number must be greater than or equal to 1');
56
57
        $this->actorInstitution = $actorInstitution;
58
        $this->pageNumber  = $pageNumber;
59
    }
60
61
    /**
62
     * @param string $orderBy
63
     * @return RaListingSearchQuery
64
     */
65
    public function setOrderBy($orderBy)
66
    {
67
        $this->assertNonEmptyString($orderBy, 'orderBy');
68
69
        $this->orderBy = $orderBy;
70
71
        return $this;
72
    }
73
74
    /**
75
     * @param string|null $orderDirection
76
     * @return RaListingSearchQuery
77
     */
78 View Code Duplication
    public function setOrderDirection($orderDirection)
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
79
    {
80
        Assert\that($orderDirection)->choice(
81
            ['asc', 'desc', '', null],
82
            "Invalid order direction, must be one of 'asc', 'desc'"
83
        );
84
85
        $this->orderDirection = $orderDirection ?: null;
86
87
        return $this;
88
    }
89
90
    private function assertNonEmptyString($value, $parameterName)
91
    {
92
        $message = sprintf(
93
            '"%s" must be a non-empty string, "%s" given',
94
            $parameterName,
95
            (is_object($value) ? get_class($value) : gettype($value))
96
        );
97
98
        Assert\that($value)->string($message)->notEmpty($message);
99
    }
100
101
    public function toHttpQuery()
102
    {
103
        return '?' . http_build_query(
104
            array_filter(
105
                [
106
                    'actorInstitution' => $this->actorInstitution,
107
                    'orderBy'          => $this->orderBy,
108
                    'orderDirection'   => $this->orderDirection,
109
                    'p'                => $this->pageNumber,
110
                ],
111
                function ($value) {
112
                    return !is_null($value);
113
                }
114
            )
115
        );
116
    }
117
}
118