<?php
 
/**
 * Interface ilSoapMethod
 *
 * Describes a soap method which can be added to the ILIAS SOAP webservice
 * by a plugin of the SoapHook plugin slot
 */
interface ilSoapMethod {
 
	/**
	 * Get the name of the method. Used as endpoint for SOAP requests.
	 * Note that this name must be unique in combination with the service namespace.
	 *
	 * @return string
	 */
	public function getName();
 
	/**
	 * Get the input parameters. Array keys must correspond to parameter names and values must correspond
	 * to a valid SOAP data-type
	 *
	 * @see ilNusoapUserAdministrationAdapter::__registerMethods() for examples
	 *
	 * @return array
	 */
	public function getInputParams();
 
	/**
	 * Get the output parameters in the same format as the input parameters
	 *
	 * @return array
	 */
	public function getOutputParams();
 
	/**
	 * Get the namespace of the service where this method belongs to
	 *
	 * @return string
	 */
	public function getServiceNamespace();
 
	/**
	 * Get the service style, e.g. 'rpc'
	 *
	 * @return string
	 */
	public function getServiceStyle();
 
	/**
	 * Get the service use, e.g. 'encoded'
	 *
	 * @return string
	 */
	public function getServiceUse();
 
	/**
	 * Get the documentation of this method
	 *
	 * @return string
	 */
	public function getDocumentation();
 
	/**
	 * Execute the business logic for this SOAP method (when a SOAP request hits the endpoint defined by the name).
	 * Note: This Method must return the data in the format specified by getOutputParams().
	 *
	 * @param array $params Key/Value pair of parameters defined by getInputParams()
	 * @return mixed
	 */
	public function execute(array $params);
 
}

<?php
/**
 * Interface ilWsdlType
 */
interface ilWsdlType {
 
	/**
	 * @return string
	 */
	public function getName();
 
	/**
	 * @return string
	 */
	public function getTypeClass();
 
	/**
	 * @return string
	 */
	public function getPhpType();
 
	/**
	 * @return string
	 */
	public function getCompositor();
 
	/**
	 * @return string
	 */
	public function getRestrictionBase();
 
	/**
	 * @return array
	 */
	public function getElements();
 
	/**
	 * @return array
	 */
	public function getAttributes();
 
	/**
	 * @return string
	 */
	public function getArrayType();
}

<?php
require_once('./Services/WebServices/SOAP/classes/class.ilAbstractSoapMethod.php');
 
/**
 * Class SampleSoapMethod
 * 
 * Returns the title of an object from a given Ref-ID
 */
class SampleSoapMethod extends ilAbstractSoapMethod {
 
	/**
	 * @inheritdoc
	 */
	public function getName() {
		return 'getObjectTitleByRefId';
	}
 
	/**
	 * @inheritdoc
	 */
	public function getInputParams() {
		return array(
			'sid' => 'xsd:string',
                        'ref_id' => 'xsd:int',
		);
	}
 
	/**
	 * @inheritdoc
	 */
	public function getOutputParams() {
		return array(
			'title' => 'xsd:string',
		);
	}
 
	/**
	 * @inheritdoc
	 */
	public function getServiceNamespace() {
		return 'urn:sample';
	}
 
	/**
	 * @inheritdoc
	 */
	public function getServiceStyle() {
		return 'rpc';
	}
 
	/**
	 * @inheritdoc
	 */
	public function getServiceUse() {
		return 'encoded';
	}
 
	/**
	 * @inheritdoc
	 */
	public function getDocumentation() {
		return "Returns the title of an object by the given Ref-ID - just for demo purposes!";
	}
 
	/**
	 * @inheritdoc
	 */
	public function execute(array $params) {
		$session_id = (isset($params[0])) ? $params[0] : '';
		$ref_id = (isset($params[1])) ? (int) $params[1] : 0;
		$this->initIliasAndCheckSession($session_id); // Throws exception if session is not valid
                if (!$ref_id) {
                    throw new ilSoapPluginException("Ref-Id $ref_id is not provided");
                }
                $obj_id = ilObject::_lookupObjId($ref_id);
                if (!$obj_id) {
                    throw new ilSoapPluginException("Could not load object");
                }
                return ilObject::_lookupTitle($obj_id);
	}
}