AbstractOperation  - AS3 Flex

メソッドの呼び出しに渡されるパラメーターの名前が順に列挙されたリストです。 arguments オブジェクトは順序が保証されていないハッシュマップであるため、この配列はすべてのものを正しく配置するのに役立ちます。 これは、Operation がタグ形式で使用される場合に、必要に応じて MXML コンパイラーで自動的に設定されます。

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

• multiple：既存の要求はキャンセルされません。返されるデータは開発者が責任を持って、イベントストリームを慎重に管理することで整合性を確保する必要があります。 これがデフォルト値です。
• single：処理では一度に 1 つの要求のみが認められ、複数の要求を送信すると処理が失敗します。
• last：要求を送信すると、既存の要求がすべてキャンセルされます。

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

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

要求を送信するための HTTP メソッドです。 有効な値は GET、POST、HEAD、OPTIONS、PUT、TRACE および DELETE です。 小文字は大文字に変換されます。 デフォルト値は GET です。

URL に渡すパラメーターとして使用される、名前と値のペアのオブジェクトです。 contentType プロパティが application/xml に設定されている場合は、XML ドキュメントにする必要があります。

送信メッセージの要求タイムアウト時間（秒単位）に対するアクセスを提供します。 タイムアウトに達する前にリモート宛先から応答または失敗を受信しなかった場合、メッセージはクライアント側で失敗となります。ゼロ以下の値を設定すると、要求はタイムアウトになりません。

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

• XML または名前と値のペアのどちらが返されるのか。
• 結果にアクセスする方法。結果にはオブジェクト、テキストまたは XML としてアクセスできます。

デフォルト値は 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 を使ってアクセスできます。

相対 URL を計算するときに、HTTPService オブジェクトが使用する必要のある URL です。 このプロパティは、プロキシを介するときにだけ使用されます。 useProxy プロパティが false に設定されている場合、相対 URL はこのアプリケーションを実行する SWF の場所に基づいて自動的に計算されます。 明示的に設定されていない場合、rootURL は自動的に mx.messaging.config.LoaderConfig.url の URL に設定されます。

SerializationFilter は、HTTP 要求のコンテンツを作成するために、引数が形式化される方法を制御できます。また、結果が ActionScript オブジェクトに変換される方法も制御します。このプロパティを使用して明示的に設定することもできますし、resultFormat プロパティを使用して間接的に設定することもできます。

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

サービスの場所を表します。 url とデフォルトでない宛先を指定した場合、services-config.xml ファイル内の宛先で、指定された URL が使用可能でなければなりません。

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

デフォルト値： false。

サービス結果を XML からデコードする際に使用される ActionScript 関数です。 resultFormat がオブジェクトで、xmlDecode プロパティが設定されている場合、Flex は HTTPService が返す XML を使用してオブジェクトを作成します。 それが定義されていない場合は、デフォルトの XMLDecoder を使用してこの処理が実行されます。

xmlDecode プロパティで参照される関数は、flash.xml.XMLNode オブジェクトをパラメーターとして使用してオブジェクトを返す必要があります。 返されるオブジェクトはどのようなタイプでも構いませんが、必ずいずれかのオブジェクトが返される必要があります。 null または undefined が返されると失敗が発生します。

   <mx:HTTPService id="hs" xmlDecode="xmlDecoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>

function xmlDecoder (myXML)
{
 // Simplified decoding logic.
 var myObj = {};
 myObj.name = myXML.firstChild.nodeValue;
 myObj.honorific = myXML.firstChild.attributes.honorific;
 return myObj;
}

サービス要求を XML にエンコードするために使用される ActionScript 関数です。 要求の contentType が application/xml で、渡された要求オブジェクトが Object の場合、Flex は xmlEncode プロパティで指定された関数を使用して flash.xml.XMLNode オブジェクトに変換しようとします。xmlEncode プロパティが設定されていない場合、Flex はデフォルトの XMLEncoder を使用して、オブジェクトグラフを flash.xml.XMLNode オブジェクトに変換します。

xmlEncode プロパティは Object を使用して、flash.xml.XMLNode オブジェクトを返す必要があります。 この場合、XMLNode オブジェクトは XMLNode のサブクラスである flash.xml.XML オブジェクトでも、<mx:XML> タグで取得できる flash.xml.XML オブジェクトの最初の子でも構いません。 誤ったタイプのオブジェクトが返されると、処理が失敗します。 次に、xmlEncode 関数を指定した <mx:HTTPService> タグの例を示します。

  <mx:HTTPService id="hs" xmlEncode="xmlEncoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>
    

function xmlEncoder (myObj)
{
  return new XML("");
}

新しい Operation を作成します。

HTTP リクエストヘッダーを返します。サブクラスでこのメソッドをオーバーライドして、HTTP リクエストヘッダーの取得を制御できます。

直列化フィルターを返します。サブクラスでこのメソッドをオーバーライドして、HTTP リクエストヘッダーの取得を制御できます。

パラメーター