Core REST API endpoint that handles page updates (main slot only) More...
Inherits MediaWiki\Rest\Handler\EditHandler.
Public Member Functions | ||||
| getBodyValidator ( $contentType) | ||||
Fetch the BodyValidator.
| ||||
| getParamSettings () | ||||
Fetch ParamValidator settings for parameters.Every setting must include self::PARAM_SOURCE to specify which part of the request is to contain the parameter.Can be used for validating parameters inside an application/x-www-form-urlencoded or multipart/form-data POST body (i.e. parameters which would be present in PHP's $_POST array). For validating other kinds of request bodies, override getBodyValidator().
| ||||
| setJsonDiffFunction (callable $jsonDiffFunction) | ||||
| Sets the function to use for JSON diffs, for testing. | ||||
 Public Member Functions inherited from MediaWiki\Rest\Handler\EditHandler | ||||
| __construct (Config $config, IContentHandlerFactory $contentHandlerFactory, TitleParser $titleParser, TitleFormatter $titleFormatter, RevisionLookup $revisionLookup) | ||||
| needsWriteAccess () | ||||
| Indicates whether this route requires write access. | ||||
| Public Member Functions inherited from MediaWiki\Rest\Handler\ActionModuleBasedHandler | ||||
| execute () | ||||
| Main execution method, implemented to delegate execution to ApiMain. | ||||
| getApiMain () | ||||
| overrideActionModule (string $name, string $group, ApiBase $module) | ||||
| Overrides an action API module. | ||||
| setApiMain (ApiMain $apiMain) | ||||
| Set main action API entry point for testing. | ||||
| Public Member Functions inherited from MediaWiki\Rest\Handler | ||||
| applyCacheControl (ResponseInterface $response) | ||||
| Apply cache control to enforce privacy. | ||||
| applyConditionalResponseHeaders (ResponseInterface $response) | ||||
| Apply verifier headers to the response, per RFC 7231 ยง7.2. | ||||
| checkPreconditions () | ||||
| Check the conditional request headers and generate a response if appropriate. | ||||
| checkSession () | ||||
| Check the session (and session provider) | ||||
| getAuthority () | ||||
| Get the current acting authority. | ||||
| getConfig () | ||||
| Get the configuration array for the current route. | ||||
| getPath () | ||||
| Returns the path this handler is bound to, including path variables. | ||||
| getRequest () | ||||
| Get the current request. | ||||
| getResponseFactory () | ||||
| Get the ResponseFactory which can be used to generate Response objects. | ||||
| getSession () | ||||
| Get the Session. | ||||
| getValidatedBody () | ||||
| Fetch the validated body. | ||||
| getValidatedParams () | ||||
| Fetch the validated parameters. | ||||
| init (Router $router, RequestInterface $request, array $config, Authority $authority, ResponseFactory $responseFactory, HookContainer $hookContainer, Session $session) | ||||
| Initialise with dependencies from the Router. | ||||
| needsReadAccess () | ||||
| Indicates whether this route requires read rights. | ||||
| requireSafeAgainstCsrf () | ||||
| Indicates whether this route can be accessed only by session providers safe vs csrf. | ||||
| validate (Validator $restValidator) | ||||
| Validate the request parameters/attributes and body. | ||||
Protected Member Functions | |||||||||
| getActionModuleParameters () | |||||||||
Maps a REST API request to an action API request.Implementations typically use information returned by $this->getValidatedBody() and $this->getValidatedParams() to construct the return value.The return value of this method controls which action module is called by execute().
| |||||||||
| getTitleParameter () | |||||||||
Returns the requested title.
| |||||||||
| mapActionModuleResult (array $data) | |||||||||
Maps an action API result to a REST API result.
| |||||||||
| throwHttpExceptionForActionModuleError (IApiMessage $msg, $statusCode=400) | |||||||||
Throws a HttpException for a given IApiMessage that represents an error.Never returns normally.Subclasses may override this to provide mappings for specific error codes, typically based on $msg->getApiCode(). Subclasses overriding this method must always either throw an exception, or call this method in the parent class, which then throws an exception.
| |||||||||
| Protected Member Functions inherited from MediaWiki\Rest\Handler\EditHandler | |||||||||
| mapActionModuleResponse (WebResponse $actionModuleResponse, array $actionModuleResult, Response $response) | |||||||||
| Transfers relevant information, such as header values, from the WebResponse constructed by the action API call to a REST Response object. | |||||||||
| Protected Member Functions inherited from MediaWiki\Rest\Handler\ActionModuleBasedHandler | |||||||||
| getUser () | |||||||||
| makeMessageValue (IApiMessage $msg) | |||||||||
| Constructs a MessageValue from an IApiMessage. | |||||||||
| Protected Member Functions inherited from MediaWiki\Rest\Handler | |||||||||
| getConditionalHeaderUtil () | |||||||||
| Get a ConditionalHeaderUtil object. | |||||||||
| getETag () | |||||||||
| The subclass should override this to provide an ETag for the current state of the requested resource. | |||||||||
| getHookContainer () | |||||||||
| Get a HookContainer, for running extension hooks or for hook metadata. | |||||||||
| getHookRunner () | |||||||||
| Get a HookRunner for running core hooks. | |||||||||
| getLastModified () | |||||||||
| The subclass should override this to provide the maximum last modified timestamp of the requested resource. | |||||||||
| getRouter () | |||||||||
| Get the Router. | |||||||||
| getRouteUrl ( $pathParams=[], $queryParams=[]) | |||||||||
| Get the URL of this handler's endpoint. | |||||||||
| hasRepresentation () | |||||||||
| The subclass should override this to indicate whether the resource exists. | |||||||||
| postInitSetup () | |||||||||
| The handler can override this to do any necessary setup after init() is called to inject the dependencies. | |||||||||
| postValidationSetup () | |||||||||
| The handler can override this to do any necessary setup after validate() has been called. | |||||||||
| urlEncodeTitle ( $title) | |||||||||
| URL-encode titles in a "pretty" way. | |||||||||
Additional Inherited Members | |
| Public Attributes inherited from MediaWiki\Rest\Handler | |
| const | PARAM_SOURCE = 'rest-param-source' |
| (string) ParamValidator constant to specify the source of the parameter. | |
| Protected Attributes inherited from MediaWiki\Rest\Handler\EditHandler | |
| Config | $config |
| IContentHandlerFactory | $contentHandlerFactory |
| RevisionLookup | $revisionLookup |
| TitleFormatter | $titleFormatter |
| TitleParser | $titleParser |
Detailed Description
Core REST API endpoint that handles page updates (main slot only)
Definition at line 20 of file UpdateHandler.php.
Member Function Documentation
◆ getActionModuleParameters()
|
protected |
Maps a REST API request to an action API request.Implementations typically use information returned by $this->getValidatedBody() and $this->getValidatedParams() to construct the return value.The return value of this method controls which action module is called by execute().
- Returns
- array Emulated request parameters to be passed to the ApiModule.
Reimplemented from MediaWiki\Rest\Handler\ActionModuleBasedHandler.
Definition at line 94 of file UpdateHandler.php.
References MediaWiki\Rest\Handler\UpdateHandler\getTitleParameter(), MediaWiki\Rest\getToken(), MediaWiki\Rest\Handler\ActionModuleBasedHandler\getUser(), and MediaWiki\Rest\Handler\getValidatedBody().
◆ getBodyValidator()
| MediaWiki\Rest\Handler\UpdateHandler::getBodyValidator | ( | $contentType | ) |
Fetch the BodyValidator.
- Stability: stable
- to override
- Parameters
-
string $contentType Content type of the request.
- Returns
- BodyValidator
Reimplemented from MediaWiki\Rest\Handler.
Definition at line 59 of file UpdateHandler.php.
References MediaWiki\Rest\getTokenParamDefinition().
◆ getParamSettings()
| MediaWiki\Rest\Handler\UpdateHandler::getParamSettings | ( | ) |
Fetch ParamValidator settings for parameters.Every setting must include self::PARAM_SOURCE to specify which part of the request is to contain the parameter.Can be used for validating parameters inside an application/x-www-form-urlencoded or multipart/form-data POST body (i.e. parameters which would be present in PHP's $_POST array). For validating other kinds of request bodies, override getBodyValidator().
- Stability: stable
- to override
- Returns
- array[] Associative array mapping parameter names to ParamValidator settings arrays
Reimplemented from MediaWiki\Rest\Handler.
Definition at line 46 of file UpdateHandler.php.
◆ getTitleParameter()
|
protected |
Returns the requested title.
- Returns
- string
Reimplemented from MediaWiki\Rest\Handler\EditHandler.
Definition at line 30 of file UpdateHandler.php.
References MediaWiki\Rest\Handler\getValidatedParams().
Referenced by MediaWiki\Rest\Handler\UpdateHandler\getActionModuleParameters(), and MediaWiki\Rest\Handler\UpdateHandler\throwHttpExceptionForActionModuleError().
◆ mapActionModuleResult()
|
protected |
Maps an action API result to a REST API result.
- Parameters
-
array $data Data structure retrieved from the ApiResult returned by the ApiModule
- Returns
- mixed Data structure to be converted to JSON and wrapped in a REST Response. Will be processed by ResponseFactory::createFromReturnValue().
Reimplemented from MediaWiki\Rest\Handler\EditHandler.
Definition at line 135 of file UpdateHandler.php.
References MediaWiki\Rest\Handler\getValidatedParams().
◆ setJsonDiffFunction()
| MediaWiki\Rest\Handler\UpdateHandler::setJsonDiffFunction | ( | callable | $jsonDiffFunction | ) |
Sets the function to use for JSON diffs, for testing.
- Parameters
-
callable $jsonDiffFunction
Definition at line 39 of file UpdateHandler.php.
◆ throwHttpExceptionForActionModuleError()
|
protected |
Throws a HttpException for a given IApiMessage that represents an error.Never returns normally.Subclasses may override this to provide mappings for specific error codes, typically based on $msg->getApiCode(). Subclasses overriding this method must always either throw an exception, or call this method in the parent class, which then throws an exception.
- Stability: stable
- to override
- Parameters
-
IApiMessage $msg A message object representing an error in an action module, typically from calling getStatusValue()->getErrorsByType( 'error' ) on an ApiUsageException. int $statusCode The HTTP status indicated by the original exception
- Exceptions
-
HttpException always.
Reimplemented from MediaWiki\Rest\Handler\EditHandler.
Definition at line 154 of file UpdateHandler.php.
References IApiMessage\getApiCode(), MediaWiki\Rest\Handler\UpdateHandler\getTitleParameter(), and MediaWiki\Rest\Handler\ActionModuleBasedHandler\makeMessageValue().
The documentation for this class was generated from the following file:
- includes/Rest/Handler/UpdateHandler.php
