mx.servicetags
HTTPService クラス

<mx:HTTPService> タグは、MXML ファイル内で HTTPService オブジェクトを表すために使用します。HTTPService オブジェクトの send() メソッドを呼び出すと、指定した URL に HTTP GET または HTTP POST 要求が送られ、HTTP 応答が返されます。指定する URL にパラメータを渡すこともできます。

メモ : ソフトウェアの制約により、HTTPService で GET 要求を使用した場合、ユーザーフレンドリーなエラーメッセージは生成されません。

MXML シンタックス

<mx:HTTPService> タグには、次のプロパティを使用できます。

 <mx:HTTPService
   concurrency="multiple|single|last"
   contentType="application/x-www-form-urlencoded|application/xml"
   fault="No default."
   id="No default."
   method="GET|POST"
   protocol="http|https"
   result="No default."
   resultFormat="object|xml|flashvars|text"
   serviceName="No default."
   showBusyCursor="false|true"
   url="No default."
   xmlEncode="No default."
   xmlDecode="No default."
 /> 

<mx:HTTPService> タグには 1 つの <mx:request> タグを設定し、そこでパラメータを指定することができます。

関連項目
    mx.events.EventDispatcher
    mx.validators.Validator
    mx.managers.CursorManager

cancel

clearResult

パラメータ
    fireBindingEvent:Boolean - result にバインドしているものの更新が必要な場合は true、そうでない場合は false です。デフォルトは true です。

clearUsernamePassword

send

パラメータ
    parameters:Object - 指定した URL に渡すパラメータです。このパラメータはオプションであり、request プロパティの既存の設定内容をオーバーライドします。

戻り値
     複数の要求の追跡に使用できる HTTP 呼び出しです。

setUsernamePassword

パラメータ
    username:String - 送信するユーザー名です。
    password:String - 送信するパスワードです。

xmlDecode

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

xmlEncode

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

concurrency

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

contentType

• application/x-www-form-urlencoded (デフォルト): 通常の HTTP POST のような要求を、名前と値のペアで送信します。
• application/xml: 要求を XML で送信します。

method

protocol

request

result

resultFormat

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

• object: 返される値は XML であり、ActionScript オブジェクトのツリーとして解析されます。これはデフォルトの設定です。
• xml: 返される値は XML です。これは ActionScript XMLnode オブジェクト内のリテラル XML として返されます。
• flashvars: 返される値は、アンパサンドで区切られた名前と値のペアを含むテキストで、ActionScript オブジェクトに解析されます。
• text: 返される値はテキストで、生データのまま保持されます。

serviceName

showBusyCursor

url

useProxy

<?xml version="1.0" encoding="utf-8"?>

<!-- この例をローカルで実行する手順です。
1. flex-config.xml ファイルを編集します。
Add httpService url under whitelist config for unnamed <http-service-proxy> services, as shown below:
      
<http-service-proxy>  
	<whitelist> 
<unnamed>			
<url>http://{localserver}/{your flex app folder path}/thisEmployee.xml</url>
</unnamed>
	</whitelist>
         ............
         ............
</http-service-proxy>
	  
2. thisEmployee.xml をコピーし、同じフォルダに HttpServiceExample.mxml として保存します。
	  
_ _ _ _ _ _ _ _ _thisEmployee.xml_ _ _ _ _ _ _ _ _
        
<?xml version="1.0" encoding="iso-8859-1" ?> 
<Company label="Macromedia">
<Branch label="Newton">
<Department label="Flex Doc">
<Name label="kapil"/>
</Department>
</Branch>
</Company>
_ _ _ _ _ _ _ _ _ _ _ end _ _ _ _ _ _ _ _ _ _ _ _ _ 

3. この例はこの後に実行されます。 -->

<!-- HttpService の使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" pageTitle="Employee Search Engine"
backgroundColor="#FFFFFF">

<mx:HTTPService id="srv" url="thisEmployee.xml"
fault="alert(event.fault.faultstring + ' \n' + 'Invalid Employee Name');"
result="alert('HTTPService responded!!!')">
</mx:HTTPService>

<mx:Script>
<![CDATA[

function Startsearch()
           {
srv.send();
           }
       ]]>
</mx:Script>

<mx:Panel title="Employee Search Engine" height="50%" width="40%">

<mx:Button label="Search" click="Startsearch();"/>
<mx:Label text="Employee Explorer:"/>
<mx:Tree dataProvider="{srv.result}" width="100%" height="100%"/>

</mx:Panel>

</mx:Application>