Package | mx.rpc.soap |
Class | public class AbstractWebService |
Inheritance | AbstractWebService AbstractService Proxy |
Subclasses | WebService |
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Property | Defined By | ||
---|---|---|---|
channelSet : ChannelSet
Provides access to the ChannelSet used by the service. | AbstractService | ||
convertParametersHandler : Function
An optional function, primarily intended for framework developers who need to install
a function to get called with the parameters passed to each webservice operation invocation. | AbstractWebService | ||
convertResultHandler : Function
An optional function, primarily intended for framework developers who need to install
a hook to process the results of an operation before notifying the result handlers. | AbstractWebService | ||
description : String
The description of the service for the currently active port. | AbstractWebService | ||
destination : String [override]
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 | ||
managers : Array
The managers property stores a list of data managers which modify the
behavior of this service. | AbstractService | ||
operations : 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 | ||
ready : Boolean [read-only]
Specifies whether the WebService is ready to make requests. | AbstractWebService | ||
requestTimeout : 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 |
Method | Defined By | ||
---|---|---|---|
Creates a new WebService. | AbstractWebService | ||
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 | ||
Clears the headers that applied to all operations. | AbstractWebService | ||
Disconnects the service's network connection and removes any pending
request responders. | AbstractService | ||
Returns a header if a match is found based on QName, localName, and URI. | AbstractWebService | ||
Returns an Operation of the given name. | AbstractService | ||
Called to initialize the service. | AbstractService | ||
Logs the user out of the destination. | AbstractService | ||
Removes the header with the given QName from all operations. | AbstractWebService | ||
Sets the credentials for the destination accessed by the service when using Data Services on the server side. | AbstractService | ||
[override]
The username and password to authenticate a user when accessing
the webservice. | AbstractWebService |
Constant | Defined By | ||
---|---|---|---|
DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [static]
The default destination to use for HTTP connections when invoking a webservice through a proxy. | AbstractWebService | ||
DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [static]
The default destination to use for HTTPS connections when invoking a webservice through a proxy. | AbstractWebService |
convertParametersHandler | property |
public var convertParametersHandler:Function
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
An optional function, primarily intended for framework developers who need to install
a function to get called with the parameters passed to each webservice operation invocation.
The function takes an array of parameters and returns the potentially altered array.
The function definition should look like:
function myParametersFunction(parameters:Array):Array
convertResultHandler | property |
public var convertResultHandler:Function
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
An optional function, primarily intended for framework developers who need to install
a hook to process the results of an operation before notifying the result handlers.
The function definition should look like:
function myConvertResultsFunction(result: operation:AbstractOperation):
It is passed the result just after the makeObjectsBindable conversion has been done
but before the result event is created.
description | property |
destination | property |
destination:String
[override] Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The destination of the service. This value should match a destination entry in the services-config.xml file.
Implementation
override public function get destination():String
override public function set destination(value:String):void
endpointURI | property |
endpointURI:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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
headers | property |
httpHeaders | property |
httpHeaders:Object
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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
makeObjectsBindable | property |
makeObjectsBindable:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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
port | property |
ready | property |
rootURL | property |
rootURL:String
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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
service | property |
useProxy | property |
useProxy:Boolean
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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
xmlSpecialCharsFilter | property |
xmlSpecialCharsFilter:Function
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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 default function is whatever is set by the particular implementation of IXMLEncoder.
Implementation
public function get xmlSpecialCharsFilter():Function
public function set xmlSpecialCharsFilter(value:Function):void
AbstractWebService | () | Constructor |
public function AbstractWebService(destination:String = null, rootURL:String = null)
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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.
destination:String (default = null ) — The destination. It should match a destination name
in the services-config.xml file.
| |
rootURL:String (default = null ) — The URL that the WebService should use when computing relative URLs.
|
addHeader | () | method |
public function addHeader(header:Object):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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 the header QName.
| |
headerName:String — The name of the header.
| |
headerValue:String — The value of the header.
|
clearHeaders | () | method |
public function clearHeaders():void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Clears the headers that applied to all operations.
getHeader | () | method |
public function getHeader(qname:QName, headerName:String = null):SOAPHeader
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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 ) — (Optional) Name of a header in the SOAPHeader content.
|
SOAPHeader — Returns a header if a match is found based on QName, localName, and URI.
|
removeHeader | () | method |
public function removeHeader(qname:QName, headerName:String = null):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Removes the header with the given QName from all operations.
Parameters
qname:QName — QName of the SOAPHeader.
| |
headerName:String (default = null ) — (Optional) Name of a header in the SOAPHeader content.
|
setRemoteCredentials | () | method |
override public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
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".
|
DEFAULT_DESTINATION_HTTP | Constant |
public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The default destination to use for HTTP connections when invoking a webservice through a proxy.
If you don't provide a destination and you set the useProxy
property to true
,
the default destinations will be used to route the requests to the webservice endpoint.
Note that if the default destinations are used, you must specify the WSDL and endpointURI on the client. If you use a non-default proxy destination, you can have the WSDL and endpointURI specified in the destination configuration.
DEFAULT_DESTINATION_HTTPS | Constant |
public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The default destination to use for HTTPS connections when invoking a webservice through a proxy.
If you don't provide a destination and you set the useProxy
property to true
,
the default destinations will be used to route the requests to the webservice endpoint.
Note that if the default destinations are used, you must specify the WSDL and endpointURI on the client. If you use a non-default proxy destination, you can have the WSDL and endpointURI specified in the destination configuration.
Thu Dec 6 2018, 01:12 PM -08:00