Packagemx.rpc.soap
Classpublic class AbstractWebService
InheritanceAbstractWebService Inheritance AbstractService Inheritance Proxy Inheritance Object
Subclasses WebService

AbstractWebService is an abstract base class for implementations that provide RPC access to SOAP-based web services. This class does not load WSDL descriptions at runtime.


Public Properties
 PropertyDefined By
 InheritedchannelSet : ChannelSet
Provides access to the ChannelSet used by the service.
AbstractService
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  description : String
The description of the service for the currently active port.
AbstractWebService
  destination : String
The destination of the service.
AbstractWebService
  endpointURI : String
The location of the WebService.
AbstractWebService
  headers : Array
[read-only] Returns the array of SOAPHeaders registered for the WebService.
AbstractWebService
  httpHeaders : Object
Custom HTTP headers to be sent to the SOAP endpoint.
AbstractWebService
  makeObjectsBindable : Boolean
When this value is true, anonymous objects returned are forced to bindable objects.
AbstractWebService
 Inheritedoperations : Object
The Operations array is usually only set by the MXML compiler if you create a service using an MXML tag.
AbstractService
  port : String
Specifies the port within the WSDL document that this WebService should use
AbstractWebService
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  ready : Boolean
[read-only] Specifies whether the WebService is ready to make requests.
AbstractWebService
 InheritedrequestTimeout : int
Provides access to the request timeout in seconds for sent messages.
AbstractService
  rootURL : String
The URL that the WebService should use when computing relative URLs.
AbstractWebService
  service : String
Specifies the service within the WSDL document that this WebService should use.
AbstractWebService
  useProxy : Boolean
Specifies whether to use the Flex proxy service.
AbstractWebService
  xmlSpecialCharsFilter : Function
Custom function to be used to escape XML special characters before encoding any simple content.
AbstractWebService
Public Methods
 MethodDefined By
  
AbstractWebService(destination:String = null, rootURL:String = null)
Creates a new WebService.
AbstractWebService
  
addHeader(header:Object):void
Adds a header that will be applied to all operations of this web service.
AbstractWebService
  
addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void
Add a header that will be applied to all operations of this WebService.
AbstractWebService
  
clearHeaders():void
Clears the headers that applied to all operations.
AbstractWebService
 Inherited
disconnect():void
Disconnects the service's network connection and removes any pending request responders.
AbstractService
  
getHeader(qname:QName, headerName:String = null):SOAPHeader
Returns a header if a match is found based on QName localName and URI.
AbstractWebService
 Inherited
getOperation(name:String):AbstractOperation
Returns an Operation of the given name.
AbstractService
 Inherited
hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
logout():void
Logs the user out of the destination.
AbstractService
 Inherited
propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable.
Object
  
removeHeader(qname:QName, headerName:String = null):void
Removes the header with the given QName from all operations.
AbstractWebService
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
Sets the credentials for the destination accessed by the service when using Data Services on the server side.
AbstractService
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations.
Object
  
setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
The username and password to authenticate a user when accessing the webservice.
AbstractWebService
 Inherited
toString():String
Returns the string representation of the specified object.
Object
 Inherited
valueOf():Object
Returns the primitive value of the specified object.
Object
Events
 Event Summary Defined By
 Inherited
fault
The fault event is dispatched when a service call fails and isn't handled by the Operation itself.AbstractService
 Inherited
invoke
The invoke event is dispatched when a service Operation is invoked so long as an Error is not thrown before the Channel attempts to send the message.AbstractService
 Inherited
result
The result event is dispatched when a service call successfully returns and isn't handled by the Operation itself.AbstractService
Public Constants
 ConstantDefined By
  DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP"
[static]
AbstractWebService
  DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS"
[static]
AbstractWebService
Property Detail
descriptionproperty
description:String  [read-write]

The description of the service for the currently active port.


Implementation
    public function get description():String
    public function set description(value:String):void
destinationproperty 
destination:String  [read-write]

The destination of the service. This value should match a destination entry in the services-config.xml file.


Implementation
    public function get destination():String
    public function set destination(value:String):void
endpointURIproperty 
endpointURI:String  [read-write]

The location of the WebService. Normally, the WSDL document specifies the location of the services, but you can set this property to override that location.


Implementation
    public function get endpointURI():String
    public function set endpointURI(value:String):void
headersproperty 
headers:Array  [read-only]

Returns the array of SOAPHeaders registered for the WebService.


Implementation
    public function get headers():Array
httpHeadersproperty 
httpHeaders:Object  [read-write]

Custom HTTP headers to be sent to the SOAP endpoint. If multiple headers need to be sent with the same name the value should be specified as an Array.


Implementation
    public function get httpHeaders():Object
    public function set httpHeaders(value:Object):void
makeObjectsBindableproperty 
makeObjectsBindable:Boolean  [read-write]

When this value is true, anonymous objects returned are forced to bindable objects.


Implementation
    public function get makeObjectsBindable():Boolean
    public function set makeObjectsBindable(value:Boolean):void
portproperty 
port:String  [read-write]

Specifies the port within the WSDL document that this WebService should use


Implementation
    public function get port():String
    public function set port(value:String):void
readyproperty 
ready:Boolean  [read-only]

Specifies whether the WebService is ready to make requests.


Implementation
    public function get ready():Boolean
rootURLproperty 
rootURL:String  [read-write]

The URL that the WebService should use when computing relative URLs. This property is only used when going through the proxy. When the useProxy property is set to false the relative URL is computed automatically based on the location of the SWF running this application. If not set explicitly rootURL is automatically set to the URL of mx.messaging.config.LoaderConfig.url.


Implementation
    public function get rootURL():String
    public function set rootURL(value:String):void
serviceproperty 
service:String  [read-write]

Specifies the service within the WSDL document that this WebService should use.


Implementation
    public function get service():String
    public function set service(value:String):void
useProxyproperty 
useProxy:Boolean  [read-write]

Specifies whether to use the Flex proxy service. The default value is false. If you do not specify true to proxy requests though the Flex server, you must ensure that Flash Player can reach the target URL. You also cannot use destinations defined in the services-config.xml file if the useProxy property is set to false.

The default value is false.


Implementation
    public function get useProxy():Boolean
    public function set useProxy(value:Boolean):void
xmlSpecialCharsFilterproperty 
xmlSpecialCharsFilter:Function  [read-write]

Custom function to be used to escape XML special characters before encoding any simple content. Valid for all operations on the web service unless specifically overwritten on the operation level. If none is provided, the defaults to whatever is set by the particular implementation of IXMLEncoder


Implementation
    public function get xmlSpecialCharsFilter():Function
    public function set xmlSpecialCharsFilter(value:Function):void
Constructor Detail
AbstractWebService()Constructor
public function AbstractWebService(destination:String = null, rootURL:String = null)

Creates a new WebService. The destination, if specified, should match an entry in services-config.xml. If unspecified, the WebService uses the DefaultHTTP destination. The rootURL is required if you intend to use a relative URL find the WSDL document for this WebService.

Parameters
destination:String (default = null)
 
rootURL:String (default = null)
Method Detail
addHeader()method
public function addHeader(header:Object):void

Adds a header that will be applied to all operations of this web service. The header can be provided in a pre-encoded form as an XML instance, or as a SOAPHeader instance which leaves the encoding up to the internal SOAP encoder.

Parameters

header:Object — The SOAP header to add to all operations.

addSimpleHeader()method 
public function addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void

Add a header that will be applied to all operations of this WebService.

Parameters

qnameLocal:String — the localname for the header QName
 
qnameNamespace:String — the namespace for header QName
 
headerName:String — the name of the header
 
headerValue:String — the value of the header

clearHeaders()method 
public function clearHeaders():void

Clears the headers that applied to all operations.

getHeader()method 
public function getHeader(qname:QName, headerName:String = null):SOAPHeader

Returns a header if a match is found based on QName localName and URI.

Parameters

qname:QName — QName of the SOAPHeader.
 
headerName:String (default = null) — Name of a header in the SOAPHeader content (Optional)

Returns
SOAPHeader
removeHeader()method 
public function removeHeader(qname:QName, headerName:String = null):void

Removes the header with the given QName from all operations.

Parameters

qname:QName — QName of the SOAPHeader.
 
headerName:String (default = null) — Name of a header in the SOAPHeader content (Optional)

setRemoteCredentials()method 
public override function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void

The username and password to authenticate a user when accessing the webservice. These will be passed as part of the HTTP Authorization header from the proxy to the endpoint. If useProxy is false this property will be ignored.

Parameters

remoteUsername:String — the username to pass to the remote endpoint
 
remotePassword:String — the password to pass to the remote endpoint
 
charset:String (default = null) — The character set encoding to use while encoding the remote credentials. The default is null, which implies the legacy charset of ISO-Latin-1. The only other supported charset is "UTF-8".

Constant Detail
DEFAULT_DESTINATION_HTTPConstant
public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"
DEFAULT_DESTINATION_HTTPSConstant 
public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"



© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Feb 15 2008, 2:47 AM GMT-08:00