MediaWiki master
ApiUsageException Class Reference

Exception used to abort API execution with an error. More...

Inherits MWException, and ILocalizedException.

Collaboration diagram for ApiUsageException:

Public Member Functions

 __construct (?ApiBase $module, StatusValue $status, $httpCode=0, Throwable $previous=null)
 
 __toString ()
 
 getMessageObject ()
 Return a Message object for this exception.
Returns
Message

 
 getModulePath ()
 Fetch the responsible module name.
 
 getStatusValue ()
 Fetch the error status.
 
- Public Member Functions inherited from MWException
 getHTML ()
 Format an HTML message for the current exception object.
 
 getPageTitle ()
 Return the title of the page when reporting this error in a HTTP response.
 
 getText ()
 Format plain text message for the current exception object.
 
 hasOverriddenHandler ()
 
 isLoggable ()
 Whether to log this exception in the exception debug log.
 
 msg ( $key, $fallback,... $params)
 Get a message from i18n.
 
 report ()
 Output a report about the exception and takes care of formatting.
 
 reportHTML ()
 Output the exception report using HTML.
 
 useMessageCache ()
 Can the extension use the Message class/wfMessage to get i18n-ed messages?
 

Static Public Member Functions

static newWithMessage (?ApiBase $module, $msg, $code=null, $data=null, $httpCode=0, Throwable $previous=null)
 
- Static Public Member Functions inherited from MWException
static isCommandLine ()
 Check whether we are in command line mode or not to report the exception in the correct format.
 

Protected Attributes

 $modulePath
 
 $status
 

Detailed Description

Exception used to abort API execution with an error.

If possible, use ApiBase::dieWithError() instead of throwing this directly.

Stability: newable

Definition at line 31 of file ApiUsageException.php.

Constructor & Destructor Documentation

◆ __construct()

ApiUsageException::__construct ( ?ApiBase  $module,
StatusValue  $status,
  $httpCode = 0,
Throwable  $previous = null 
)
Stability: stable
to call
Parameters
ApiBase | null$moduleAPI module responsible for the error, if known
StatusValue$statusStatus holding errors
int$httpCodeHTTP error code to use
Throwable | null$previousPrevious exception

Definition at line 44 of file ApiUsageException.php.

References ApiBase\getModulePath(), StatusValue\isOK(), and ApiErrorFormatter\stripMarkup().

Member Function Documentation

◆ __toString()

ApiUsageException::__toString ( )
Returns
string

Definition at line 123 of file ApiUsageException.php.

References ApiErrorFormatter\stripMarkup().

◆ getMessageObject()

ApiUsageException::getMessageObject ( )

Return a Message object for this exception.

Returns
Message

Implements ILocalizedException.

Definition at line 116 of file ApiUsageException.php.

◆ getModulePath()

ApiUsageException::getModulePath ( )

Fetch the responsible module name.

Returns
string|null

Definition at line 101 of file ApiUsageException.php.

Referenced by ApiMain\substituteResultWithError().

◆ getStatusValue()

ApiUsageException::getStatusValue ( )

◆ newWithMessage()

static ApiUsageException::newWithMessage ( ?ApiBase  $module,
  $msg,
  $code = null,
  $data = null,
  $httpCode = 0,
Throwable  $previous = null 
)
static
Parameters
ApiBase | null$moduleAPI module responsible for the error, if known
string | array | Message$msgSee ApiMessage::create()
string | null$codeSee ApiMessage::create()
array | null$dataSee ApiMessage::create()
int$httpCodeHTTP error code to use
Throwable | null$previousPrevious exception
Returns
static

Definition at line 70 of file ApiUsageException.php.

Member Data Documentation

◆ $modulePath

ApiUsageException::$modulePath
protected

Definition at line 33 of file ApiUsageException.php.

◆ $status

ApiUsageException::$status
protected

Definition at line 34 of file ApiUsageException.php.


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