MediaWiki  master
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. More...
 
 addGeneratorContinueParam (ApiBase $module, $paramName, $paramValue)
 Set the continuation parameter for the generator module. More...
 
 addGeneratorNonContinueParam (ApiBase $module, $paramName, $paramValue)
 Set the non-continuation parameter for the generator module. More...
 
 getContinuation ()
 Fetch continuation result data. More...
 
 getRawContinuation ()
 Fetch raw continuation data. More...
 
 getRawNonContinuation ()
 Fetch raw non-continuation data. More...
 
 getRunModules ()
 Get the list of modules that should actually be run. More...
 
 getSource ()
 Get the class that created this manager. More...
 
 isGeneratorDone ()
 Is the generator done? More...
 
 setContinuationIntoResult (ApiResult $result)
 Store the continuation data into the result. More...
 

Private Attributes

 $allModules = []
 
array [] $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[]$allModules Contains ApiBase instances that will be executed
array$generatedModulesNames of modules that depend on the generator
Exceptions
ApiUsageException

Definition at line 46 of file ApiContinuationManager.php.

References $allModules, $generatedModules, ApiBase\getMain(), ContextSource\getRequest(), and ApiUsageException\newWithMessage().

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 123 of file ApiContinuationManager.php.

References 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 170 of file ApiContinuationManager.php.

References 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 155 of file ApiContinuationManager.php.

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

◆ getContinuation()

ApiContinuationManager::getContinuation ( )

Fetch continuation result data.

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

Definition at line 200 of file ApiContinuationManager.php.

References $generatorParams.

Referenced by setContinuationIntoResult().

◆ getRawContinuation()

ApiContinuationManager::getRawContinuation ( )

Fetch raw continuation data.

Returns
array

Definition at line 183 of file ApiContinuationManager.php.

◆ getRawNonContinuation()

ApiContinuationManager::getRawNonContinuation ( )

Fetch raw non-continuation data.

Since
1.28
Returns
array

Definition at line 192 of file ApiContinuationManager.php.

References $generatorNonContinuationData.

◆ getRunModules()

ApiContinuationManager::getRunModules ( )

Get the list of modules that should actually be run.

Returns
ApiBase[]

Definition at line 112 of file ApiContinuationManager.php.

◆ getSource()

ApiContinuationManager::getSource ( )

Get the class that created this manager.

Returns
string

Definition at line 96 of file ApiContinuationManager.php.

References $source.

◆ isGeneratorDone()

ApiContinuationManager::isGeneratorDone ( )

Is the generator done?

Returns
bool

Definition at line 104 of file ApiContinuationManager.php.

References $generatorDone.

◆ setContinuationIntoResult()

ApiContinuationManager::setContinuationIntoResult ( ApiResult  $result)

Store the continuation data into the result.

Parameters
ApiResult$result

Definition at line 262 of file ApiContinuationManager.php.

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

Member Data Documentation

◆ $allModules

ApiContinuationManager::$allModules = []
private

Definition at line 29 of file ApiContinuationManager.php.

Referenced by __construct().

◆ $continuationData

array [] ApiContinuationManager::$continuationData = []
private

Definition at line 33 of file ApiContinuationManager.php.

◆ $generatedModules

ApiContinuationManager::$generatedModules = []
private

Definition at line 30 of file ApiContinuationManager.php.

Referenced by __construct().

◆ $generatorContinuationData

ApiContinuationManager::$generatorContinuationData = []
private

Definition at line 34 of file ApiContinuationManager.php.

◆ $generatorDone

ApiContinuationManager::$generatorDone = false
private

Definition at line 38 of file ApiContinuationManager.php.

Referenced by isGeneratorDone().

◆ $generatorNonContinuationData

ApiContinuationManager::$generatorNonContinuationData = []
private

Definition at line 35 of file ApiContinuationManager.php.

Referenced by getRawNonContinuation().

◆ $generatorParams

ApiContinuationManager::$generatorParams = []
private

Definition at line 37 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: