ExtDirectApi.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\ExtDirect;

class ExtDirectApi {

    protected $settings = array();

    public function __construct() {
        if (isset($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ExtDirect']) && is_array($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ExtDirect'])) {
            $this->settings = $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ExtDirect'];
        }
    }

    public function getAPI($ajaxParams, \TYPO3\CMS\Core\Http\AjaxRequestHandler $ajaxObj) {
        $ajaxObj->setContent(array());
    }

    public function getApiPhp(array $filterNamespaces) {
        $javascriptNamespaces = $this->getExtDirectApi($filterNamespaces);
        // Return the generated javascript API configuration
        if (count($javascriptNamespaces)) {
            return '
                if (!Ext.isObject(Ext.app.ExtDirectAPI)) {
                    Ext.app.ExtDirectAPI = {};
                }
                Ext.apply(Ext.app.ExtDirectAPI, ' . json_encode($javascriptNamespaces) . ');
            ';
        } else {
            $errorMessage = $this->getNamespaceError($filterNamespaces);
            throw new \InvalidArgumentException($errorMessage, 1297645190);
        }
    }

    protected function generateAPI(array $filterNamespaces) {
        $javascriptNamespaces = array();
        if (is_array($this->settings)) {
            foreach ($this->settings as $javascriptName => $configuration) {
                $splittedJavascriptName = explode('.', $javascriptName);
                $javascriptObjectName = array_pop($splittedJavascriptName);
                $javascriptNamespace = implode('.', $splittedJavascriptName);
                // Only items inside the wanted namespace
                if (!$this->findNamespace($javascriptNamespace, $filterNamespaces)) {
                    continue;
                }
                if (!isset($javascriptNamespaces[$javascriptNamespace])) {
                    $javascriptNamespaces[$javascriptNamespace] = array(
                        'url' => $this->getRoutingUrl($javascriptNamespace),
                        'type' => 'remoting',
                        'actions' => array(),
                        'namespace' => $javascriptNamespace
                    );
                }
                if (is_array($configuration)) {
                    $className = $configuration['callbackClass'];
                    $serverObject = \TYPO3\CMS\Core\Utility\GeneralUtility::getUserObj($className, FALSE);
                    $javascriptNamespaces[$javascriptNamespace]['actions'][$javascriptObjectName] = array();
                    foreach (get_class_methods($serverObject) as $methodName) {
                        $reflectionMethod = new \ReflectionMethod($serverObject, $methodName);
                        $numberOfParameters = $reflectionMethod->getNumberOfParameters();
                        $docHeader = $reflectionMethod->getDocComment();
                        $formHandler = strpos($docHeader, '@formHandler') !== FALSE;
                        $javascriptNamespaces[$javascriptNamespace]['actions'][$javascriptObjectName][] = array(
                            'name' => $methodName,
                            'len' => $numberOfParameters,
                            'formHandler' => $formHandler
                        );
                    }
                }
            }
        }
        return $javascriptNamespaces;
    }

    public function getRoutingUrl($namespace) {
        $url = '';
        if (TYPO3_MODE === 'FE') {
            $url = \TYPO3\CMS\Core\Utility\GeneralUtility::locationHeaderUrl('?eID=ExtDirect&action=route&namespace=');
        } else {
            $url = \TYPO3\CMS\Core\Utility\GeneralUtility::locationHeaderUrl(\TYPO3\CMS\Core\Utility\GeneralUtility::getIndpEnv('TYPO3_SITE_URL') . TYPO3_mainDir . 'ajax.php?ajaxID=ExtDirect::route&namespace=');
        }
        $url .= rawurlencode($namespace);
        return $url;
    }

    protected function getExtDirectApi(array $filterNamespaces) {
        $noCache = \TYPO3\CMS\Core\Utility\GeneralUtility::_GET('no_cache') ? TRUE : FALSE;
        // Look up into the cache
        $cacheIdentifier = 'ExtDirectApi';
        $cacheHash = md5($cacheIdentifier . implode(',', $filterNamespaces) . \TYPO3\CMS\Core\Utility\GeneralUtility::getIndpEnv('TYPO3_SSL') . serialize($this->settings) . TYPO3_MODE . \TYPO3\CMS\Core\Utility\GeneralUtility::getIndpEnv('HTTP_HOST'));
        // With no_cache always generate the javascript content
        // Generate the javascript content if it wasn't found inside the cache and cache it!
        if ($noCache || !is_array(($javascriptNamespaces = \TYPO3\CMS\Frontend\Page\PageRepository::getHash($cacheHash)))) {
            $javascriptNamespaces = $this->generateAPI($filterNamespaces);
            if (count($javascriptNamespaces)) {
                \TYPO3\CMS\Frontend\Page\PageRepository::storeHash($cacheHash, $javascriptNamespaces, $cacheIdentifier);
            }
        }
        return $javascriptNamespaces;
    }

    protected function getNamespaceError(array $filterNamespaces) {
        if (count($filterNamespaces)) {
            // Namespace error
            $errorMessage = sprintf($GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.xlf:ExtDirect.namespaceError'), __CLASS__, implode(',', $filterNamespaces));
        } else {
            // No namespace given
            $errorMessage = sprintf($GLOBALS['LANG']->sL('LLL:EXT:lang/locallang_core.xlf:ExtDirect.noNamespace'), __CLASS__);
        }
        return $errorMessage;
    }

    protected function findNamespace($namespace, array $filterNamespaces) {
        if ($filterNamespaces === array('TYPO3')) {
            return TRUE;
        }
        $found = FALSE;
        foreach ($filterNamespaces as $filter) {
            if (\TYPO3\CMS\Core\Utility\GeneralUtility::isFirstPartOfStr($filter, $namespace)) {
                $found = TRUE;
                break;
            }
        }
        return $found;
    }

}