2020-08-20 23:49:14 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace MediaWiki\Rest;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* This is an exception class that wraps a Response and extends
|
|
|
|
|
* HttpException. It is used when a particular response type
|
|
|
|
|
* (whatever the HTTP status code) is treated as an exceptional output
|
|
|
|
|
* in your API, and you want to be able to throw it from wherever you
|
|
|
|
|
* are and immediately halt request processing. It can also be used
|
|
|
|
|
* to customize the standard 3xx or 4xx error Responses returned by
|
|
|
|
|
* the standard HttpException, for example to add custom headers.
|
|
|
|
|
*
|
|
|
|
|
* @newable
|
|
|
|
|
* @since 1.36
|
|
|
|
|
*/
|
|
|
|
|
class ResponseException extends HttpException {
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* The wrapped Response.
|
2023-10-30 16:04:41 +00:00
|
|
|
* @var ResponseInterface
|
2020-08-20 23:49:14 +00:00
|
|
|
*/
|
|
|
|
|
private $response;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @stable to call
|
|
|
|
|
*
|
2023-10-30 16:04:41 +00:00
|
|
|
* @param ResponseInterface $response The wrapped Response
|
2020-08-20 23:49:14 +00:00
|
|
|
*/
|
2023-10-30 16:04:41 +00:00
|
|
|
public function __construct( ResponseInterface $response ) {
|
2020-08-20 23:49:14 +00:00
|
|
|
parent::__construct( 'Response', $response->getStatusCode() );
|
|
|
|
|
$this->response = $response;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @return Response
|
|
|
|
|
*/
|
|
|
|
|
public function getResponse(): Response {
|
2023-10-30 16:04:41 +00:00
|
|
|
// TODO: Allow this method to return a ResponseInterface.
|
|
|
|
|
// But that would be a breaking change.
|
|
|
|
|
return Response::cast( $this->response );
|
2020-08-20 23:49:14 +00:00
|
|
|
}
|
|
|
|
|
}
|