Base::getItem() - Code Metrics - Inspection of "Added missing saveItem() to interface of order con..." - aimeos/ai-controller-frontend - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 27d1e4...1acb66 )

by Aimeos

created 2017-12-01 11:53 UTC

Base::getItem() A

↳ Parent: Base

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	4
rs	10
c	0
b	0
f	0
cc	1
eloc	2
nc	1
nop	2

<?php

/**
 * @license LGPLv3, http://opensource.org/licenses/LGPL-3.0
 * @copyright Aimeos (aimeos.org), 2016-2017
 * @package Controller
 * @subpackage Frontend
 */


namespace Aimeos\Controller\Frontend\Order\Decorator;


/**
 * Base for order frontend controller decorators
 *
 * @package Controller
 * @subpackage Frontend
 */
abstract class Base
	extends \Aimeos\Controller\Frontend\Base
	implements \Aimeos\Controller\Frontend\Common\Decorator\Iface, \Aimeos\Controller\Frontend\Order\Iface
{
	private $controller;


	/**
	 * Initializes the controller decorator.
	 *
	 * @param \Aimeos\Controller\Frontend\Iface $controller Controller object
	 * @param \Aimeos\MShop\Context\Item\Iface $context Context object with required objects
	 */
	public function __construct( \Aimeos\Controller\Frontend\Iface $controller, \Aimeos\MShop\Context\Item\Iface $context )
	{
		$iface = '\Aimeos\Controller\Frontend\Order\Iface';
		if( !( $controller instanceof $iface ) )
		{
			$msg = sprintf( 'Class "%1$s" does not implement interface "%2$s"', get_class( $controller ), $iface );
			throw new \Aimeos\Controller\Frontend\Exception( $msg );
		}

		$this->controller = $controller;

		parent::__construct( $context );
	}


	/**
	 * Passes unknown methods to wrapped objects.
	 *
	 * @param string $name Name of the method
	 * @param array $param List of method parameter
	 * @return mixed Returns the value of the called method
	 * @throws \Aimeos\Controller\Frontend\Exception If method call failed
	 */
	public function __call( $name, array $param )
	{
		return @call_user_func_array( array( $this->controller, $name ), $param );
	}


	/**
	 * Creates and adds a new order for the given order base ID
	 *
	 * @param string $baseId Unique ID of the saved basket
	 * @param string $type Arbitrary order type (max. eight chars)
	 * @return \Aimeos\MShop\Order\Item\Iface Created order object
	 */
	public function addItem( $baseId, $type )
	{
		return $this->controller->addItem( $baseId, $type );
	}


	/**
	 * Returns the filter for searching items
	 *
	 * @return \Aimeos\MW\Criteria\Iface Filter object
	 */
	public function createFilter()
	{
		return $this->controller->createFilter();
	}


	/**
	 * Returns the order item for the given ID
	 *
	 * @param string $id Unique order ID
	 * @param boolean $default Use default criteria to limit orders
	 * @return \Aimeos\MShop\Order\Item\Iface Order object
	 */
	public function getItem( $id, $default = true )
	{
		return $this->controller->getItem( $id );
	}


	/**
	 * Saves the modified order item
	 *
	 * @param \Aimeos\MShop\Order\Item\Iface $item Order object
	 * @return \Aimeos\MShop\Order\Item\Iface Saved order item
	 */
	public function saveItem( \Aimeos\MShop\Order\Item\Iface $item )
	{
		return $this->controller->saveItem( $item );
	}


	/**
	 * Returns the order items based on the given filter that belong to the current user
	 *
	 * @param \Aimeos\MW\Criteria\Iface Filter object
	 * @param integer &$total|null Variable that will contain the total number of available items
	 * @return \Aimeos\MShop\Order\Item\Iface[] Associative list of IDs as keys and order objects as values
	 */
	public function searchItems( \Aimeos\MW\Criteria\Iface $filter, &$total = null )
	{
		return $this->controller->searchItems( $filter, $total );
	}


	/**
	 * Blocks the resources listed in the order.
	 *
	 * Every order contains resources like products or redeemed coupon codes
	 * that must be blocked so they can't be used by another customer in a
	 * later order. This method reduces the the stock level of products, the
	 * counts of coupon codes and others.
	 *
	 * It's save to call this method multiple times for one order. In this case,
	 * the actions will be executed only once. All subsequent calls will do
	 * nothing as long as the resources haven't been unblocked in the meantime.
	 *
	 * You can also block and unblock resources several times. Please keep in
	 * mind that unblocked resources may be reused by other orders in the
	 * meantime. This can lead to an oversell of products!
	 *
	 * @param \Aimeos\MShop\Order\Item\Iface $orderItem Order item object
	 * @return void
	 */
	public function block( \Aimeos\MShop\Order\Item\Iface $orderItem )
	{
		$this->getController()->block( $orderItem );
	}


	/**
	 * Frees the resources listed in the order.
	 *
	 * If customers created orders but didn't pay for them, the blocked resources
	 * like products and redeemed coupon codes must be unblocked so they can be
	 * ordered again or used by other customers. This method increased the stock
	 * level of products, the counts of coupon codes and others.
	 *
	 * It's save to call this method multiple times for one order. In this case,
	 * the actions will be executed only once. All subsequent calls will do
	 * nothing as long as the resources haven't been blocked in the meantime.
	 *
	 * You can also unblock and block resources several times. Please keep in
	 * mind that unblocked resources may be reused by other orders in the
	 * meantime. This can lead to an oversell of products!
	 *
	 * @param \Aimeos\MShop\Order\Item\Iface $orderItem Order item object
	 * @return void
	 */
	public function unblock( \Aimeos\MShop\Order\Item\Iface $orderItem )
	{
		$this->getController()->unblock( $orderItem );
	}


	/**
	 * Blocks or frees the resources listed in the order if necessary.
	 *
	 * After payment status updates, the resources like products or coupon
	 * codes listed in the order must be blocked or unblocked. This method
	 * cares about executing the appropriate action depending on the payment
	 * status.
	 *
	 * It's save to call this method multiple times for one order. In this case,
	 * the actions will be executed only once. All subsequent calls will do
	 * nothing as long as the payment status hasn't changed in the meantime.
	 *
	 * @param \Aimeos\MShop\Order\Item\Iface $orderItem Order item object
	 * @return void
	 */
	public function update( \Aimeos\MShop\Order\Item\Iface $orderItem )
	{
		$this->getController()->update( $orderItem );
	}


	/**
	 * Returns the frontend controller
	 *
	 * @return \Aimeos\Controller\Frontend\Order\Iface Frontend controller object
	 */
	protected function getController()
	{
		return $this->controller;
	}
}


1			<?php
2
3			/**
4			* @license LGPLv3, http://opensource.org/licenses/LGPL-3.0
5			* @copyright Aimeos (aimeos.org), 2016-2017
6			* @package Controller
7			* @subpackage Frontend
8			*/
9
10
11			namespace Aimeos\Controller\Frontend\Order\Decorator;
12
13
14			/**
15			* Base for order frontend controller decorators
16			*
17			* @package Controller
18			* @subpackage Frontend
19			*/
20			abstract class Base
21			extends \Aimeos\Controller\Frontend\Base
22			implements \Aimeos\Controller\Frontend\Common\Decorator\Iface, \Aimeos\Controller\Frontend\Order\Iface
23			{
24			private $controller;
25
26
27			/**
28			* Initializes the controller decorator.
29			*
30			* @param \Aimeos\Controller\Frontend\Iface $controller Controller object
31			* @param \Aimeos\MShop\Context\Item\Iface $context Context object with required objects
32			*/
33			public function __construct( \Aimeos\Controller\Frontend\Iface $controller, \Aimeos\MShop\Context\Item\Iface $context )
34			{
35			$iface = '\Aimeos\Controller\Frontend\Order\Iface';
36			if( !( $controller instanceof $iface ) )
37			{
38			$msg = sprintf( 'Class "%1$s" does not implement interface "%2$s"', get_class( $controller ), $iface );
39			throw new \Aimeos\Controller\Frontend\Exception( $msg );
40			}
41
42			$this->controller = $controller;
43
44			parent::__construct( $context );
45			}
46
47
48			/**
49			* Passes unknown methods to wrapped objects.
50			*
51			* @param string $name Name of the method
52			* @param array $param List of method parameter
53			* @return mixed Returns the value of the called method
54			* @throws \Aimeos\Controller\Frontend\Exception If method call failed
55			*/
56			public function __call( $name, array $param )
57			{
58			return @call_user_func_array( array( $this->controller, $name ), $param );
59			}
60
61
62			/**
63			* Creates and adds a new order for the given order base ID
64			*
65			* @param string $baseId Unique ID of the saved basket
66			* @param string $type Arbitrary order type (max. eight chars)
67			* @return \Aimeos\MShop\Order\Item\Iface Created order object
68			*/
69			public function addItem( $baseId, $type )
70			{
71			return $this->controller->addItem( $baseId, $type );
72			}
73
74
75			/**
76			* Returns the filter for searching items
77			*
78			* @return \Aimeos\MW\Criteria\Iface Filter object
79			*/
80			public function createFilter()
81			{
82			return $this->controller->createFilter();
83			}
84
85
86			/**
87			* Returns the order item for the given ID
88			*
89			* @param string $id Unique order ID
90			* @param boolean $default Use default criteria to limit orders
91			* @return \Aimeos\MShop\Order\Item\Iface Order object
92			*/
93			public function getItem( $id, $default = true )
94			{
95			return $this->controller->getItem( $id );
96			}
97
98
99			/**
100			* Saves the modified order item
101			*
102			* @param \Aimeos\MShop\Order\Item\Iface $item Order object
103			* @return \Aimeos\MShop\Order\Item\Iface Saved order item
104			*/
105			public function saveItem( \Aimeos\MShop\Order\Item\Iface $item )
106			{
107			return $this->controller->saveItem( $item );
108			}
109
110
111			/**
112			* Returns the order items based on the given filter that belong to the current user
113			*
114			* @param \Aimeos\MW\Criteria\Iface Filter object
115			* @param integer &$total\|null Variable that will contain the total number of available items
116			* @return \Aimeos\MShop\Order\Item\Iface[] Associative list of IDs as keys and order objects as values
117			*/
118			public function searchItems( \Aimeos\MW\Criteria\Iface $filter, &$total = null )
119			{
120			return $this->controller->searchItems( $filter, $total );
121			}
122
123
124			/**
125			* Blocks the resources listed in the order.
126			*
127			* Every order contains resources like products or redeemed coupon codes
128			* that must be blocked so they can't be used by another customer in a
129			* later order. This method reduces the the stock level of products, the
130			* counts of coupon codes and others.
131			*
132			* It's save to call this method multiple times for one order. In this case,
133			* the actions will be executed only once. All subsequent calls will do
134			* nothing as long as the resources haven't been unblocked in the meantime.
135			*
136			* You can also block and unblock resources several times. Please keep in
137			* mind that unblocked resources may be reused by other orders in the
138			* meantime. This can lead to an oversell of products!
139			*
140			* @param \Aimeos\MShop\Order\Item\Iface $orderItem Order item object
141			* @return void
142			*/
143			public function block( \Aimeos\MShop\Order\Item\Iface $orderItem )
144			{
145			$this->getController()->block( $orderItem );
146			}
147
148
149			/**
150			* Frees the resources listed in the order.
151			*
152			* If customers created orders but didn't pay for them, the blocked resources
153			* like products and redeemed coupon codes must be unblocked so they can be
154			* ordered again or used by other customers. This method increased the stock
155			* level of products, the counts of coupon codes and others.
156			*
157			* It's save to call this method multiple times for one order. In this case,
158			* the actions will be executed only once. All subsequent calls will do
159			* nothing as long as the resources haven't been blocked in the meantime.
160			*
161			* You can also unblock and block resources several times. Please keep in
162			* mind that unblocked resources may be reused by other orders in the
163			* meantime. This can lead to an oversell of products!
164			*
165			* @param \Aimeos\MShop\Order\Item\Iface $orderItem Order item object
166			* @return void
167			*/
168			public function unblock( \Aimeos\MShop\Order\Item\Iface $orderItem )
169			{
170			$this->getController()->unblock( $orderItem );
171			}
172
173
174			/**
175			* Blocks or frees the resources listed in the order if necessary.
176			*
177			* After payment status updates, the resources like products or coupon
178			* codes listed in the order must be blocked or unblocked. This method
179			* cares about executing the appropriate action depending on the payment
180			* status.
181			*
182			* It's save to call this method multiple times for one order. In this case,
183			* the actions will be executed only once. All subsequent calls will do
184			* nothing as long as the payment status hasn't changed in the meantime.
185			*
186			* @param \Aimeos\MShop\Order\Item\Iface $orderItem Order item object
187			* @return void
188			*/
189			public function update( \Aimeos\MShop\Order\Item\Iface $orderItem )
190			{
191			$this->getController()->update( $orderItem );
192			}
193
194
195			/**
196			* Returns the frontend controller
197			*
198			* @return \Aimeos\Controller\Frontend\Order\Iface Frontend controller object
199			*/
200			protected function getController()
201			{
202			return $this->controller;
203			}
204			}
205

aimeos / ai-controller-frontend

Push — master ( 27d1e4...1acb66 )

Base::getItem() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like