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

Inheritance diagram for ApiModuleManager:

Collaboration diagram for ApiModuleManager:

Public Member Functions
	__construct (ApiBase $parentModule)
	Construct new module manager.
	addModule ($name, $group, $class, $factory=null)
	Add or overwrite a module in this ApiMain instance.
	addModules (array $modules, $group)
	Add a list of modules to the manager.
	getClassName ($module)
	Returns the class name of the given module.
	getGroups ()
	Get a list of groups this manager contains.
	getModule ($moduleName, $group=null, $ignoreCache=false)
	Get module instance by name, or instantiate it if it does not exist.
	getModuleGroup ($moduleName)
	Returns the group name for the given module.
	getNames ($group=null)
	Get an array of modules in a specific group or all if no group is set.
	getNamesWithClasses ($group=null)
	Create an array of (moduleName => moduleClass) for a specific group or for all.
	isDefined ($moduleName, $group=null)
	Returns true if the specific module is defined at all or in a specific group.
Private Member Functions
	instantiateModule ($name, $class, $factory=null)
	Instantiate the module using the given class or factory function.
Private Attributes
null[]	$mGroups = array()
ApiBase[]	$mInstances = array()
array[]	$mModules = array()
ApiBase	$mParent

Detailed Description

This class holds a list of modules and handles instantiation.

Since:: 1.21

Definition at line 34 of file ApiModuleManager.php.

Constructor & Destructor Documentation

ApiModuleManager::__construct ( ApiBase $ parentModule )

Construct new module manager.

Parameters:

ApiBase $parentModule Parent module instance will be used during instantiation

Definition at line 53 of file ApiModuleManager.php.

Member Function Documentation

ApiModuleManager::addModule	(	$	name,
		$	group,
		$	class,
		$	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.

Parameters:

string	$name	The identifier for this module.
string	$group	Name of the module group
string	$class	The class where this module is implemented.
callable \| null	$factory	Callback for instantiating the module.

Exceptions:

InvalidArgumentException

Definition at line 122 of file ApiModuleManager.php.

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

Add a list of modules to the manager.

Each module is described by a module spec.

Each module spec is an associative array containing at least the 'class' key for the module's class, and optionally a 'factory' key for the factory function to use for the module.

That factory function will be called with two parameters, the parent module (an instance of ApiBase, usually ApiMain) and the name the module was registered under. The return value must be an instance of the class given in the 'class' field.

For backward compatibility, the module spec may also be a simple string containing the module's class name. In that case, the class' constructor will be called with the parent module and module name as parameters, as described above.

Examples for defining module specs:

  $modules['foo'] = 'ApiFoo';
  $modules['bar'] = array(
      'class' => 'ApiBar',
      'factory' => function( $main, $name ) { ... }
  );
  $modules['xyzzy'] = array(
      'class' => 'ApiXyzzy',
      'factory' => array( 'XyzzyFactory', 'newApiModule' )
  );

Parameters:

array	$modules	A map of ModuleName => ModuleSpec; The ModuleSpec is either a string containing the module's class name, or an associative array (see above for details).
string	$group	Which group modules belong to (action,format,...)

Definition at line 95 of file ApiModuleManager.php.

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 247 of file ApiModuleManager.php.

ApiModuleManager::getGroups ( )

Get a list of groups this manager contains.

Returns:: array

Definition at line 286 of file ApiModuleManager.php.

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	$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 152 of file ApiModuleManager.php.

ApiModuleManager::getModuleGroup ( $ moduleName )

Returns the group name for the given module.

Parameters:

string $moduleName

Returns:: string Group name or null if missing

Definition at line 274 of file ApiModuleManager.php.

ApiModuleManager::getNames ( $ group = null )

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

Parameters:

string $group Optional group filter

Returns:: array List of module names

Definition at line 210 of file ApiModuleManager.php.

ApiModuleManager::getNamesWithClasses ( $ group = null )

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

Parameters:

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

Returns:: array Name=>class map

Definition at line 229 of file ApiModuleManager.php.

ApiModuleManager::instantiateModule	(	$	name,
		$	class,
		$	factory = `null`
	)		`[private]`

Instantiate the module using the given class or factory function.

Parameters:

string	$name	The identifier for this module.
string	$class	The class where this module is implemented.
callable \| null	$factory	Callback for instantiating the module.

Exceptions:

MWException

Returns:: ApiBase

Definition at line 189 of file ApiModuleManager.php.

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	$group	Group name to check against, or null to check all groups,

Returns:: bool True if defined

Definition at line 261 of file ApiModuleManager.php.

Member Data Documentation

null [] ApiModuleManager::$mGroups = array() [private]

Definition at line 44 of file ApiModuleManager.php.

ApiBase [] ApiModuleManager::$mInstances = array() [private]

Definition at line 41 of file ApiModuleManager.php.

array [] ApiModuleManager::$mModules = array() [private]

Definition at line 47 of file ApiModuleManager.php.

ApiBase ApiModuleManager::$mParent [private]

Definition at line 38 of file ApiModuleManager.php.

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

Member Function Documentation

Member Data Documentation