1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<?php
/**
* Copyright © Magento, Inc. All rights reserved.
* See COPYING.txt for license details.
*/
namespace Magento\Backend\Model\Menu\Builder;
/**
* Menu builder command
* @api
* @since 100.0.2
*/
abstract class AbstractCommand
{
/**
* List of required params
*
* @var string[]
*/
protected $_requiredParams = ["id"];
/**
* Command params array
*
* @var array
*/
protected $_data = [];
/**
* Next command in the chain
*
* @var \Magento\Backend\Model\Menu\Builder\AbstractCommand
*/
protected $_next = null;
/**
* @param array $data
* @throws \InvalidArgumentException
*/
public function __construct(array $data = [])
{
foreach ($this->_requiredParams as $param) {
if (!isset($data[$param]) || $data[$param] === null) {
throw new \InvalidArgumentException("Missing required param " . $param);
}
}
$this->_data = $data;
}
/**
* Retrieve id of element to apply command to
*
* @return int
*/
public function getId()
{
return $this->_data['id'];
}
/**
* Add command as last in the list of callbacks
*
* @param \Magento\Backend\Model\Menu\Builder\AbstractCommand $command
* @return $this
* @throws \InvalidArgumentException if invalid chaining command is supplied
*/
public function chain(\Magento\Backend\Model\Menu\Builder\AbstractCommand $command)
{
if ($this->_next === null) {
$this->_next = $command;
} else {
$this->_next->chain($command);
}
return $this;
}
/**
* Execute command and pass control to chained commands
*
* @param array $itemParams
* @return array
*/
public function execute(array $itemParams = [])
{
$itemParams = $this->_execute($itemParams);
if ($this->_next !== null) {
$itemParams = $this->_next->execute($itemParams);
}
return $itemParams;
}
/**
* Execute internal command actions
*
* @param array $itemParams
* @return array
*/
abstract protected function _execute(array $itemParams);
}