/
Jobs.php
255 lines (214 loc) · 9.5 KB
/
Jobs.php
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
<?php
/**
* @license LGPLv3, https://opensource.org/licenses/LGPL-3.0
* @copyright Aimeos (aimeos.org), 2015-2024
* @package Controller
* @subpackage Jobs
*/
namespace Aimeos\Controller;
/**
* Factory which can create all job controllers
*
* @package Controller
* @subpackage Jobs
*/
class Jobs
{
private static $objects = [];
/**
* Creates the required controller specified by the given path of controller names.
*
* Controllers are created by providing only the domain name, e.g.
* "stock" for the \Aimeos\Controller\Jobs\Stock\Standard.
* Please note, that only the default controllers can be created. If you need
* a specific implementation, you need to use the factory class of the
* controller to hand over specifc implementation names.
*
* @param \Aimeos\MShop\ContextIface $context Context object required by controllers
* @param \Aimeos\Bootstrap $aimeos \Aimeos\Bootstrap object
* @param string $path Name of the domain
* @param string|null $name Name of the controller implementation ("Standard" if null)
* @return \Aimeos\Controller\Jobs\Iface Controller class instance
* @throws \Aimeos\Controller\Jobs\Exception If the given path is invalid or the controllers wasn't found
*/
public static function create( \Aimeos\MShop\ContextIface $context, \Aimeos\Bootstrap $aimeos,
string $path, string $name = null ) : \Aimeos\Controller\Jobs\Iface
{
if( empty( $path ) ) {
throw new \Aimeos\Controller\Jobs\Exception( 'Controller path is empty', 400 );
}
if( empty( $name ) ) {
$name = $context->config()->get( 'controller/jobs/' . $path . '/name', 'Standard' );
}
$iface = '\\Aimeos\\Controller\\Jobs\\Iface';
$classname = '\\Aimeos\\Controller\\Jobs\\' . str_replace( '/', '\\', ucwords( $path, '/' ) ) . '\\' . $name;
return self::createController( $context, $aimeos, $classname, $iface, $path );
}
/**
* Returns all available controller instances.
*
* @param \Aimeos\MShop\ContextIface $context Context object required by controllers
* @param \Aimeos\Bootstrap $aimeos \Aimeos\Bootstrap object
* @param array $cntlPaths Associative list of the base path as key and all relative job controller paths (core and extensions)
* @return \Aimeos\Controller\Jobs\Iface[] Associative list of controller names as values and class instance as values
*/
public static function get( \Aimeos\MShop\ContextIface $context, \Aimeos\Bootstrap $aimeos, array $cntlPaths ) : array
{
$cntlList = [];
$ds = DIRECTORY_SEPARATOR;
foreach( $cntlPaths as $path => $list )
{
foreach( $list as $relpath )
{
$path .= $ds . str_replace( '/', $ds, $relpath . '/Controller/Jobs' );
if( is_dir( $path ) )
{
$it = new \DirectoryIterator( $path );
$list = self::createControllers( $it, $context, $aimeos );
$cntlList = array_merge( $cntlList, $list );
}
}
}
ksort( $cntlList );
return $cntlList;
}
/**
* Injects a controller object.
*
* @param string $classname Full name of the class for which the object should be returned
* @param \Aimeos\Controller\Jobs\Iface|null $controller Frontend controller object
*/
public static function inject( string $classname, \Aimeos\Controller\Jobs\Iface $controller = null )
{
self::$objects['\\' . ltrim( $classname, '\\' )] = $controller;
}
/**
* Adds the decorators to the controller object.
*
* @param \Aimeos\MShop\ContextIface $context Context instance with necessary objects
* @param \Aimeos\Bootstrap $aimeos \Aimeos\Bootstrap object
* @param \Aimeos\Controller\Jobs\Iface $controller Controller object
* @param string $domain Domain name in lower case, e.g. "product"
* @return \Aimeos\Controller\Jobs\Iface Controller object
*/
protected static function addControllerDecorators( \Aimeos\MShop\ContextIface $context, \Aimeos\Bootstrap $aimeos,
\Aimeos\Controller\Jobs\Iface $controller, string $domain ) : \Aimeos\Controller\Jobs\Iface
{
$localClass = str_replace( '/', '\\', ucwords( $domain, '/' ) );
$config = $context->config();
/** controller/jobs/common/decorators/default
* Configures the list of decorators applied to all job controllers
*
* Decorators extend the functionality of a class by adding new aspects
* (e.g. log what is currently done), executing the methods of the underlying
* class only in certain conditions (e.g. only for logged in users) or
* modify what is returned to the caller.
*
* This option allows you to configure a list of decorator names that should
* be wrapped around the original instance of all created controllers:
*
* controller/jobs/common/decorators/default = array( 'decorator1', 'decorator2' )
*
* This would wrap the decorators named "decorator1" and "decorator2" around
* all controller instances in that order. The decorator classes would be
* "\Aimeos\Controller\Jobs\Common\Decorator\Decorator1" and
* "\Aimeos\Controller\Jobs\Common\Decorator\Decorator2".
*
* @param array List of decorator names
* @since 2014.03
*/
$decorators = $config->get( 'controller/jobs/common/decorators/default', [] );
$excludes = $config->get( 'controller/jobs/' . $domain . '/decorators/excludes', [] );
foreach( $decorators as $key => $name )
{
if( in_array( $name, $excludes ) ) {
unset( $decorators[$key] );
}
}
$classprefix = '\Aimeos\Controller\Jobs\Common\Decorator\\';
$controller = self::addDecorators( $context, $aimeos, $controller, $decorators, $classprefix );
$classprefix = '\Aimeos\Controller\Jobs\Common\Decorator\\';
$decorators = $config->get( 'controller/jobs/' . $domain . '/decorators/global', [] );
$controller = self::addDecorators( $context, $aimeos, $controller, $decorators, $classprefix );
$classprefix = '\Aimeos\Controller\Jobs\\' . ucfirst( $localClass ) . '\Decorator\\';
$decorators = $config->get( 'controller/jobs/' . $domain . '/decorators/local', [] );
$controller = self::addDecorators( $context, $aimeos, $controller, $decorators, $classprefix );
return $controller;
}
/**
* Adds the decorators to the controller object.
*
* @param \Aimeos\MShop\ContextIface $context Context instance with necessary objects
* @param \Aimeos\Bootstrap $aimeos Aimeos Bootstrap object
* @param \Aimeos\Controller\Jobs\Iface $controller Controller object
* @param array $decorators List of decorator names that should be wrapped around the controller object
* @param string $classprefix Decorator class prefix, e.g. "\Aimeos\Controller\Jobs\Attribute\Decorator\"
* @return \Aimeos\Controller\Jobs\Iface Controller object
* @throws \LogicException If class can't be instantiated
*/
protected static function addDecorators( \Aimeos\MShop\ContextIface $context, \Aimeos\Bootstrap $aimeos,
\Aimeos\Controller\Jobs\Iface $controller, array $decorators, string $classprefix ) : \Aimeos\Controller\Jobs\Iface
{
$interface = \Aimeos\Controller\Jobs\Common\Decorator\Iface::class;
foreach( $decorators as $name )
{
if( ctype_alnum( $name ) === false ) {
throw new \LogicException( sprintf( 'Invalid class name "%1$s"', $name ), 400 );
}
$controller = \Aimeos\Utils::create( $classprefix . $name, [$controller, $context, $aimeos], $interface );
}
return $controller;
}
/**
* Creates a controller object.
*
* @param \Aimeos\MShop\ContextIface $context Context instance with necessary objects
* @param \Aimeos\Bootstrap $aimeos \Aimeos\Bootstrap object
* @param string $classname Name of the controller class
* @param string $interface Name of the controller interface
* @param string $path Name of the domain
* @return \Aimeos\Controller\Jobs\Iface Controller object
*/
protected static function createController( \Aimeos\MShop\ContextIface $context, \Aimeos\Bootstrap $aimeos,
string $classname, string $interface, string $path ) : \Aimeos\Controller\Jobs\Iface
{
if( isset( self::$objects[$classname] ) ) {
return self::$objects[$classname];
}
$cntl = \Aimeos\Utils::create( $classname, [$context, $aimeos], $interface );
return self::addControllerDecorators( $context, $aimeos, $cntl, $path );
}
/**
* Instantiates all found factories and stores the controller instances in the class variable.
*
* @param \DirectoryIterator $dir Iterator over the (sub-)directory which might contain a factory
* @param \Aimeos\MShop\ContextIface $context Context object required by controllers
* @param \Aimeos\Bootstrap $aimeos \Aimeos\Bootstrap object
* @param string $prefix Part of the class name between "\Aimeos\Controller\Jobs" and "Factory"
* @return \Aimeos\Controller\Jobs\Iface[] Associative list if prefixes as values and job controller instances as values
* @throws \Aimeos\Controller\Jobs\Exception If factory name is invalid or if the controller couldn't be instantiated
*/
protected static function createControllers( \DirectoryIterator $dir, \Aimeos\MShop\ContextIface $context,
\Aimeos\Bootstrap $aimeos, string $prefix = '' ) : array
{
$list = [];
foreach( $dir as $entry )
{
if( $entry->getType() === 'dir' && $entry->isDot() === false
&& !in_array( $entry->getBaseName(), ['Common', 'Decorator'] )
) {
$name = strtolower( $entry->getBaseName() );
$it = new \DirectoryIterator( $entry->getPathName() );
$pref = ( $prefix !== '' ? $prefix . '/' : '' ) . $name;
$subList = self::createControllers( $it, $context, $aimeos, $pref );
$list = array_merge( $list, $subList );
}
else if( $prefix !== '' && $entry->getType() === 'file'
&& !in_array( $entry->getBaseName( '.php' ), ['Base'] ) )
{
$list[$prefix] = self::create( $context, $aimeos, $prefix );
}
}
return $list;
}
}