| パッケージ | mx.rpc.http |
| クラス | public dynamic class HTTPMultiService |
| 継承 | HTTPMultiService AbstractService Proxy 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
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
| baseURL : String
相対 URL を計算するときに、HTTPService オブジェクトが使用する必要のある URL です。 | HTTPMultiService | ||
![]() | channelSet : ChannelSet
サービスが使用する ChannelSet へのアクセスを提供します。 | AbstractService | |
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
| contentType : String = "application/x-www-form-urlencoded"
サービス要求のコンテンツタイプです。 | HTTPMultiService | ||
![]() | destination : String
サービスの宛先です。 | AbstractService | |
| headers : Object
サードパーティのエンドポイントに送信されるカスタム HTTP ヘッダです。 | HTTPMultiService | ||
| makeObjectsBindable : Boolean = true
true のとき、返されたオブジェクトは UI 制御へのデータバインディングをサポートします。 | HTTPMultiService | ||
![]() | managers : Array
マネージャプロパティは、このサービスの動作を修正するデータマネージャのリストを格納します。 | AbstractService | |
| method : String = "GET"
操作についてメソッドが明示的に設定されていない場合に、要求を送信するための HTTP メソッドです。 | HTTPMultiService | ||
| operationList : Array
これはインスタンスのデフォルトプロパティとして役立ちます。操作のセットを MXML の HTTPMultiService タグの直接の子として定義できます。 | HTTPMultiService | ||
![]() | operations : Object
通常、Operations 配列は MXML タグを使ってサービスを作成した場合に、MXML コンパイラによってのみ設定されます。 | AbstractService | |
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
![]() | requestTimeout : int
送信メッセージの要求タイムアウト時間(秒単位)に対するアクセスを提供します。 | AbstractService | |
| resultFormat : String
HTTP 呼び出しから返された結果を非直列化する方法を示す値です。 | HTTPMultiService | ||
| serializationFilter : SerializationFilter 明示的に設定しないすべての操作で使用されるデフォルトの serializationFilter | HTTPMultiService | ||
| showBusyCursor : Boolean = false
true の場合、サービスの実行中にビジーカーソルが表示されます。 | HTTPMultiService | ||
| useProxy : Boolean
Flex のプロキシサービスを利用するかどうかを指定します。 | HTTPMultiService | ||
| メソッド | 定義元 | ||
|---|---|---|---|
新しい HTTPService を作成します。 | HTTPMultiService | ||
![]() |
サービスのネットワーク接続を切断して、保留されている要求のすべての応答側を削除します。 | AbstractService | |
![]() |
指定された名前の Operation を返します。 | AbstractService | |
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
サービスを初期化するために呼び出されます。 | AbstractService | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
ユーザーを宛先からログアウトします。 | AbstractService | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
サーバー側で Data Services を使用している場合にサービスがアクセスする宛先の資格情報を設定します。 | AbstractService | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() |
サーバー側で Data Services を使用している場合に、リモートのサードパーティエンドポイント(プロキシを介した Web サービスやカスタムアダプタを介したリモートオブジェクトなど)にアクセスするユーザーの認証に使用されるユーザー名とパスワードです。 | AbstractService | |
![]() |
指定されたオブジェクトのストリング表現を返します。 | Object | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | 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 = truetrue のとき、返されたオブジェクトは UI 制御へのデータバインディングをサポートします。プロパティ値が変更されている場合、オブジェクトは PropertyChangeEvents を送信します。これは makeObjectsBindable プロパティが明示的に設定されていない操作のデフォルト値です。
| method | プロパティ |
public var method:String = "GET"
操作についてメソッドが明示的に設定されていない場合に、要求を送信するための HTTP メソッドです。有効な値は GET、POST、HEAD、OPTIONS、 PUT、TRACE および DELETE です。小文字は大文字に変換されます。 デフォルト値は GET です。
| operationList | プロパティ |
operationList:Arrayこれはインスタンスのデフォルトプロパティとして役立ちます。操作のセットを MXML の HTTPMultiService タグの直接の子として定義できます。
public function get operationList():Array public function set operationList(value:Array):void| resultFormat | プロパティ |
resultFormat:StringHTTP 呼び出しから返された結果を非直列化する方法を示す値です。 この値は次の項目に基づいて決定します。
デフォルト値は object です。使用できる値は次のとおりです。
object:返される値は XML であり、ActionScript オブジェクトのツリーとして解析されます。 これはデフォルトの設定です。array:返される値は XML で、ActionScript オブジェクトのツリーとして解析されますが、トップレベルのオブジェクトが配列でない場合、新しい配列が作成されて結果が最初のアイテムとして設定されます。 makeObjectsBindable が true の場合、配列は ArrayCollection 内にラップされます。xml:返される値は XML です。これは ActionScript XMLnode オブジェクト内のリテラル XML として返されます。flashvars: 返される値は、アンパサンドで区切られた名前と値のペアを含むテキストで、ActionScript オブジェクトに解析されます。text:返される値はテキストで、未処理のまま保持されます。e4x:返される値は XML で、ActionScript XML オブジェクト内のリテラル XML として返されます。XML(E4X)式用の ECMAScript を使ってアクセスできます。 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.FaultEventmx.rpc.events.FaultEvent.FAULTHTTPMultiService 呼び出しが失敗したときに送出されます。
FAULT イベントタイプです。イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | true。関連付けられたトークンの responder.fault メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。 |
fault | このイベントの原因についての詳細が含まれる Fault オブジェクトです。 |
message | このイベントに関連付けられたメッセージ。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。 |
token | メソッドの呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。 |
| invoke | イベント |
mx.rpc.events.InvokeEventmx.rpc.events.InvokeEvent.INVOKEチャンネルがメッセージの送信を試みる前にエラーがスローされない限り、HTTPMultiService 呼び出しが実行されると、invoke イベントが開始されます。
INVOKE イベントタイプです。イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
token | メソッドの個々の呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。 |
cancelable | true |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。 |
message | このイベントに関連付けられた要求メッセージです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。 |
| result | イベント |
mx.rpc.events.ResultEventmx.rpc.events.ResultEvent.RESULTHTTPMultiService 呼び出しが正常に結果を返したときに送出されます。
RESULT イベントタイプです。イベントオブジェクトの各プロパティには次の値が設定されています。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | true。関連付けられたトークンの responder.result メソッドから preventDefault() を呼び出すと、サービスまたは処理がこのイベントを送出しなくなります。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。 |
message | このイベントに関連付けられたメッセージ。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。 |
result | RPC 呼び出しが返す結果です。 |
token | メソッドの個々の呼び出しを表すトークン。Asynchronous Completion Token パターンで使用されます。 |
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/rpc/http/HTTPMultiService.html