パッケージmx.rpc.soap.mxml
クラスpublic dynamic class WebService
継承WebService Inheritance WebService Inheritance AbstractWebService Inheritance AbstractService Inheritance Proxy Inheritance Object
実装 IMXMLSupport, IMXMLObject

<mx:WebService> タグにより、SOAP に準拠した Web サービスの処理にアクセスできます。

MXML のシンタックスexpandedMXML シンタックスを隠す

The <mx:WebService> tag accepts the following tag attributes: 

 <mx:WebService
   Properties
   concurrency="multiple|single|last"
   destination="No default."
   id="No default."
   serviceName="No default."
   showBusyCursor="false|true"
   makeObjectsBindable="false|true"
   useProxy="false|true"
   wsdl="No default."
    Events
   fault="No default."
   result="No default."
 />

An <mx:WebService> tag can have multiple <mx:operation> tags, which have the following tag attributes: 

 <mx:operation
   Properties
   concurrency="multiple|single|last"
   name=No default, required.
   resultFormat="object|xml|e4x"
   makeObjectsBindable="false|true"
    
   Events
   fault=No default.
   result=No default.
 />
An <mx:Operation> tag contains an <mx:request> tag. To specify an XML structure in an <mx:request> tag, you must set the value of the tag's format attribute to "xml". Otherwise, the body is converted into Objects.

例を表示


パブリックプロパティ
 プロパティ定義元
 InheritedchannelSet : ChannelSet
サービスが使用する ChannelSet へのアクセスを提供します。
AbstractService
  concurrency : String
同一サービスに対する複数の呼び出しの処理方法を示す値です。
WebService
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheriteddescription : String
現在アクティブなポートに対応するサービスの説明です。
AbstractWebService
 Inheriteddestination : String
[override] サービスの宛先です。
AbstractWebService
 InheritedendpointURI : String
WebService の場所です。
AbstractWebService
 Inheritedheaders : Array
[読み取り専用] WebService に対して登録された SOAPHeaders の配列を返します。
AbstractWebService
 InheritedhttpHeaders : Object
SOAP エンドポイントに送信されるカスタム HTTP ヘッダです。
AbstractWebService
 InheritedmakeObjectsBindable : Boolean
この値が true の場合、返された匿名オブジェクトは強制的にバインド可能オブジェクトにされます。
AbstractWebService
 Inheritedmanagers : Array
マネージャプロパティは、このサービスの動作を修正するデータマネージャのリストを格納します。
AbstractService
 Inheritedoperations : Object
通常、Operations 配列は MXML タグを使ってサービスを作成した場合に、MXML コンパイラによってのみ設定されます。
AbstractService
 Inheritedport : String
この WebService が使用する必要のある WSDL ドキュメント内のポートを指定します。
AbstractWebService
  protocol : String
非推奨: プロパティプロトコルは推奨されません。 サービス設定ファイルの適切なチャンネルを使用してください（インスタンスは DefaultHTTP または DefaultHTTPS）。useProxy が false の場合は、URL が正しいプロトコルを使用するように設定してください。
[書き込み専用] 非推奨。代わりに適切な宛先を使用するか、url を使用する場合は、DefaultHTTP または DefaultHTTPS を使用します。
WebService
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedready : Boolean
[読み取り専用] WebService が要求を行う準備ができたかどうかを指定します。
AbstractWebService
 InheritedrequestTimeout : int
送信メッセージの要求タイムアウト時間（秒単位）に対するアクセスを提供します。
AbstractService
 InheritedrootURL : String
相対 URL を計算するときに、WebService が使用する必要のある URL です。
AbstractWebService
 Inheritedservice : String
この WebService が使用する必要のある WSDL ドキュメント内のサービスを指定します。
AbstractWebService
  serviceName : String
非推奨: 推奨 destination
WebService
  showBusyCursor : Boolean
true の場合、サービスの実行中にビジーカーソルが表示されます。
WebService
 InheriteduseProxy : Boolean
Flex のプロキシサービスを利用するかどうかを指定します。
AbstractWebService
 Inheritedwsdl : String
この WebService の WSDL ドキュメントの場所です。
WebService
 InheritedxmlSpecialCharsFilter : Function
単純なコンテンツをエンコードする前に XML 特殊文字のエスケープに使用されるカスタム関数です。
AbstractWebService
パブリックメソッド
 メソッド定義元
  
WebService(destination:String = null)
新しい WebService コンポーネントを作成します。
WebService
 Inherited
addHeader(header:Object):void
この Web サービスのすべての操作に適用されるヘッダを追加します。
AbstractWebService
 Inherited
addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void
この WebService のすべての操作に適用されるヘッダを追加します。
AbstractWebService
 Inherited
canLoadWSDL():Boolean
WebService が WSDL をロードできる状態であるかどうか (有効な宛先または wsdl が指定されているかどうか) を示すブール値を返します。
WebService
 Inherited
clearHeaders():void
すべての操作に適用されるヘッダをクリアします。
AbstractWebService
 Inherited
disconnect():void
サービスのネットワーク接続を切断して、保留されている要求のすべての応答側を削除します。
AbstractService
 Inherited
getHeader(qname:QName, headerName:String = null):SOAPHeader
QName の localName と URI に基づいた一致があった場合に、ヘッダーを返します。
AbstractWebService
  
getOperation(name:String):AbstractOperation
[override] 指定された名前の Operation を返します。
WebService
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
initialize():void
サービスを初期化するために呼び出されます。
AbstractService
  
initialized(document:Object, id:String):void
WebService がタグを使用して設定されている場合、MXML コンパイラによって自動的に呼び出されます。
WebService
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
loadWSDL(uri:String = null):void
WebService に WSDL ドキュメントをダウンロードするように指示します。
WebService
 Inherited
logout():void
ユーザーを宛先からログアウトします。
AbstractService
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeHeader(qname:QName, headerName:String = null):void
指定された QName を持つヘッダをすべての操作から削除します。
AbstractWebService
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
サーバー側で Data Services を使用している場合にサービスがアクセスする宛先の資格情報を設定します。
AbstractService
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
[override] ユーザーが WebService にアクセスするときに、ユーザーを認証するためのユーザー名とパスワードです。
AbstractWebService
 Inherited
toString():String
WebService のインスタンスを、宛先 ID や割り当てられたチャンネルのセットなどの重要なプロパティを記述するストリングとして表します。
WebService
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
プロテクトメソッド
 メソッド定義元
 Inherited
initializeOperation(operation:Operation):void
新しい Operation を初期化します。
WebService
イベント
 イベント 概要 定義元
 Inherited
fault
fault イベントは、サービス呼び出しが失敗した場合に送出されます。操作自体は、このイベントを処理しません。AbstractService
 Inherited
invoke
チャネルがメッセージの送信を試行する前にエラーがスローされない限り、サービスの操作が呼び出されたときに、invoke イベントが送出されます。AbstractService
 Inherited
load
LoadEvent.LOAD は、WSDL ドキュメントが正常にロードされると送出されます。WebService
 Inherited
result
result イベントは、サービス呼び出しから制御が正常に戻された場合に送出されます。操作自体は、このイベントを処理しません。AbstractService
パブリック定数
 定数定義元
 InheritedDEFAULT_DESTINATION_HTTP : String = "DefaultHTTP"
[静的]
WebService
 InheritedDEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS"
[静的]
WebService
プロパティの詳細
concurrencyプロパティ
concurrency:String

同一サービスに対する複数の呼び出しの処理方法を示す値です。 デフォルト値は multiple です。 使用できる値は次のとおりです。



実装
    public function get concurrency():String
    public function set concurrency(value:String):void
protocolプロパティ 
protocol:String  [書き込み専用]
非推奨: プロパティプロトコルは推奨されません。 サービス設定ファイルの適切なチャンネルを使用してください（インスタンスは DefaultHTTP または DefaultHTTPS）。useProxy が false の場合は、URL が正しいプロトコルを使用するように設定してください。

非推奨。代わりに適切な宛先を使用するか、url を使用する場合は、DefaultHTTP または DefaultHTTPS を使用します。 推奨されない動作では、デフォルトが使用されている場合に単に宛先が更新されます。



実装
    public function set protocol(value:String):void
serviceNameプロパティ 
serviceName:String
非推奨: 推奨 destination



実装
    public function get serviceName():String
    public function set serviceName(value:String):void
showBusyCursorプロパティ 
showBusyCursor:Boolean

true の場合、サービスの実行中にビジーカーソルが表示されます。 デフォルト値は false です。



実装
    public function get showBusyCursor():Boolean
    public function set showBusyCursor(value:Boolean):void
コンストラクタの詳細
WebService()コンストラクタ
public function WebService(destination:String = null)

新しい WebService コンポーネントを作成します。

パラメータ
destination:String (default = null) — WebService の宛先。services-config.xml ファイル内の宛先名と一致する必要があります。宛先を指定しない場合、WebService コンポーネントでは DefaultHTTP 宛先が使用されます。
メソッドの詳細
getOperation()メソッド
override public function getOperation(name:String):AbstractOperation

指定された名前の Operation を返します。 Operation が事前に作成されなかった場合、新しい mx.rpc.soap.mxml.Operation がこの呼び出し中に作成されます。 Operation は通常、その名前をサービス変数（myService.someOperation）の後に指定するだけでアクセスすることができますが、Operation 名がサービスに対して定義されているメソッドと一致している場合（例えば setCredentials）、代わりにこのメソッドを使って Operation を取得することができます。

パラメータ

name:String — Operation の名前です。

戻り値
AbstractOperation — この名前に対して実行される Operation です。
initialized()メソッド 
public function initialized(document:Object, id:String):void

WebService がタグを使用して設定されている場合、MXML コンパイラによって自動的に呼び出されます。 ActionScript によって WebService を作成する場合、このメソッドはすべてのパラメータを検証する際に役立つため、このメソッドを呼び出すことをお勧めします。

パラメータ

document:Object — この WebService が存在する MXML ドキュメントです。
 
id:String — ドキュメント内部でのこの WebService の ID です。

例 例の使用法
WebServiceExample.mxml






    
            
    

    

        
            
                {stockSymbol.text}



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/rpc/soap/mxml/WebService.html