Package | system.web.services |
---|---|
Inheritance | class CWebService » CComponent |
Since | 1.0 |
Version | $Id$ |
Source Code | framework/web/services/CWebService.php |
Property | Type | Description | Defined 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 |
Property | Type | Description | Defined By |
---|---|---|---|
options | array | options for creating SoapServer instance | CWebService |
Method | Description | Defined 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 |
Method | Description | Defined By |
---|---|---|
getOptions() | Returns options for creating SoapServer instance | CWebService |
actor of the SOAP service. Defaults to null, meaning not set.
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.
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.
encoding of the Web service. Defaults to 'UTF-8'.
the currently requested method name. Empty if no method is being requested.
options for creating SoapServer instance
the persistence mode of the SOAP server.
the web service provider class or object. If specified as a class name, it can be a path alias.
the URL for the Web service. This is required by generateWsdl() and renderWsdl().
SOAP version (e.g. '1.1' or '1.2'). Defaults to null, meaning not set.
number of seconds that the generated WSDL can remain valid in cache. Defaults to 0, meaning no caching.
the URL for WSDL. This is required by run().
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(). |
public function __construct($provider,$wsdlUrl,$serviceUrl)
{
$this->provider=$provider;
$this->wsdlUrl=$wsdlUrl;
$this->serviceUrl=$serviceUrl;
}
Constructor.
public string generateWsdl()
| ||
{return} | string | the generated WSDL |
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.
public string getMethodName()
| ||
{return} | string | the currently requested method name. Empty if no method is being requested. |
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;
}
protected array getOptions()
| ||
{return} | array | options for creating SoapServer instance |
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;
}
public void handleError(CErrorEvent $event)
| ||
$event | CErrorEvent | the PHP error event |
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.
public void renderWsdl()
|
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.
public void run()
|
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.
Signup or Login in order to comment.