system system.base system.caching system.caching.dependencies system.collections system.console system.db system.db.ar system.db.schema system.db.schema.mssql system.db.schema.mysql system.db.schema.oci system.db.schema.pgsql system.db.schema.sqlite system.i18n system.i18n.gettext system.logging system.utils system.validators system.web system.web.actions system.web.auth system.web.filters system.web.helpers system.web.renderers system.web.services system.web.widgets system.web.widgets.captcha system.web.widgets.pagers

CWebService

system.web.services
继承 class CWebService » CComponent
可用自 1.0
版本 $Id$
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.

公共属性

隐藏继承的属性

属性类型描述被定义在
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. CWebService
wsdlCacheDuration integer number of seconds that the generated WSDL can remain valid in cache. CWebService
wsdlUrl string the URL for WSDL. CWebService

受保护的属性

隐藏继承的属性

属性类型描述被定义在
options array options for creating SoapServer instance CWebService

公共方法

隐藏继承的方法

方法描述被定义在
__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() 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

受保护的方法

隐藏继承的方法

方法描述被定义在
getOptions() CWebService

属性详情

actor 属性
public string $actor;

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

cacheID 属性 (自版本 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 属性
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.

encoding 属性
public string $encoding;

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

methodName 属性 只读
public string getMethodName()

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

options 属性 只读
protected array getOptions()

options for creating SoapServer instance

persistence 属性
public integer $persistence;

the persistence mode of the SOAP server.

provider 属性
public string|object $provider;

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

serviceUrl 属性
public string $serviceUrl;

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

soapVersion 属性
public string $soapVersion;

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

wsdlCacheDuration 属性
public integer $wsdlCacheDuration;

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

wsdlUrl 属性
public string $wsdlUrl;

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

方法详情

__construct() 方法
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().

Constructor.

generateWsdl() 方法
public string generateWsdl()
{return} string the generated WSDL

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

getMethodName() 方法
public string getMethodName()
{return} string the currently requested method name. Empty if no method is being requested.

getOptions() 方法
protected array getOptions()
{return} array options for creating SoapServer instance

handleError() 方法
public void handleError(CErrorEvent $event)
$event CErrorEvent the PHP error event

The PHP error handler.

renderWsdl() 方法
public void renderWsdl()

Generates and displays the WSDL as defined by the provider.

参见

run() 方法
public void run()

Handles the web service request.