Convenience class for dealing with PoolCounters using callbacks. More...
Public Member Functions | |
| __construct ( $type, $key, array $callbacks) | |
| Build a PoolCounterWork class from a type, key, and callback map. | |
| doWork () | |
| Actually perform the work, caching it if needed. | |
| error ( $status) | |
| Do something with the error, like showing it to the user. | |
| fallback () | |
| A work not so good (eg. | |
| getCachedWork () | |
| Retrieve the work from cache. | |
 Public Member Functions inherited from PoolCounterWork | |
| __construct ( $type, $key) | |
| execute ( $skipcache=false) | |
| Get the result of the work (whatever it is), or the result of the error() function. | |
| logError ( $status) | |
| Log an error. | |
Protected Attributes | |
| callable null | $doCachedWork |
| callable | $doWork |
| callable null | $error |
| callable null | $fallback |
| Protected Attributes inherited from PoolCounterWork | |
| bool | $cacheable = false |
| string | $type = 'generic' |
Detailed Description
Convenience class for dealing with PoolCounters using callbacks.
- Since
- 1.22
Definition at line 28 of file PoolCounterWorkViaCallback.php.
Constructor & Destructor Documentation
◆ __construct()
| PoolCounterWorkViaCallback::__construct | ( | $type, | |
| $key, | |||
| array | $callbacks ) |
Build a PoolCounterWork class from a type, key, and callback map.
The callback map must at least have a callback for the 'doWork' method. Additionally, callbacks can be provided for the 'doCachedWork', 'fallback', and 'error' methods. Methods without callbacks will be no-ops that return false. If a 'doCachedWork' callback is provided, then execute() may wait for any prior process in the pool to finish and reuse its cached result.
- Parameters
-
string $type The class of actions to limit concurrency for string $key array $callbacks Map of callbacks
- Exceptions
-
MWException
Definition at line 52 of file PoolCounterWorkViaCallback.php.
References PoolCounterWork\$type, and doWork().
Member Function Documentation
◆ doWork()
| PoolCounterWorkViaCallback::doWork | ( | ) |
Actually perform the work, caching it if needed.
- Returns
- mixed Work result or false
Reimplemented from PoolCounterWork.
Definition at line 68 of file PoolCounterWorkViaCallback.php.
References doWork().
Referenced by __construct(), and doWork().
◆ error()
| PoolCounterWorkViaCallback::error | ( | $status | ) |
Do something with the error, like showing it to the user.
- Parameters
-
Status $status
- Returns
- bool
Reimplemented from PoolCounterWork.
Definition at line 86 of file PoolCounterWorkViaCallback.php.
References error().
Referenced by error().
◆ fallback()
| PoolCounterWorkViaCallback::fallback | ( | ) |
A work not so good (eg.
expired one) but better than an error message.
- Returns
- mixed Work result or false
Reimplemented from PoolCounterWork.
Definition at line 79 of file PoolCounterWorkViaCallback.php.
References fallback().
Referenced by fallback().
◆ getCachedWork()
| PoolCounterWorkViaCallback::getCachedWork | ( | ) |
Retrieve the work from cache.
- Returns
- mixed Work result or false
Reimplemented from PoolCounterWork.
Definition at line 72 of file PoolCounterWorkViaCallback.php.
Member Data Documentation
◆ $doCachedWork
|
protected |
Definition at line 32 of file PoolCounterWorkViaCallback.php.
◆ $doWork
|
protected |
Definition at line 30 of file PoolCounterWorkViaCallback.php.
◆ $error
|
protected |
Definition at line 36 of file PoolCounterWorkViaCallback.php.
◆ $fallback
|
protected |
Definition at line 34 of file PoolCounterWorkViaCallback.php.
The documentation for this class was generated from the following file:
- includes/poolcounter/PoolCounterWorkViaCallback.php
