Completed
Push — master ( 688c46...b38950 )
by Tim
8s
created

RawResult   A

Complexity

Total Complexity 9

Size/Duplication

Total Lines 46
Duplicated Lines 0 %

Coupling/Cohesion

Components 0
Dependencies 2

Test Coverage

Coverage 94.44%

Importance

Changes 0
Metric Value
wmc 9
lcom 0
cbo 2
dl 0
loc 46
ccs 17
cts 18
cp 0.9444
rs 10
c 0
b 0
f 0

1 Method

Rating   Name   Duplication   Size   Complexity  
D process() 0 34 9
1
<?php
2
3
/**
4
 * AppserverIo\Routlt\Results\RawResult
5
 *
6
 * NOTICE OF LICENSE
7
 *
8
 * This source file is subject to the Open Software License (OSL 3.0)
9
 * that is available through the world-wide-web at this URL:
10
 * http://opensource.org/licenses/osl-3.0.php
11
 *
12
 * PHP version 5
13
 *
14
 * @author     Tim Wagner <[email protected]>
15
 * @copyright  2015 TechDivision GmbH <[email protected]>
16
 * @license    http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)
17
 * @link       http://github.com/appserver-io/routlt
18
 * @link       http://www.appserver.io
19
 */
20
21
namespace AppserverIo\Routlt\Results;
22
23
use AppserverIo\Routlt\Util\EncodingAware;
24
use AppserverIo\Routlt\Util\ValidationAware;
25
use AppserverIo\Routlt\Util\DefaultHeadersAware;
26
use AppserverIo\Psr\Servlet\ServletRequestInterface;
27
use AppserverIo\Psr\Servlet\ServletResponseInterface;
28
29
/**
30
 * Result implementation that supports action based default headers and encoding.
31
 *
32
 * @author     Tim Wagner <[email protected]>
33
 * @copyright  2015 TechDivision GmbH <[email protected]>
34
 * @license    http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)
35
 * @link       http://github.com/appserver-io/routlt
36
 * @link       http://www.appserver.io
37
 *
38
 * @Result(shared=false)
39
 */
40
class RawResult extends AbstractResult
41
{
42
43
    /**
44
     * Processes an action result by dispatching the configured servlet.
45
     *
46
     * @param \AppserverIo\Psr\Servlet\ServletRequestInterface  $servletRequest  The request instance
47
     * @param \AppserverIo\Psr\Servlet\ServletResponseInterface $servletResponse The response sent back to the client
48
     *
49
     * @return void
50
     */
51 3
    public function process(ServletRequestInterface $servletRequest, ServletResponseInterface $servletResponse)
52
    {
53
54
        // load the action instance
55 3
        $action = $this->getAction();
56
57
        // add the actions default headers to the response
58 3
        if ($action instanceof DefaultHeadersAware && $action->hasDefaultHeaders()) {
59 3
            foreach ($action->getDefaultHeaders() as $name => $value) {
60
                // query whether or not a header with the given name has already been set
61 3
                if ($servletResponse->hasHeader($name)) {
0 ignored issues
show
Bug introduced by
It seems like you code against a concrete implementation and not the interface AppserverIo\Psr\Servlet\ServletResponseInterface as the method hasHeader() does only exist in the following implementations of said interface: AppserverIo\Psr\Servlet\...pServletResponseWrapper.

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

  1. Change the type-hint for the parameter:

    class AuthSystem
    {
        public function authenticate(MyUser $user) { /* ... */ }
    }
    
  2. 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.
  1. Add the method to the interface:

    interface User
    {
        /** @return string */
        public function getPassword();
    
        /** @return string */
        public function getDisplayName();
    }
    
Loading history...
62
                    continue;
63
                }
64
65
                // if not, set the default header
66 3
                $servletResponse->addHeader($name, $value);
0 ignored issues
show
Bug introduced by
It seems like you code against a concrete implementation and not the interface AppserverIo\Psr\Servlet\ServletResponseInterface as the method addHeader() does only exist in the following implementations of said interface: AppserverIo\Psr\Servlet\...pServletResponseWrapper.

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

  1. Change the type-hint for the parameter:

    class AuthSystem
    {
        public function authenticate(MyUser $user) { /* ... */ }
    }
    
  2. 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.
  1. Add the method to the interface:

    interface User
    {
        /** @return string */
        public function getPassword();
    
        /** @return string */
        public function getDisplayName();
    }
    
Loading history...
67 3
            }
68 3
        }
69
70
        // query whether the action contains errors or not
71 3
        if ($action instanceof ValidationAware && $action->hasErrors()) {
72 1
            $bodyContent = $action->getErrors();
73 1
        } else {
74 2
            $bodyContent = $action->getAttribute($this->getResult());
75
        }
76
77
        // query whether the action requires content encoding or not
78 3
        if ($action instanceof EncodingAware && !empty($bodyContent)) {
79 2
            $bodyContent = $action->encode($bodyContent);
80 2
        }
81
82
        // set the encoded body content
83 3
        $servletResponse->appendBodyStream($bodyContent);
84 3
    }
85
}
86