Base.php

Go to the documentation of this file.

<?php

namespace ILIAS\OrgUnit\Webservices\SOAP;

require_once('./webservice/soap/classes/class.ilSoapAdministration.php');
require_once('./Services/WebServices/SOAP/classes/class.ilSoapPluginException.php');

use ilOrgUnitSOAPServicesPlugin;
use ilSoapAdministration;
use ilSoapMethod;
use ilSoapPluginException;

abstract class Base extends ilSoapAdministration implements ilSoapMethod
{

    const TYPE_INT_ARRAY = 'tns:intArray';
    const TYPE_STRING = 'xsd:string';
    const TYPE_INT = 'xsd:int';
    const TYPE_DOUBLE_ARRAY = 'tns:doubleArray';
    const SID = 'sid';
    const ORGU_REF_ID = 'orgu_ref_id';
    const POSITION_ID = 'position_id';
    const USR_IDS = 'usr_ids';
    const USR_ID = 'usr_id';


    public function getServiceStyle()
    {
        return 'rpc';
    }


    public function getServiceUse()
    {
        return 'encoded';
    }


    protected function initIliasAndCheckSession($session_id)
    {
        $this->initAuth($session_id);
        $this->initIlias();
        if (!$this->__checkSession($session_id)) {
            throw new ilSoapPluginException($this->__getMessage());
        }
    }


    protected function checkParameters(array $params)
    {
        for ($i = 0; $i < count($this->getInputParams()); $i++) {
            if (!isset($params[$i])) {
                $names = implode(', ', array_keys($this->getInputParams()));
                throw new ilSoapPluginException("Request is missing at least one of the following parameters: $names");
            }
        }
    }


    public function getServiceNamespace()
    {
        return 'urn:' . ilOrgUnitSOAPServicesPlugin::PLUGIN_NAME;
    }


    abstract protected function getAdditionalInputParams();


    final public function getInputParams()
    {
        return array_merge(
            array(
                self::SID => self::TYPE_STRING,
            ),
            $this->getAdditionalInputParams()
        );
    }


    abstract protected function run(array $params);


    public function execute(array $params)
    {
        $this->checkParameters($params);
        $session_id = (isset($params[0])) ? $params[0] : '';
        $this->init($session_id);

        // Check Permissions
        global $DIC;
        if (!$DIC->access()->checkAccess('write', '', \ilObjOrgUnit::getRootOrgRefId())) {
            $this->error('Permission denied');
        }

        $clean_params = array();
        $i = 1;
        foreach ($this->getAdditionalInputParams() as $key => $type) {
            $clean_params[$key] = $params[$i];
            $i++;
        }

        return $this->run($clean_params);
    }


    protected function error($message)
    {
        throw $this->__raiseError($message, 'ERROR');
    }


    private function init($session_id)
    {
        $this->initIliasAndCheckSession($session_id); // Throws exception if session is not valid
    }
}