This class holds a list of modules and handles instantiation. More...

Inheritance diagram for ApiModuleManager:

[legend]

Collaboration diagram for ApiModuleManager:

[legend]

Public Member Functions
	__construct (ApiBase $parentModule, ObjectFactory $objectFactory=null)
	Construct new module manager. More...

	addModule ( $name, $group, $spec, $factory=null)
	Add or overwrite a module in this ApiMain instance. More...

	addModules (array $modules, $group)
	Add a list of modules to the manager. More...

	getClassName ( $module)
	Returns the class name of the given module. More...

	getGroups ()
	Get a list of groups this manager contains. More...

	getModule ( $moduleName, $group=null, $ignoreCache=false)
	Get module instance by name, or instantiate it if it does not exist. More...

	getModuleGroup ( $moduleName)
	Returns the group name for the given module. More...

	getNames ( $group=null)
	Get an array of modules in a specific group or all if no group is set. More...

	getNamesWithClasses ( $group=null)
	Create an array of (moduleName => moduleClass) for a specific group or for all. More...

	isDefined ( $moduleName, $group=null)
	Returns true if the specific module is defined at all or in a specific group. More...

Public Member Functions inherited from ContextSource
	canUseWikiPage ()
	Check whether a WikiPage object can be get with getWikiPage(). More...

	exportSession ()
	Export the resolved user IP, HTTP headers, user ID, and session ID. More...

	getConfig ()

	getContext ()
	Get the base IContextSource object. More...

	getLanguage ()

	getOutput ()

	getRequest ()

	getSkin ()

	getStats ()

	getTiming ()

	getTitle ()

	getUser ()

	getWikiPage ()
	Get the WikiPage object. More...

	msg ( $key,... $params)
	Get a Message object with context set Parameters are the same as wfMessage() More...

	setContext (IContextSource $context)

Private Member Functions
	instantiateModule ( $name, $spec)
	Instantiate the module using the given class or factory function. More...

Private Attributes
null[]	$mGroups = []

ApiBase[]	$mInstances = []

array[]	$mModules = []

ApiBase	$mParent

ObjectFactory	$objectFactory

Detailed Description

This class holds a list of modules and handles instantiation.

Since: 1.21

Definition at line 33 of file ApiModuleManager.php.

Constructor & Destructor Documentation

◆ __construct()

ApiModuleManager::__construct	(	ApiBase	$parentModule,
		ObjectFactory	$objectFactory = `null`
	)

Construct new module manager.

Parameters

ApiBase	$parentModule	Parent module instance will be used during instantiation
ObjectFactory \| null	$objectFactory	Object factory to use when instantiating modules

Definition at line 62 of file ApiModuleManager.php.

References $objectFactory.

Member Function Documentation

◆ addModule()

ApiModuleManager::addModule	(	$name,
		$group,
		$spec,
		$factory = `null`
	)

Add or overwrite a module in this ApiMain instance.

Intended for use by extending classes who wish to add their own modules to their lexicon or override the behavior of inherent ones.

ObjectFactory is used to instantiate the module when needed. The parent module ($parentModule from __construct()) and the $name are passed as extraArgs.

Since: 1.34, accepts an ObjectFactory spec as the third parameter. The old calling convention, passing a class name as parameter #3 and an optional factory callable as parameter #4, is deprecated.

Parameters

string	$name	The identifier for this module.
string	$group	Name of the module group
string \| array	$spec	The ObjectFactory spec for instantiating the module, or a class name to instantiate.
callable \| null	$factory	Callback for instantiating the module (deprecated).

Exceptions

InvalidArgumentException

Definition at line 102 of file ApiModuleManager.php.

References wfDeprecated().

Referenced by addModules().

◆ addModules()

ApiModuleManager::addModules	(	array	$modules,
			$group
	)

Add a list of modules to the manager.

Each module is described by an ObjectFactory spec.

This simply calls addModule() for each module in $modules.

See also: ApiModuleManager::addModule()

Parameters

array	$modules	A map of ModuleName => ModuleSpec
string	$group	Which group modules belong to (action,format,...)

Definition at line 77 of file ApiModuleManager.php.

References $modules, and addModule().

◆ getClassName()

ApiModuleManager::getClassName ( $module )

Returns the class name of the given module.

Parameters

string $module Module name

Returns: string|bool class name or false if the module does not exist

Since: 1.24

Definition at line 230 of file ApiModuleManager.php.

◆ getGroups()

ApiModuleManager::getGroups ( )

Get a list of groups this manager contains.

Returns: array

Definition at line 269 of file ApiModuleManager.php.

◆ getModule()

ApiModuleManager::getModule	(	$moduleName,
		$group = `null`,
		$ignoreCache = `false`
	)

Get module instance by name, or instantiate it if it does not exist.

Parameters

string	$moduleName	Module name
string \| null	$group	Optionally validate that the module is in a specific group
bool	$ignoreCache	If true, force-creates a new instance and does not cache it

Returns: ApiBase|null The new module instance, or null if failed

Definition at line 139 of file ApiModuleManager.php.

References instantiateModule().

◆ getModuleGroup()

ApiModuleManager::getModuleGroup ( $moduleName )

Returns the group name for the given module.

Parameters

string $moduleName

Returns: string|null Group name or null if missing

Definition at line 257 of file ApiModuleManager.php.

◆ getNames()

ApiModuleManager::getNames ( $group = null )

Get an array of modules in a specific group or all if no group is set.

Parameters

string | null $group Optional group filter

Returns: array List of module names

Definition at line 193 of file ApiModuleManager.php.

◆ getNamesWithClasses()

ApiModuleManager::getNamesWithClasses ( $group = null )

Create an array of (moduleName => moduleClass) for a specific group or for all.

Parameters

string | null $group Name of the group to get or null for all

Returns: array Name=>class map

Definition at line 212 of file ApiModuleManager.php.

◆ instantiateModule()

ApiModuleManager::instantiateModule	(	$name,
		$spec
	)

private

Instantiate the module using the given class or factory function.

Parameters

string	$name	The identifier for this module.
array	$spec	The ObjectFactory spec for instantiating the module.

Exceptions

UnexpectedValueException

Returns: ApiBase

Definition at line 175 of file ApiModuleManager.php.

Referenced by getModule().

◆ isDefined()

ApiModuleManager::isDefined	(	$moduleName,
		$group = `null`
	)

Returns true if the specific module is defined at all or in a specific group.

Parameters

string	$moduleName	Module name
string \| null	$group	Group name to check against, or null to check all groups,

Returns: bool True if defined

Definition at line 244 of file ApiModuleManager.php.

Member Data Documentation

◆ $mGroups

null [] ApiModuleManager::$mGroups = []

private

Definition at line 46 of file ApiModuleManager.php.

◆ $mInstances

ApiBase [] ApiModuleManager::$mInstances = []

private

Definition at line 42 of file ApiModuleManager.php.

◆ $mModules

array [] ApiModuleManager::$mModules = []

private

Definition at line 50 of file ApiModuleManager.php.

◆ $mParent

ApiBase ApiModuleManager::$mParent

private

Definition at line 38 of file ApiModuleManager.php.

◆ $objectFactory

ObjectFactory ApiModuleManager::$objectFactory

private

Definition at line 54 of file ApiModuleManager.php.

Referenced by __construct().

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

includes/api/ApiModuleManager.php

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addModule()

◆ addModules()

◆ getClassName()

◆ getGroups()

◆ getModule()

◆ getModuleGroup()

◆ getNames()

◆ getNamesWithClasses()

◆ instantiateModule()

◆ isDefined()

Member Data Documentation

◆ $mGroups

◆ $mInstances

◆ $mModules

◆ $mParent

◆ $objectFactory