MediaWiki REL1_28
ApiContinuationManager Class Reference

This manages continuation state. More...

Public Member Functions

 __construct (ApiBase $module, array $allModules=[], array $generatedModules=[])
 
 addContinueParam (ApiBase $module, $paramName, $paramValue)
 Set the continuation parameter for a module.
 
 addGeneratorContinueParam (ApiBase $module, $paramName, $paramValue)
 Set the continuation parameter for the generator module.
 
 addGeneratorNonContinueParam (ApiBase $module, $paramName, $paramValue)
 Set the non-continuation parameter for the generator module.
 
 getContinuation ()
 Fetch continuation result data.
 
 getRawContinuation ()
 Fetch raw continuation data.
 
 getRawNonContinuation ()
 Fetch raw non-continuation data.
 
 getRunModules ()
 Get the list of modules that should actually be run.
 
 getSource ()
 Get the class that created this manager.
 
 isGeneratorDone ()
 Is the generator done?
 
 setContinuationIntoResult (ApiResult $result)
 Store the continuation data into the result.
 

Private Attributes

 $allModules = []
 
 $continuationData = []
 
 $generatedModules = []
 
 $generatorContinuationData = []
 
 $generatorDone = false
 
 $generatorNonContinuationData = []
 
 $generatorParams = []
 
 $source
 

Detailed Description

This manages continuation state.

Since
1.25 this is no longer a subclass of ApiBase

Definition at line 26 of file ApiContinuationManager.php.

Constructor & Destructor Documentation

◆ __construct()

ApiContinuationManager::__construct ( ApiBase  $module,
array  $allModules = [],
array  $generatedModules = [] 
)
Parameters
ApiBase$moduleModule starting the continuation
ApiBase[]$allModulesContains ApiBase instances that will be executed
array$generatedModulesNames of modules that depend on the generator
Exceptions
UsageException

Definition at line 45 of file ApiContinuationManager.php.

References $allModules, $generatedModules, $name, $params, $request, as, ApiBase\extractRequestParams(), ApiBase\getModuleName(), ContextSource\getRequest(), and source.

Member Function Documentation

◆ addContinueParam()

ApiContinuationManager::addContinueParam ( ApiBase  $module,
  $paramName,
  $paramValue 
)

Set the continuation parameter for a module.

Parameters
ApiBase$module
string$paramName
string | array$paramValue
Exceptions
UnexpectedValueException

Definition at line 125 of file ApiContinuationManager.php.

References $name, ApiBase\encodeParamName(), and ApiBase\getModuleName().

◆ addGeneratorContinueParam()

ApiContinuationManager::addGeneratorContinueParam ( ApiBase  $module,
  $paramName,
  $paramValue 
)

Set the continuation parameter for the generator module.

Parameters
ApiBase$module
string$paramName
string | array$paramValue

Definition at line 172 of file ApiContinuationManager.php.

References $name, ApiBase\encodeParamName(), and ApiBase\getModuleName().

◆ addGeneratorNonContinueParam()

ApiContinuationManager::addGeneratorNonContinueParam ( ApiBase  $module,
  $paramName,
  $paramValue 
)

Set the non-continuation parameter for the generator module.

In case the generator isn't going to be continued, this sets the fields to return.

Since
1.28
Parameters
ApiBase$module
string$paramName
string | array$paramValue

Definition at line 157 of file ApiContinuationManager.php.

References $name, ApiBase\encodeParamName(), and ApiBase\getModuleName().

◆ getContinuation()

ApiContinuationManager::getContinuation ( )

Fetch continuation result data.

Returns
array [ (array)$data, (bool)$batchcomplete ]

Definition at line 202 of file ApiContinuationManager.php.

References $continuationData, $generatorParams, and as.

Referenced by setContinuationIntoResult().

◆ getRawContinuation()

ApiContinuationManager::getRawContinuation ( )

Fetch raw continuation data.

Returns
array

Definition at line 185 of file ApiContinuationManager.php.

◆ getRawNonContinuation()

ApiContinuationManager::getRawNonContinuation ( )

Fetch raw non-continuation data.

Since
1.28
Returns
array

Definition at line 194 of file ApiContinuationManager.php.

References $generatorNonContinuationData.

◆ getRunModules()

ApiContinuationManager::getRunModules ( )

Get the list of modules that should actually be run.

Returns
ApiBase[]

Definition at line 114 of file ApiContinuationManager.php.

◆ getSource()

ApiContinuationManager::getSource ( )

Get the class that created this manager.

Returns
string

Definition at line 98 of file ApiContinuationManager.php.

References $source.

◆ isGeneratorDone()

ApiContinuationManager::isGeneratorDone ( )

Is the generator done?

Returns
bool

Definition at line 106 of file ApiContinuationManager.php.

References $generatorDone.

◆ setContinuationIntoResult()

ApiContinuationManager::setContinuationIntoResult ( ApiResult  $result)

Store the continuation data into the result.

Parameters
ApiResult$result

Definition at line 263 of file ApiContinuationManager.php.

References ApiResult\ADD_ON_TOP, getContinuation(), list, and ApiResult\NO_SIZE_CHECK.

Member Data Documentation

◆ $allModules

ApiContinuationManager::$allModules = []
private

Definition at line 29 of file ApiContinuationManager.php.

Referenced by __construct().

◆ $continuationData

ApiContinuationManager::$continuationData = []
private

Definition at line 32 of file ApiContinuationManager.php.

Referenced by getContinuation().

◆ $generatedModules

ApiContinuationManager::$generatedModules = []
private

Definition at line 30 of file ApiContinuationManager.php.

Referenced by __construct().

◆ $generatorContinuationData

ApiContinuationManager::$generatorContinuationData = []
private

Definition at line 33 of file ApiContinuationManager.php.

◆ $generatorDone

ApiContinuationManager::$generatorDone = false
private

Definition at line 37 of file ApiContinuationManager.php.

Referenced by isGeneratorDone().

◆ $generatorNonContinuationData

ApiContinuationManager::$generatorNonContinuationData = []
private

Definition at line 34 of file ApiContinuationManager.php.

Referenced by getRawNonContinuation().

◆ $generatorParams

ApiContinuationManager::$generatorParams = []
private

Definition at line 36 of file ApiContinuationManager.php.

Referenced by getContinuation().

◆ $source

ApiContinuationManager::$source
private

Definition at line 27 of file ApiContinuationManager.php.

Referenced by getSource().


The documentation for this class was generated from the following file: