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 = []
	$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	$module	Module starting the continuation
ApiBase[]	$allModules	Contains ApiBase instances that will be executed
array	$generatedModules	Names of modules that depend on the generator

Exceptions

ApiUsageException

Definition at line 45 of file ApiContinuationManager.php.

References $allModules, $generatedModules, $name, $params, $request, as, captcha-old\count, ApiBase\getMain(), ContextSource\getRequest(), ApiUsageException\newWithMessage(), 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 122 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 169 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 154 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 199 of file ApiContinuationManager.php.

References $continuationData, $data, $generatorParams, and as.

Referenced by setContinuationIntoResult().

getRawContinuation()

ApiContinuationManager::getRawContinuation

(

)

Fetch raw continuation data.

Returns

array

Definition at line 182 of file ApiContinuationManager.php.

getRawNonContinuation()

ApiContinuationManager::getRawNonContinuation

(

)

Fetch raw non-continuation data.

Since

1.28

Returns

array

Definition at line 191 of file ApiContinuationManager.php.

References $generatorNonContinuationData.

getRunModules()

ApiContinuationManager::getRunModules

(

)

Get the list of modules that should actually be run.

Returns

ApiBase[]

Definition at line 111 of file ApiContinuationManager.php.

getSource()

ApiContinuationManager::getSource

(

)

Get the class that created this manager.

Returns

string

Definition at line 95 of file ApiContinuationManager.php.

References $source.

isGeneratorDone()

ApiContinuationManager::isGeneratorDone

(

)

Is the generator done?

Returns

bool

Definition at line 103 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 $data, ApiResult\ADD_ON_TOP, ApiResult\addValue(), 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:

• includes/api/ApiContinuationManager.php