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 = []
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	$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 46 of file ApiContinuationManager.php.

References $allModules, $generatedModules, ApiBase\extractRequestParams(), ApiBase\getMain(), ApiBase\getModuleName(), and ContextSource\getRequest().

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 $continuationData, and $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 261 of file ApiContinuationManager.php.

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

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.

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 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:

• includes/api/ApiContinuationManager.php