MediaWiki REL1_34
Public Member Functions | Private Member Functions | Private Attributes | List of all members
MediaWiki\Rest\Router Class Reference

The REST router is responsible for gathering handler configuration, matching an input path and HTTP method against the defined routes, and constructing and executing the relevant handler for a request. More...

Collaboration diagram for MediaWiki\Rest\Router:
Collaboration graph
[legend]

Public Member Functions

 __construct ( $routeFiles, $extraRoutes, $rootPath, BagOStuff $cacheBag, ResponseFactory $responseFactory, BasicAuthorizerInterface $basicAuth, ObjectFactory $objectFactory, Validator $restValidator)
 
 execute (RequestInterface $request)
 Find the handler for a request and execute it.
 

Private Member Functions

 executeHandler ( $handler)
 Execute a fully-constructed handler.
 
 fetchCacheData ()
 Get the cache data, or false if it is missing or invalid.
 
 getAllRoutes ()
 Get an iterator for all defined routes, including loading the routes from the JSON files.
 
 getCacheKey ()
 
 getConfigHash ()
 Get a config version hash for cache invalidation.
 
 getMatchers ()
 Get an array of PathMatcher objects indexed by HTTP method.
 
 getRelativePath ( $path)
 Remove the path prefix $this->rootPath.
 
 getRouteFileTimestamps ()
 Get an array of last modification times of the defined route files.
 
 getRoutesFromFiles ()
 Load the defined JSON files and return the merged routes.
 

Private Attributes

BasicAuthorizerInterface $basicAuth
 
BagOStuff $cacheBag
 
string null $configHash
 
array $extraRoutes
 
PathMatcher[] null $matchers
 Path matchers by method.
 
ObjectFactory $objectFactory
 
ResponseFactory $responseFactory
 
Validator $restValidator
 
string $rootPath
 
string[] $routeFiles
 
int[] null $routeFileTimestamps
 
array null $routesFromFiles
 

Detailed Description

The REST router is responsible for gathering handler configuration, matching an input path and HTTP method against the defined routes, and constructing and executing the relevant handler for a request.

Definition at line 18 of file Router.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Rest\Router::__construct (   $routeFiles,
  $extraRoutes,
  $rootPath,
BagOStuff  $cacheBag,
ResponseFactory  $responseFactory,
BasicAuthorizerInterface  $basicAuth,
ObjectFactory  $objectFactory,
Validator  $restValidator 
)
Parameters
string[]$routeFilesList of names of JSON files containing routes
array$extraRoutesExtension route array
string$rootPathThe base URL path
BagOStuff$cacheBagA cache in which to store the matcher trees
ResponseFactory$responseFactory
BasicAuthorizerInterface$basicAuth
ObjectFactory$objectFactory
Validator$restValidator

Definition at line 65 of file Router.php.

References MediaWiki\Rest\Router\$basicAuth, MediaWiki\Rest\Router\$cacheBag, MediaWiki\Rest\Router\$extraRoutes, MediaWiki\Rest\Router\$objectFactory, MediaWiki\Rest\Router\$responseFactory, MediaWiki\Rest\Router\$restValidator, MediaWiki\Rest\Router\$rootPath, and MediaWiki\Rest\Router\$routeFiles.

Member Function Documentation

◆ execute()

MediaWiki\Rest\Router::execute ( RequestInterface  $request)

Find the handler for a request and execute it.

Parameters
RequestInterface$request
Returns
ResponseInterface

Definition at line 226 of file Router.php.

References MediaWiki\Rest\Router\$matchers, $path, $response, MediaWiki\Rest\Router\executeHandler(), MediaWiki\Rest\Router\getMatchers(), MediaWiki\Rest\RequestInterface\getMethod(), MediaWiki\Rest\Router\getRelativePath(), MediaWiki\Rest\RequestInterface\getUri(), MediaWiki\Rest\PathTemplateMatcher\PathMatcher\match(), and MediaWiki\Rest\RequestInterface\setPathParams().

◆ executeHandler()

MediaWiki\Rest\Router::executeHandler (   $handler)
private

Execute a fully-constructed handler.

Parameters
Handler$handler
Returns
ResponseInterface

Definition at line 297 of file Router.php.

Referenced by MediaWiki\Rest\Router\execute().

◆ fetchCacheData()

MediaWiki\Rest\Router::fetchCacheData ( )
private

Get the cache data, or false if it is missing or invalid.

Returns
bool|array

Definition at line 85 of file Router.php.

References MediaWiki\Rest\Router\getCacheKey(), and MediaWiki\Rest\Router\getConfigHash().

Referenced by MediaWiki\Rest\Router\getMatchers().

◆ getAllRoutes()

MediaWiki\Rest\Router::getAllRoutes ( )
private

Get an iterator for all defined routes, including loading the routes from the JSON files.

Returns
AppendIterator

Definition at line 159 of file Router.php.

References MediaWiki\Rest\Router\getRoutesFromFiles().

Referenced by MediaWiki\Rest\Router\getMatchers().

◆ getCacheKey()

MediaWiki\Rest\Router::getCacheKey ( )
private
Returns
string The cache key

Definition at line 98 of file Router.php.

Referenced by MediaWiki\Rest\Router\fetchCacheData(), and MediaWiki\Rest\Router\getMatchers().

◆ getConfigHash()

MediaWiki\Rest\Router::getConfigHash ( )
private

Get a config version hash for cache invalidation.

Returns
string

Definition at line 107 of file Router.php.

References MediaWiki\Rest\Router\$configHash, and MediaWiki\Rest\Router\getRouteFileTimestamps().

Referenced by MediaWiki\Rest\Router\fetchCacheData(), and MediaWiki\Rest\Router\getMatchers().

◆ getMatchers()

MediaWiki\Rest\Router::getMatchers ( )
private

Get an array of PathMatcher objects indexed by HTTP method.

Returns
PathMatcher[]

Definition at line 171 of file Router.php.

References MediaWiki\Rest\Router\$matchers, MediaWiki\Rest\PathTemplateMatcher\PathMatcher\add(), MediaWiki\Rest\Router\fetchCacheData(), MediaWiki\Rest\Router\getAllRoutes(), MediaWiki\Rest\Router\getCacheKey(), MediaWiki\Rest\Router\getConfigHash(), and MediaWiki\Rest\PathTemplateMatcher\PathMatcher\newFromCache().

Referenced by MediaWiki\Rest\Router\execute().

◆ getRelativePath()

MediaWiki\Rest\Router::getRelativePath (   $path)
private

Remove the path prefix $this->rootPath.

Return the part of the path with the prefix removed, or false if the prefix did not match.

Parameters
string$path
Returns
false|string

Definition at line 211 of file Router.php.

References $path.

Referenced by MediaWiki\Rest\Router\execute().

◆ getRouteFileTimestamps()

MediaWiki\Rest\Router::getRouteFileTimestamps ( )
private

Get an array of last modification times of the defined route files.

Returns
int[] Last modification times

Definition at line 143 of file Router.php.

References MediaWiki\Rest\Router\$routeFileTimestamps.

Referenced by MediaWiki\Rest\Router\getConfigHash().

◆ getRoutesFromFiles()

MediaWiki\Rest\Router::getRoutesFromFiles ( )
private

Load the defined JSON files and return the merged routes.

Returns
array

Definition at line 122 of file Router.php.

References MediaWiki\Rest\Router\$routesFromFiles.

Referenced by MediaWiki\Rest\Router\getAllRoutes().

Member Data Documentation

◆ $basicAuth

BasicAuthorizerInterface MediaWiki\Rest\Router::$basicAuth
private

Definition at line 47 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $cacheBag

BagOStuff MediaWiki\Rest\Router::$cacheBag
private

Definition at line 35 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $configHash

string null MediaWiki\Rest\Router::$configHash
private

Definition at line 41 of file Router.php.

Referenced by MediaWiki\Rest\Router\getConfigHash().

◆ $extraRoutes

array MediaWiki\Rest\Router::$extraRoutes
private

Definition at line 23 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $matchers

PathMatcher [] null MediaWiki\Rest\Router::$matchers
private

Path matchers by method.

Definition at line 38 of file Router.php.

Referenced by MediaWiki\Rest\Router\execute(), and MediaWiki\Rest\Router\getMatchers().

◆ $objectFactory

ObjectFactory MediaWiki\Rest\Router::$objectFactory
private

Definition at line 50 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $responseFactory

ResponseFactory MediaWiki\Rest\Router::$responseFactory
private

Definition at line 44 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $restValidator

Validator MediaWiki\Rest\Router::$restValidator
private

Definition at line 53 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $rootPath

string MediaWiki\Rest\Router::$rootPath
private

Definition at line 32 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $routeFiles

string [] MediaWiki\Rest\Router::$routeFiles
private

Definition at line 20 of file Router.php.

Referenced by MediaWiki\Rest\Router\__construct().

◆ $routeFileTimestamps

int [] null MediaWiki\Rest\Router::$routeFileTimestamps
private

Definition at line 29 of file Router.php.

Referenced by MediaWiki\Rest\Router\getRouteFileTimestamps().

◆ $routesFromFiles

array null MediaWiki\Rest\Router::$routesFromFiles
private

Definition at line 26 of file Router.php.

Referenced by MediaWiki\Rest\Router\getRoutesFromFiles().

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