0 follower

CWebService

Package system.web.services
Inheritance class CWebService » CComponent
Since 1.0
Version $Id$
Source Code framework/web/services/CWebService.php
CWebService encapsulates SoapServer and provides a WSDL-based web service.

PHP SOAP extension is required.

CWebService makes use of CWsdlGenerator and can generate the WSDL on-the-fly without requiring you to write complex WSDL.

To generate the WSDL based on doc comment blocks in the service provider class, call generateWsdl or renderWsdl. To process the web service requests, call run.

Public Properties

Hide inherited properties

PropertyTypeDescriptionDefined By
actor string actor of the SOAP service. CWebService
cacheID string the ID of the cache application component that is used to cache the generated WSDL. CWebService
classMap array a list of classes that are declared as complex types in WSDL. CWebService
encoding string encoding of the Web service. CWebService
methodName string the currently requested method name. CWebService
persistence integer the persistence mode of the SOAP server. CWebService
provider string|object the web service provider class or object. CWebService
serviceUrl string the URL for the Web service. CWebService
soapVersion string SOAP version (e.g. '1. CWebService
wsdlCacheDuration integer number of seconds that the generated WSDL can remain valid in cache. CWebService
wsdlUrl string the URL for WSDL. CWebService

Protected Properties

Hide inherited properties

PropertyTypeDescriptionDefined By
options array options for creating SoapServer instance CWebService

Public Methods

Hide inherited methods

MethodDescriptionDefined By
__call() Calls the named method which is not a class method. CComponent
__construct() Constructor. CWebService
__get() Returns a property value, an event handler list or a behavior based on its name. CComponent
__isset() Checks if a property value is null. CComponent
__set() Sets value of a component property. CComponent
__unset() Sets a component property to be null. CComponent
asa() Returns the named behavior object. CComponent
attachBehavior() Attaches a behavior to this component. CComponent
attachBehaviors() Attaches a list of behaviors to the component. CComponent
attachEventHandler() Attaches an event handler to an event. CComponent
canGetProperty() Determines whether a property can be read. CComponent
canSetProperty() Determines whether a property can be set. CComponent
detachBehavior() Detaches a behavior from the component. CComponent
detachBehaviors() Detaches all behaviors from the component. CComponent
detachEventHandler() Detaches an existing event handler. CComponent
disableBehavior() Disables an attached behavior. CComponent
disableBehaviors() Disables all behaviors attached to this component. CComponent
enableBehavior() Enables an attached behavior. CComponent
enableBehaviors() Enables all behaviors attached to this component. CComponent
generateWsdl() Generates the WSDL as defined by the provider. CWebService
getEventHandlers() Returns the list of attached event handlers for an event. CComponent
getMethodName() Returns the currently requested method name. Empty if no method is being requested. CWebService
handleError() The PHP error handler. CWebService
hasEvent() Determines whether an event is defined. CComponent
hasEventHandler() Checks whether the named event has attached handlers. CComponent
hasProperty() Determines whether a property is defined. CComponent
raiseEvent() Raises an event. CComponent
renderWsdl() Generates and displays the WSDL as defined by the provider. CWebService
run() Handles the web service request. CWebService

Protected Methods

Hide inherited methods

MethodDescriptionDefined By
getOptions() Returns options for creating SoapServer instance CWebService

Property Details

actor property
public string $actor;

actor of the SOAP service. Defaults to null, meaning not set.

cacheID property (available since v1.0.10)
public string $cacheID;

the ID of the cache application component that is used to cache the generated WSDL. Defaults to 'cache' which refers to the primary cache application component. Set this property to false if you want to disable caching WSDL.

classMap property
public array $classMap;

a list of classes that are declared as complex types in WSDL. This should be an array with WSDL types as keys and names of PHP classes as values. A PHP class can also be specified as a path alias.

See Also

encoding property
public string $encoding;

encoding of the Web service. Defaults to 'UTF-8'.

methodName property read-only
public string getMethodName()

the currently requested method name. Empty if no method is being requested.

options property read-only
protected array getOptions()

options for creating SoapServer instance

See Also

persistence property
public integer $persistence;

the persistence mode of the SOAP server.

See Also

provider property
public string|object $provider;

the web service provider class or object. If specified as a class name, it can be a path alias.

serviceUrl property
public string $serviceUrl;

the URL for the Web service. This is required by generateWsdl() and renderWsdl().

soapVersion property
public string $soapVersion;

SOAP version (e.g. '1.1' or '1.2'). Defaults to null, meaning not set.

wsdlCacheDuration property
public integer $wsdlCacheDuration;

number of seconds that the generated WSDL can remain valid in cache. Defaults to 0, meaning no caching.

wsdlUrl property
public string $wsdlUrl;

the URL for WSDL. This is required by run().

Method Details

__construct() method
public void __construct(mixed $provider, string $wsdlUrl, string $serviceUrl)
$provider mixed the web service provider class name or object
$wsdlUrl string the URL for WSDL. This is required by run().
$serviceUrl string the URL for the Web service. This is required by generateWsdl() and renderWsdl().
Source Code: framework/web/services/CWebService.php#89 (show)
public function __construct($provider,$wsdlUrl,$serviceUrl)
{
    $this->provider=$provider;
    $this->wsdlUrl=$wsdlUrl;
    $this->serviceUrl=$serviceUrl;
}

Constructor.

generateWsdl() method
public string generateWsdl()
{return} string the generated WSDL
Source Code: framework/web/services/CWebService.php#131 (show)
public function generateWsdl()
{
    $providerClass=is_object($this->provider) ? get_class($this->provider) : Yii::import($this->provider,true);
    if($this->wsdlCacheDuration>0 && $this->cacheID!==false && ($cache=Yii::app()->getComponent($this->cacheID))!==null)
    {
        $key='Yii.CWebService.'.$providerClass.$this->serviceUrl.$this->encoding;
        if(($wsdl=$cache->get($key))!==false)
            return $wsdl;
    }
    $generator=new CWsdlGenerator;
    $wsdl=$generator->generateWsdl($providerClass,$this->serviceUrl,$this->encoding);
    if(isset($key))
        $cache->set($key,$wsdl,$this->wsdlCacheDuration);
    return $wsdl;
}

Generates the WSDL as defined by the provider. The cached version may be used if the WSDL is found valid in cache.

See Also

getMethodName() method
public string getMethodName()
{return} string the currently requested method name. Empty if no method is being requested.
Source Code: framework/web/services/CWebService.php#202 (show)
public function getMethodName()
{
    if($this->_method===null)
    {
        if(isset($HTTP_RAW_POST_DATA))
            $request=$HTTP_RAW_POST_DATA;
        else
            $request=file_get_contents('php://input');
        if(preg_match('/<.*?:Body[^>]*>\s*<.*?:(\w+)/mi',$request,$matches))
            $this->_method=$matches[1];
        else
            $this->_method='';
    }
    return $this->_method;
}

getOptions() method
protected array getOptions()
{return} array options for creating SoapServer instance
Source Code: framework/web/services/CWebService.php#222 (show)
protected function getOptions()
{
    $options=array();
    if($this->soapVersion==='1.1')
        $options['soap_version']=SOAP_1_1;
    else if($this->soapVersion==='1.2')
        $options['soap_version']=SOAP_1_2;
    if($this->actor!==null)
        $options['actor']=$this->actor;
    $options['encoding']=$this->encoding;
    foreach($this->classMap as $type=>$className)
    {
        $className=Yii::import($className,true);
        if(is_int($type))
            $type=$className;
        $options['classmap'][$type]=$className;
    }
    return $options;
}

See Also

handleError() method
public void handleError(CErrorEvent $event)
$event CErrorEvent the PHP error event
Source Code: framework/web/services/CWebService.php#100 (show)
public function handleError($event)
{
    $event->handled=true;
    $message=$event->message;
    if(YII_DEBUG)
    {
        $trace=debug_backtrace();
        if(isset($trace[2]) && isset($trace[2]['file']) && isset($trace[2]['line']))
            $message.=' ('.$trace[2]['file'].':'.$trace[2]['line'].')';
    }
    throw new CException($message,self::SOAP_ERROR);
}

The PHP error handler.

renderWsdl() method
public void renderWsdl()
Source Code: framework/web/services/CWebService.php#117 (show)
public function renderWsdl()
{
    $wsdl=$this->generateWsdl();
    header('Content-Type: text/xml;charset='.$this->encoding);
    header('Content-Length: '.strlen($wsdl));
    echo $wsdl;
}

Generates and displays the WSDL as defined by the provider.

See Also

run() method
public void run()
Source Code: framework/web/services/CWebService.php#150 (show)
public function run()
{
    header('Content-Type: text/xml;charset='.$this->encoding);
    if(YII_DEBUG)
        ini_set("soap.wsdl_cache_enabled",0);
    $server=new SoapServer($this->wsdlUrl,$this->getOptions());
    Yii::app()->attachEventHandler('onError',array($this,'handleError'));
    try
    {
        if($this->persistence!==null)
            $server->setPersistence($this->persistence);
        if(is_string($this->provider))
            $provider=Yii::createComponent($this->provider);
        else
            $provider=$this->provider;

        if(method_exists($server,'setObject'))
            $server->setObject($provider);
        else
            $server->setClass('CSoapObjectWrapper',$provider);

        if($provider instanceof IWebServiceProvider)
        {
            if($provider->beforeWebMethod($this))
            {
                $server->handle();
                $provider->afterWebMethod($this);
            }
        }
        else
            $server->handle();
    }
    catch(Exception $e)
    {
        if($e->getCode()===self::SOAP_ERROR) // a PHP error
            $message=$e->getMessage();
        else
        {
            $message=$e->getMessage().' ('.$e->getFile().':'.$e->getLine().')';
            // only log for non-PHP-error case because application's error handler already logs it
            // php <5.2 doesn't support string conversion auto-magically
            Yii::log($e->__toString(),CLogger::LEVEL_ERROR,'application');
        }
        if(YII_DEBUG)
            $message.="\n".$e->getTraceAsString();
        $server->fault(get_class($e),$message);
    }
}

Handles the web service request.