Passed
Push — main ( f9f23c...f7616c )
by Aimeos
05:03
created

Standard::getItem()   A

Complexity

Conditions 2
Paths 2

Size

Total Lines 14
Code Lines 7

Duplication

Lines 0
Ratio 0 %

Importance

Changes 1
Bugs 0 Features 0
Metric Value
cc 2
eloc 7
c 1
b 0
f 0
nc 2
nop 3
dl 0
loc 14
rs 10
1
<?php
2
3
/**
4
 * @license LGPLv3, http://opensource.org/licenses/LGPL-3.0
5
 * @copyright Aimeos (aimeos.org), 2021
6
 * @package Client
7
 * @subpackage JsonApi
8
 */
9
10
11
namespace Aimeos\Client\JsonApi\Cms;
12
13
use Psr\Http\Message\ResponseInterface;
14
use Psr\Http\Message\ServerRequestInterface;
15
16
17
/**
18
 * JSON API standard client
19
 *
20
 * @package Client
21
 * @subpackage JsonApi
22
 */
23
class Standard
24
	extends \Aimeos\Client\JsonApi\Base
25
	implements \Aimeos\Client\JsonApi\Iface
26
{
27
	/**
28
	 * Returns the resource or the resource list
29
	 *
30
	 * @param \Psr\Http\Message\ServerRequestInterface $request Request object
31
	 * @param \Psr\Http\Message\ResponseInterface $response Response object
32
	 * @return \Psr\Http\Message\ResponseInterface Modified response object
33
	 */
34
	public function get( ServerRequestInterface $request, ResponseInterface $response ) : \Psr\Http\Message\ResponseInterface
35
	{
36
		$view = $this->getView();
37
38
		try
39
		{
40
			if( $view->param( 'id' ) != '' ) {
41
				$response = $this->getItem( $view, $request, $response );
42
			} else {
43
				$response = $this->getItems( $view, $request, $response );
44
			}
45
46
			$status = 200;
47
		}
48
		catch( \Aimeos\MShop\Exception $e )
49
		{
50
			$status = 404;
51
			$view->errors = $this->getErrorDetails( $e, 'mshop' );
52
		}
53
		catch( \Exception $e )
54
		{
55
			$status = $e->getCode() >= 100 && $e->getCode() < 600 ? $e->getCode() : 500;
56
			$view->errors = $this->getErrorDetails( $e );
57
		}
58
59
		/** client/jsonapi/cms/template
60
		 * Relative path to the cms lists JSON API template
61
		 *
62
		 * The template file contains the code and processing instructions
63
		 * to generate the result shown in the JSON API body. The
64
		 * configuration string is the path to the template file relative
65
		 * to the templates directory (usually in client/jsonapi/templates).
66
		 *
67
		 * You can overwrite the template file configuration in extensions and
68
		 * provide alternative templates. These alternative templates should be
69
		 * named like the default one but with the string "standard" replaced by
70
		 * an unique name. You may use the name of your project for this. If
71
		 * you've implemented an alternative client class as well, "standard"
72
		 * should be replaced by the name of the new class.
73
		 *
74
		 * @param string Relative path to the template creating the body for the GET method of the JSON API
75
		 * @since 2021.04
76
		 * @category Developer
77
		 */
78
		$tplconf = 'client/jsonapi/cms/template';
79
		$default = 'cms/standard';
80
81
		$body = $view->render( $view->config( $tplconf, $default ) );
82
83
		return $response->withHeader( 'Allow', 'GET,OPTIONS' )
84
			->withHeader( 'Cache-Control', 'max-age=300' )
85
			->withHeader( 'Content-Type', 'application/vnd.api+json' )
86
			->withBody( $view->response()->createStreamFromString( $body ) )
87
			->withStatus( $status );
88
	}
89
90
91
	/**
92
	 * Returns the available REST verbs and the available parameters
93
	 *
94
	 * @param \Psr\Http\Message\ServerRequestInterface $request Request object
95
	 * @param \Psr\Http\Message\ResponseInterface $response Response object
96
	 * @return \Psr\Http\Message\ResponseInterface Modified response object
97
	 */
98
	public function options( ServerRequestInterface $request, ResponseInterface $response ) : \Psr\Http\Message\ResponseInterface
99
	{
100
		return $this->getOptionsResponse( $request, $response, 'GET,OPTIONS' );
101
	}
102
103
104
	/**
105
	 * Retrieves the item and adds the data to the view
106
	 *
107
	 * @param \Aimeos\MW\View\Iface $view View instance
108
	 * @param \Psr\Http\Message\ServerRequestInterface $request Request object
109
	 * @param \Psr\Http\Message\ResponseInterface $response Response object
110
	 * @return \Psr\Http\Message\ResponseInterface Modified response object
111
	 */
112
	protected function getItem( \Aimeos\MW\View\Iface $view, ServerRequestInterface $request, ResponseInterface $response ) : \Psr\Http\Message\ResponseInterface
0 ignored issues
show
Unused Code introduced by
The parameter $request is not used and could be removed. ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-unused  annotation

112
	protected function getItem( \Aimeos\MW\View\Iface $view, /** @scrutinizer ignore-unused */ ServerRequestInterface $request, ResponseInterface $response ) : \Psr\Http\Message\ResponseInterface

This check looks for parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
113
	{
114
		$ref = $view->param( 'include', [] );
115
116
		if( is_string( $ref ) ) {
117
			$ref = explode( ',', $ref );
118
		}
119
120
		$cntl = \Aimeos\Controller\Frontend::create( $this->getContext(), 'cms' );
121
122
		$view->items = $cntl->uses( $ref )->get( $view->param( 'id' ) );
0 ignored issues
show
Bug introduced by
The method uses() does not exist on Aimeos\Controller\Frontend\Iface. It seems like you code against a sub-type of said class. However, the method does not exist in Aimeos\Controller\Frontend\Common\Iface or Aimeos\Controller\Frontend\Common\Decorator\Iface or Aimeos\Controller\Fronte...ommon\Decorator\Example. Are you sure you never get one of those? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

122
		$view->items = $cntl->/** @scrutinizer ignore-call */ uses( $ref )->get( $view->param( 'id' ) );
Loading history...
123
		$view->total = 1;
124
125
		return $response;
126
	}
127
128
129
	/**
130
	 * Retrieves the items and adds the data to the view
131
	 *
132
	 * @param \Aimeos\MW\View\Iface $view View instance
133
	 * @param \Psr\Http\Message\ServerRequestInterface $request Request object
134
	 * @param \Psr\Http\Message\ResponseInterface $response Response object
135
	 * @return \Psr\Http\Message\ResponseInterface Modified response object
136
	 */
137
	protected function getItems( \Aimeos\MW\View\Iface $view, ServerRequestInterface $request, ResponseInterface $response ) : \Psr\Http\Message\ResponseInterface
0 ignored issues
show
Unused Code introduced by
The parameter $request is not used and could be removed. ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-unused  annotation

137
	protected function getItems( \Aimeos\MW\View\Iface $view, /** @scrutinizer ignore-unused */ ServerRequestInterface $request, ResponseInterface $response ) : \Psr\Http\Message\ResponseInterface

This check looks for parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
138
	{
139
		$total = 0;
140
		$ref = $view->param( 'include', [] );
141
142
		if( is_string( $ref ) ) {
143
			$ref = explode( ',', $ref );
144
		}
145
146
		$cmss = \Aimeos\Controller\Frontend::create( $this->getContext(), 'cms' )
147
			->slice( $view->param( 'page/offset', 0 ), $view->param( 'page/limit', 25 ) )
0 ignored issues
show
Bug introduced by
The method slice() does not exist on Aimeos\Controller\Frontend\Iface. It seems like you code against a sub-type of said class. However, the method does not exist in Aimeos\Controller\Frontend\Common\Iface or Aimeos\Controller\Frontend\Common\Decorator\Iface or Aimeos\Controller\Fronte...ommon\Decorator\Example. Are you sure you never get one of those? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

147
			->/** @scrutinizer ignore-call */ slice( $view->param( 'page/offset', 0 ), $view->param( 'page/limit', 25 ) )
Loading history...
148
			->sort( $view->param( 'sort' ) )->parse( $view->param( 'filter', [] ) )
149
			->uses( $ref )->search( $total );
150
151
		$view->items = $cmss;
152
		$view->total = $total;
153
154
		return $response;
155
	}
156
}
157