Add support for Number grouping(commafy) based on CLDR number grouping patterns like...

[lhc/web/wiklou.git] / includes / AjaxDispatcher.php

diff --git a/includes/AjaxDispatcher.php b/includes/AjaxDispatcher.php
index a14ebdd..17b154d 100644 (file)
--- a/includes/AjaxDispatcher.php
+++ b/includes/AjaxDispatcher.php
@@ -1,91 +1,133 @@
 <?php
+/**
+ * @defgroup Ajax Ajax
+ *
+ * @file
+ * @ingroup Ajax
+ * Handle ajax requests and send them to the proper handler.
+ */
+
+/**
+ * Object-Oriented Ajax functions.
+ * @ingroup Ajax
+ */
+class AjaxDispatcher {
+       /** The way the request was made, either a 'get' or a 'post' */
+       private $mode;
 
-if( !defined( 'MEDIAWIKI' ) )
-        die( 1 );
-
-if ( ! $wgUseAjax ) {
-       die( 1 );
-}
-
-require_once( 'AjaxFunctions.php' );
+       /** Name of the requested handler */
+       private $func_name;
 
-class AjaxDispatcher {
-       var $mode;
-       var $func_name;
-       var $args;
+       /** Arguments passed */
+       private $args;
 
-       function AjaxDispatcher() {
+       /** Load up our object with user supplied data */
+       function __construct() {
                wfProfileIn( __METHOD__ );
 
                $this->mode = "";
 
-               if (! empty($_GET["rs"])) {
+               if ( ! empty( $_GET["rs"] ) ) {
                        $this->mode = "get";
                }
 
-               if (!empty($_POST["rs"])) {
+               if ( !empty( $_POST["rs"] ) ) {
                        $this->mode = "post";
                }
 
-               if ($this->mode == "get") {
-                       $this->func_name = isset( $_GET["rs"] ) ? $_GET["rs"] : '';
-                       if (! empty($_GET["rsargs"])) {
-                               $this->args = $_GET["rsargs"];
-                       } else {
-                               $this->args = array();
-                       }
-               } else {
-                       $this->func_name = isset( $_POST["rs"] ) ? $_POST["rs"] : '';
-                       if (! empty($_POST["rsargs"])) {
-                               $this->args = $_POST["rsargs"];
-                       } else {
-                               $this->args = array();
-                       }
+               switch( $this->mode ) {
+                       case 'get':
+                               $this->func_name = isset( $_GET["rs"] ) ? $_GET["rs"] : '';
+                               if ( ! empty( $_GET["rsargs"] ) ) {
+                                       $this->args = $_GET["rsargs"];
+                               } else {
+                                       $this->args = array();
+                               }
+                               break;
+                       case 'post':
+                               $this->func_name = isset( $_POST["rs"] ) ? $_POST["rs"] : '';
+                               if ( ! empty( $_POST["rsargs"] ) ) {
+                                       $this->args = $_POST["rsargs"];
+                               } else {
+                                       $this->args = array();
+                               }
+                               break;
+                       default:
+                               wfProfileOut( __METHOD__ );
+                               return;
+                               # Or we could throw an exception:
+                               # throw new MWException( __METHOD__ . ' called without any data (mode empty).' );
                }
+
                wfProfileOut( __METHOD__ );
        }
 
+       /** Pass the request to our internal function.
+        * BEWARE! Data are passed as they have been supplied by the user,
+        * they should be carefully handled in the function processing the
+        * request.
+        */
        function performAction() {
                global $wgAjaxExportList, $wgOut;
 
                if ( empty( $this->mode ) ) {
                        return;
                }
+
                wfProfileIn( __METHOD__ );
 
-               if (! in_array( $this->func_name, $wgAjaxExportList ) ) {
-                       header( 'Status: 400 Bad Request', true, 400 );
-                       print "unknown function " . htmlspecialchars( (string) $this->func_name );
+               if ( ! in_array( $this->func_name, $wgAjaxExportList ) ) {
+                       wfDebug( __METHOD__ . ' Bad Request for unknown function ' . $this->func_name . "\n" );
+
+                       wfHttpError(
+                               400,
+                               'Bad Request',
+                               "unknown function " . (string) $this->func_name
+                       );
                } else {
+                       wfDebug( __METHOD__ . ' dispatching ' . $this->func_name . "\n" );
+
+                       if ( strpos( $this->func_name, '::' ) !== false ) {
+                               $func = explode( '::', $this->func_name, 2 );
+                       } else {
+                               $func = $this->func_name;
+                       }
+
                        try {
-                               $result = call_user_func_array($this->func_name, $this->args);
+                               $result = call_user_func_array( $func, $this->args );
 
-                               if ( $result === false || $result === NULL ) {
-                                       header( 'Status: 500 Internal Error', true, 500 );
-                                       echo "{$this->func_name} returned no data";
-                               }
-                               else {
+                               if ( $result === false || $result === null ) {
+                                       wfDebug( __METHOD__ . ' ERROR while dispatching '
+                                                       . $this->func_name . "(" . var_export( $this->args, true ) . "): "
+                                                       . "no data returned\n" );
+
+                                       wfHttpError( 500, 'Internal Error',
+                                               "{$this->func_name} returned no data" );
+                               } else {
                                        if ( is_string( $result ) ) {
-                                               $result= new AjaxResponse( $result );
+                                               $result = new AjaxResponse( $result );
                                        }
 
                                        $result->sendHeaders();
                                        $result->printText();
-                               }
 
-                       } catch (Exception $e) {
-                               if (!headers_sent()) {
-                                       header( 'Status: 500 Internal Error', true, 500 );
-                                       print $e->getMessage();
+                                       wfDebug( __METHOD__ . ' dispatch complete for ' . $this->func_name . "\n" );
+                               }
+                       } catch ( Exception $e ) {
+                               wfDebug( __METHOD__ . ' ERROR while dispatching '
+                                               . $this->func_name . "(" . var_export( $this->args, true ) . "): "
+                                               . get_class( $e ) . ": " . $e->getMessage() . "\n" );
+
+                               if ( !headers_sent() ) {
+                                       wfHttpError( 500, 'Internal Error',
+                                               $e->getMessage() );
                                } else {
                                        print $e->getMessage();
                                }
                        }
                }
 
-               wfProfileOut( __METHOD__ );
                $wgOut = null;
+               wfProfileOut( __METHOD__ );
        }
 }
-
-?>