mx.rpc.http.mxml.HTTPService （Flex 3.2）

パッケージ	mx.rpc.http.mxml
クラス	public class HTTPService
継承	HTTPService HTTPService AbstractInvoker EventDispatcher Object
実装	IMXMLSupport, IMXMLObject

<mx:HTTPService> タグを使用して、 MXML ファイル内の HTTPService オブジェクトを表せます。 HTTPService オブジェクトの send() メソッドを呼び出すと、指定した URL に対して HTTP 要求が実行され、HTTP 応答が返されます。指定する URL にパラメータを渡すこともできます。サーバーベースのプロキシサービスを経由しない場合は、HTTP GET メソッドまたは POST メソッドだけを使用できます。 useProxy プロパティを true に設定し、サーバーベースのプロキシサービスを使用する場合は、HTTP の HEAD、OPTIONS、TRACE および DELETE メソッドも使用できます。

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

MXML のシンタックス expanded

MXML シンタックスを隠す

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

 <mx:HTTPService
 Properties
 concurrency="multiple|single|last"
 contentType="application/x-www-form-urlencoded|application/xml"
 destination="DefaultHTTP"
 id="No default."
 method="GET|POST|HEAD|OPTIONS|PUT|TRACE|DELETE"
 resultFormat="object|array|xml|e4x|flashvars|text"
 showBusyCursor="false|true"
 makeObjectsBindable="false|true"
 url="No default."
 useProxy="false|true"
 xmlEncode="No default."
 xmlDecode="No default."
  Events
 fault="No default."
 result="No default."
 />

The <mx:HTTPService> tag can have a single <mx:request> tag under which the parameters can be specified.

例を表示

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		channelSet : ChannelSet サービスが使用する ChannelSet へのアクセスを提供します。	HTTPService
		concurrency : String 同一サービスに対する複数の呼び出しの処理方法を示す値です。	HTTPService
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		contentType : String サービス要求のコンテンツタイプです。	HTTPService
		destination : String services-config.xml ファイル内の HTTPService 宛先名です。	HTTPService
		headers : Object サードパーティのエンドポイントに送信されるカスタム HTTP ヘッダです。	HTTPService
		lastResult : Object [override] [読み取り専用] 最後の呼び出しの結果です。	HTTPService
		makeObjectsBindable : Boolean [override] この値が true の場合、返された匿名オブジェクトは強制的にバインド可能オブジェクトにされます。	HTTPService
		method : String 要求を送信するための HTTP メソッドです。	HTTPService
		operationManager : Function このプロパティを設定するのは、通常、サービスが外部的に呼び出される方法を修正せずに、サービス起動の動作を修正する必要のあるフレームワークコードです。	AbstractInvoker
		prototype : Object [静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		request : Object URL に渡すパラメータとして使用される、名前と値のペアのオブジェクトです。	HTTPService
		requestTimeout : int 送信メッセージの要求タイムアウト時間（秒単位）に対するアクセスを提供します。	HTTPService
		resultElementType : Class resultType と同じように、指定の操作が使用する ActionScript クラスを定義するのに使用しますが、このプロパティは、複数値結果（例えば）を返す操作にのみ適用されます。	AbstractInvoker
		resultFormat : String HTTP 呼び出しから返された結果を非直列化する方法を示す値です。	HTTPService
		resultType : Class 操作のオプション戻り型を指定します。	AbstractInvoker
		rootURL : String 相対 URL を計算するときに、HTTPService オブジェクトが使用する必要のある URL です。	HTTPService
		serializationFilter : SerializationFilter アダプタを提供します。このアダプタは、HTTP 応答本文を ActionScript オブジェクトに変換し、パラメータまたは本文を contentType、URL および HTTP 要求の本文後に調整するプロセスを制御します。	HTTPService
		showBusyCursor : Boolean true の場合、サービスの実行中にビジーカーソルが表示されます。	HTTPService
		url : String サービスの場所を表します。	HTTPService
		useProxy : Boolean Flex のプロキシサービスを利用するかどうかを指定します。	HTTPService
		xmlDecode : Function サービス結果を XML からデコードする際に使用される ActionScript 関数です。	HTTPService
		xmlEncode : Function サービス要求を XML にエンコードするために使用される ActionScript 関数です。	HTTPService

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		HTTPService(rootURL:String = null, destination:String = null) 新しい HTTPService を作成します。	HTTPService
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override] イベントリスナーが操作に反映されます。イベントのいくつかを起動しているからです。	HTTPService
		cancel(id:String = null):AsyncToken [override]	HTTPService
		clearResult(fireBindingEvent:Boolean = true):void [override]	HTTPService
		disconnect():void サービスのネットワーク接続を切断します。	HTTPService
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		initialized(document:Object, id:String):void 実装オブジェクトが作成され、MXML タグに指定されたすべてのコンポーネントプロパティが初期化された後に呼び出されます。	HTTPService
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		logout():void ユーザーを宛先からログアウトします。	HTTPService
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		send(parameters:Object = null):AsyncToken HTTPService 要求を実行します。	HTTPService
		setCredentials(username:String, password:String, charset:String = null):void サービスがアクセスする宛先の証明書を設定します。	HTTPService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void ユーザーが HTTP URL にアクセスするときに、ユーザーを認証するためのユーザー名とパスワードです。	HTTPService
		setResult(result:Object):void このフックは lastResult プロパティを更新するために公開されます。	AbstractInvoker
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

継承されるイベントを隠す

継承されるイベントを表示

	概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
fault	HTTPService 呼び出しが失敗したときに送出されます。	HTTPService
invoke	チャネルがメッセージの送信を試みる前にエラーがスローされない限り、HTTPService 呼び出しが実行されると、invoke イベントが開始されます。	HTTPService
result	HTTPService 呼び出しが正常に結果を返したときに送出されます。	HTTPService

パブリック定数

継承されるパブリック定数を隠す

継承されるパブリック定数を表示

	定数		定義元
		CONTENT_TYPE_FORM : String = "application/x-www-form-urlencoded" [静的] HTTP サービスによって送信中のデータが、application/x-www-form-urlencoded としてエンコードされることを示します。	HTTPService
		CONTENT_TYPE_XML : String = "application/xml" [静的] HTTP サービスによって送信中のデータが、application/xml としてエンコードされることを示します。	HTTPService
		DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [静的] HTTPService オブジェクトが DefaultHTTP 宛先を使用することを示します。	HTTPService
		DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [静的] HTTPService オブジェクトが DefaultHTTPS 宛先を使用することを示します。	HTTPService
		ERROR_DECODING : String = "Client.CouldNotDecode" [静的] XML 形式の結果を XML インスタンスに解析できなかったか、オブジェクトにデコードできなかったことを示します。	HTTPService
		ERROR_ENCODING : String = "Client.CouldNotEncode" [静的] 入力パラメータを XML としてエンコードできなかったことを示します。	HTTPService
		ERROR_URL_REQUIRED : String = "Client.URLRequired" [静的] useProxy プロパティが false に設定されたが、URL が提供されなかったことを示します。	HTTPService
		RESULT_FORMAT_ARRAY : String = "array" [静的] 結果フォーマット "array" は "object" と同様です。ただし、この結果フォーマットで返される値は常に配列で、結果フォーマット "object" から返された結果が配列になっていない場合に、そのアイテムが最初のアイテムとして新しい配列に追加されるようにします。	HTTPService
		RESULT_FORMAT_E4X : String = "e4x" [静的] 結果フォーマットが "e4x" の場合、返される値は XML インスタンスです。このインスタンスには、XML（E4X）式用の ECMAScript を使用してアクセスできます。	HTTPService
		RESULT_FORMAT_FLASHVARS : String = "flashvars" [静的] 結果フォーマットが "flashvars" の場合、返される値はアンパサンドで区切られた名前と値のペアを含むテキストで、ActionScript オブジェクトに解析されます。	HTTPService
		RESULT_FORMAT_OBJECT : String = "object" [静的] 結果フォーマットが "object" の場合、返される値は XML で、ただし ActionScript オブジェクトのツリーとして解析されます。	HTTPService
		RESULT_FORMAT_TEXT : String = "text" [静的] 結果フォーマットが "text" の場合、HTTPService 結果テキストは未処理のストリングとなります。	HTTPService
		RESULT_FORMAT_XML : String = "xml" [静的] 結果フォーマットが "xml" の場合、結果は、親 flash.xml.XMLDocument の最初の子を指定する flash.xml.XMLNode インスタンスとして返されます。	HTTPService

コンストラクタの詳細

HTTPService

()

コンストラクタ

public function HTTPService(rootURL:String = null, destination:String = null)

新しい HTTPService を作成します。このコンストラクタは通常、MXML ドキュメントの生成済みコードで呼び出されます。 ActionScript で HTTPService を作成するには、通常は mx.rpc.http.HTTPService クラスを使用します。

パラメータ

	`rootURL:String` (default = `null`) — 相対 URL を計算するときに、HTTPService が使用する必要のある URL です。

	`destination:String` (default = `null`) — service-config.xml ファイル内の HTTPService 宛先名です。

メソッドの詳細

initialized

()

メソッド

public function initialized(document:Object, id:String):void

実装オブジェクトが作成され、MXML タグに指定されたすべてのコンポーネントプロパティが初期化された後に呼び出されます。このクラスを ActionScript で作成し、検証で機能させるには、このメソッドを呼び出して、MXML ドキュメントと HTTPService の id を渡す必要があります。

パラメータ

	`document:Object` — このオブジェクトを作成した MXML ドキュメントです。

	`id:String` — `document` がこのオブジェクトを参照するために使用する識別子です。オブジェクトがドキュメントの deep プロパティである場合、`id` は null になります。

例例の使用法

HTTPServiceExample.mxml

<?xml version="1.0"?>
<!-- Simple example to demonstrate the HTTPService tag. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
    creationComplete="feedRequest.send();">

    <!-- The url property specifies the location of the requested file, 
    in this case the RSS 2.0 feed of Matt Chotin's blog. 
    As of this writing, the URL was still valid, but you should 
    check to make sure it hasn't changed. 
    You should use the latest RSS 2.0 URL listed on the right side of 
    the blog at http://www.adobe.com/go/mchotinblog. -->

    <mx:HTTPService 
        id="feedRequest" 
        url="http://weblogs.macromedia.com/mchotin/index.xml" 
        useProxy="false" />

    <mx:Panel title="HTTPService Example" height="75%" width="75%" 
        paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">

        <mx:DataGrid id="dgPosts" height="50%" width="75%" 
            dataProvider="{feedRequest.lastResult.rss.channel.item}">
            <mx:columns>
                <mx:DataGridColumn headerText="Posts" dataField="title"/>
                <mx:DataGridColumn headerText="Date" dataField="pubDate"/>
            </mx:columns>
        </mx:DataGrid>

        <mx:TextArea height="50%" width="75%" htmlText="{dgPosts.selectedItem.description}"/>

    </mx:Panel>    
</mx:Application>

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

Adobe® Flex™ 3.2 リファレンスガイド This Help system only	すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレームフレームなし
HTTPService	プロパティ \| メソッド \| イベント \| 定数 \| 例