パッケージmx.rpc.http
クラスpublic dynamic class HTTPMultiService
継承HTTPMultiService Inheritance AbstractService Inheritance Proxy Inheritance Object

<mx:HTTPMultiService> タグを使用して、http 操作のコレクションを表します。各々に URL、メソッド、パラメータおよび戻り型があります。HTTPMultiService タグに URL、メソッドなどの属性を設定し、個別の各操作タグに設定された値のデフォルトにできます。HTTPMultiService の URL は http 操作タグに設定された相対 url のベース url(プレフィックスなど)です。各 http 操作には send() メソッドがあり、このメソッドが指定の URL への HTTP 要求を作成し、HTTP 応答が返されます。HTTP 要求にデータを設定するのに使用する指定の URL にパラメータを渡せます。contentType プロパティは mimeType を指定します。mimeType は通信データ形式(HTTP フォームエンコーディング、XML)を決定するのに使用されます。直列化フィルタを使用して JSON のようなカスタム resultFormat を実装することもできます。サーバーベースのプロキシサービスを経由しない場合は、HTTP GET メソッドまたは POST メソッドだけを使用できます。 useProxy プロパティを true に設定し、サーバーベースのプロキシサービスを使用する場合は、HTTP の HEAD、OPTIONS、TRACE および DELETE メソッドも使用できます。

メモ: HTTPService のようなソフトウェアに制限があるため、HTTPMultiService は、GET を使用し、プロキシを使用しないとき、ユーザーフレンドリなエラーメッセージを生成しません。

デフォルトの MXML プロパティoperationList

関連項目

mx.rpc.http.HTTPService, mx.rpc.http.HTTPOperation


パブリックプロパティ
 プロパティ定義元
  baseURL : String
相対 URL を計算するときに、HTTPService オブジェクトが使用する必要のある URL です。
HTTPMultiService
 InheritedchannelSet : ChannelSet
サービスが使用する ChannelSet へのアクセスを提供します。
AbstractService
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  contentType : String = "application/x-www-form-urlencoded"
サービス要求のコンテンツタイプです。
HTTPMultiService
 Inheriteddestination : String
サービスの宛先です。
AbstractService
  headers : Object
サードパーティのエンドポイントに送信されるカスタム HTTP ヘッダです。
HTTPMultiService
  makeObjectsBindable : Boolean = true
true のとき、返されたオブジェクトは UI 制御へのデータバインディングをサポートします。
HTTPMultiService
 Inheritedmanagers : Array
マネージャプロパティは、このサービスの動作を修正するデータマネージャのリストを格納します。
AbstractService
  method : String = "GET"
操作についてメソッドが明示的に設定されていない場合に、要求を送信するための HTTP メソッドです。
HTTPMultiService
  operationList : Array
これはインスタンスのデフォルトプロパティとして役立ちます。操作のセットを MXML の HTTPMultiService タグの直接の子として定義できます。
HTTPMultiService
 Inheritedoperations : Object
通常、Operations 配列は MXML タグを使ってサービスを作成した場合に、MXML コンパイラによってのみ設定されます。
AbstractService
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 InheritedrequestTimeout : int
送信メッセージの要求タイムアウト時間(秒単位)に対するアクセスを提供します。
AbstractService
  resultFormat : String
HTTP 呼び出しから返された結果を非直列化する方法を示す値です。
HTTPMultiService
  serializationFilter : SerializationFilter
明示的に設定しないすべての操作で使用されるデフォルトの serializationFilter
HTTPMultiService
  showBusyCursor : Boolean = false
true の場合、サービスの実行中にビジーカーソルが表示されます。
HTTPMultiService
  useProxy : Boolean
Flex のプロキシサービスを利用するかどうかを指定します。
HTTPMultiService
パブリックメソッド
 メソッド定義元
  
HTTPMultiService(baseURL:String = null, destination:String = null)
新しい HTTPService を作成します。
HTTPMultiService
 Inherited
サービスのネットワーク接続を切断して、保留されている要求のすべての応答側を削除します。
AbstractService
 Inherited
指定された名前の Operation を返します。
AbstractService
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
サービスを初期化するために呼び出されます。
AbstractService
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
ユーザーを宛先からログアウトします。
AbstractService
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
サーバー側で Data Services を使用している場合にサービスがアクセスする宛先の資格情報を設定します。
AbstractService
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
サーバー側で Data Services を使用している場合に、リモートのサードパーティエンドポイント(プロキシを介した Web サービスやカスタムアダプタを介したリモートオブジェクトなど)にアクセスするユーザーの認証に使用されるユーザー名とパスワードです。
AbstractService
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
イベント
 イベント 概要 定義元
  HTTPMultiService 呼び出しが失敗したときに送出されます。HTTPMultiService
  チャンネルがメッセージの送信を試みる前にエラーがスローされない限り、HTTPMultiService 呼び出しが実行されると、invoke イベントが開始されます。HTTPMultiService
  HTTPMultiService 呼び出しが正常に結果を返したときに送出されます。HTTPMultiService
プロパティの詳細
baseURLプロパティ
public var baseURL:String

相対 URL を計算するときに、HTTPService オブジェクトが使用する必要のある URL です。 これには、設定時に URL の先頭に追加されるプレフィックスが含まれます。デフォルトは null です。この場合、SWF の URL は相対 URL を計算するのに使用されます。

contentTypeプロパティ 
public var contentType:String = "application/x-www-form-urlencoded"

サービス要求のコンテンツタイプです。 デフォルトは application/x-www-form-urlencoded で、名前と値のペアを持つ通常の HTTP POST のような要求を送信します。application/xml は要求を XML として送信します。

headersプロパティ 
public var headers:Object

サードパーティのエンドポイントに送信されるカスタム HTTP ヘッダです。 複数のヘッダを同じ名前で送信する必要がある場合は、値を配列として指定します。これらのヘッダーはすべての操作に送信されます。操作レベルでヘッダーを設定することもできます。

makeObjectsBindableプロパティ 
public var makeObjectsBindable:Boolean = true

true のとき、返されたオブジェクトは UI 制御へのデータバインディングをサポートします。プロパティ値が変更されている場合、オブジェクトは PropertyChangeEvents を送信します。これは makeObjectsBindable プロパティが明示的に設定されていない操作のデフォルト値です。

methodプロパティ 
public var method:String = "GET"

操作についてメソッドが明示的に設定されていない場合に、要求を送信するための HTTP メソッドです。有効な値は GETPOSTHEADOPTIONSPUTTRACE および DELETE です。小文字は大文字に変換されます。 デフォルト値は GET です。

operationListプロパティ 
operationList:Array

これはインスタンスのデフォルトプロパティとして役立ちます。操作のセットを MXML の HTTPMultiService タグの直接の子として定義できます。



実装
    public function get operationList():Array
    public function set operationList(value:Array):void
resultFormatプロパティ 
resultFormat:String

HTTP 呼び出しから返された結果を非直列化する方法を示す値です。 この値は次の項目に基づいて決定します。

デフォルト値は object です。使用できる値は次のとおりです。



実装
    public function get resultFormat():String
    public function set resultFormat(value:String):void
serializationFilterプロパティ 
public var serializationFilter:SerializationFilter

明示的に設定しないすべての操作で使用されるデフォルトの serializationFilter

showBusyCursorプロパティ 
public var showBusyCursor:Boolean = false

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

useProxyプロパティ 
useProxy:Boolean

Flex のプロキシサービスを利用するかどうかを指定します。 デフォルト値は false です。true を指定しない場合(Flex サーバーを介して要求をプロキシしない場合)は、プレーヤーがターゲット URL に確実に到達できるようにする必要があります。 また、useProxy プロパティが false に設定されている場合、services-config.xml ファイルで定義された宛先を使用することはできません。

デフォルト値 : false.



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

新しい HTTPService を作成します。サービスで相対 URL による送信を行う場合、完全な URL を決定するための基礎となる baseURL を指定できます。例えば、Application.application.url と指定します。

パラメータ
baseURL:String (default = null) — 相対 URL を計算するときに、HTTPService が使用する必要のある URL です。
 
destination:String (default = null)
イベントの詳細
fault イベント
イベントオブジェクトの型: mx.rpc.events.FaultEvent
プロパティ FaultEvent.type = mx.rpc.events.FaultEvent.FAULT

HTTPMultiService 呼び出しが失敗したときに送出されます。

FAULT イベントタイプです。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ
bubblesfalse
cancelabletrue。関連付けられたトークンの responder.fault メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。
faultこのイベントの原因についての詳細が含まれる Fault オブジェクトです。
messageこのイベントに関連付けられたメッセージ。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
tokenメソッドの呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。
invoke イベント  
イベントオブジェクトの型: mx.rpc.events.InvokeEvent
プロパティ InvokeEvent.type = mx.rpc.events.InvokeEvent.INVOKE

チャンネルがメッセージの送信を試みる前にエラーがスローされない限り、HTTPMultiService 呼び出しが実行されると、invoke イベントが開始されます。

INVOKE イベントタイプです。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ
bubblesfalse
token メソッドの個々の呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。
cancelabletrue
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。
message このイベントに関連付けられた要求メッセージです。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
result イベント  
イベントオブジェクトの型: mx.rpc.events.ResultEvent
プロパティ ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

HTTPMultiService 呼び出しが正常に結果を返したときに送出されます。

RESULT イベントタイプです。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ
bubblesfalse
cancelabletrue。関連付けられたトークンの responder.result メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。
message このイベントに関連付けられたメッセージ。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
resultRPC 呼び出しが返す結果です。
tokenメソッドの個々の呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。




 

 

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

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