(AIR のみ)
パッケージair.net
クラスpublic dynamic class ServiceMonitor
継承ServiceMonitor Inheritance EventDispatcher Inheritance Object
サブクラス SocketMonitor, URLMonitor

ランタイムバージョン: AIR 1.0

ServiceMonitor クラスは、ネットワークサービスのステータスおよび使用可能かどうかを監視するフレームワークを実装します。ServiceMonitor クラスは、他のすべてのサービスモニタの基本クラスとして機能します。

このクラスは、ServiceMonitor.swc ファイルに含まれます。Adobe® AIR™ のプロジェクトを作成すると、Adobe® Flex™ Builder™ によってこのクラスが自動的に読み込まれます。この servicemonitor.swc ファイルは Adobe® Flex™ SDK にも含まれています。アプリケーションをコンパイルするときに Flex SDK を使用している場合は、このファイルを含める必要があります。



パブリックプロパティ
 プロパティ定義元
  AIR-only available : Boolean
サービスが現在 "使用可能" と見なされているかどうかを指定します。初期値は false です。ステータスチェックでプロパティが true に設定されるか、プロパティが明示的に true に初期化されるまでは false です。通常、このプロパティはサブクラスまたはスペシャライザの checkStatus() 実装で設定されますが、アプリケーションにサービスが使用可能かどうかに関する独自の情報 (たとえば、要求の成功または失敗など) があれば、プロパティが明示的に設定されることもあります。
ServiceMonitor
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  AIR-only lastStatusUpdate : Date
[読み取り専用] 最後にステータスが更新された時刻です。
ServiceMonitor
  AIR-only pollInterval : Number
サーバーをポーリングする間隔 (ミリ秒) です。
ServiceMonitor
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  AIR-only running : Boolean
[読み取り専用] モニタが開始されているかどうかを指定します。
ServiceMonitor
パブリックメソッド
 メソッド定義元
  
ServiceMonitor オブジェクトを作成します。
ServiceMonitor
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
AIR-only makeJavascriptSubclass(constructorFunction:Object):void
[静的] ServiceMonitor パブリックメソッドを JavaScript のコンストラクタ関数のプロトタイプに追加します。
ServiceMonitor
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
サービスモニタを開始します。
ServiceMonitor
  
サービスの監視を停止します。
ServiceMonitor
  
[override] 指定されたオブジェクトのストリング表現を返します。
ServiceMonitor
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
  
サービスのステータスを確認します。
ServiceMonitor
イベント
 イベント 概要 定義元
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
  サービスステータスが変化したことを示します。ServiceMonitor
プロパティの詳細
AIR-only availableプロパティ
available:Boolean

ランタイムバージョン: AIR 1.0

サービスが現在 "使用可能" と見なされているかどうかを指定します。

初期値は です。ステータスチェックでプロパティが false に設定されるか、プロパティが明示的に true に初期化されるまでは truefalse です。

通常、このプロパティはサブクラスまたはスペシャライザの checkStatus() 実装で設定されますが、アプリケーションにサービスが使用可能かどうかに関する独自の情報(たとえば、要求の成功または失敗など)があれば、プロパティが明示的に設定されることもあります。



実装
    public function get available():Boolean
    public function set available(value:Boolean):void
AIR-only lastStatusUpdateプロパティ 
lastStatusUpdate:Date  [読み取り専用]

ランタイムバージョン: AIR 1.0

最後にステータスが更新された時刻です。



実装
    public function get lastStatusUpdate():Date
AIR-only pollIntervalプロパティ 
pollInterval:Number

ランタイムバージョン: AIR 1.0

サーバーをポーリングする間隔 (ミリ秒) です。

0 の場合、サーバーは定期的にポーリングされず、start() が呼び出されたときと、ネットワークステータスが変化したときの直後だけポーリングされます。

ServiceMonitor オブジェクトは、サービスステータスが変化した場合にのみ (ポーリング間隔ごとに毎回ではなく)、status イベントを送出します。また、ネットワーク接続が変化した場合にも (ポーリング間隔とは無関係に)、status イベントを送出します。

デフォルト値 : 0.



実装
    public function get pollInterval():Number
    public function set pollInterval(value:Number):void
AIR-only runningプロパティ 
running:Boolean  [読み取り専用]

ランタイムバージョン: AIR 1.0

モニタが開始されているかどうかを指定します。



実装
    public function get running():Boolean
コンストラクタの詳細
AIR-only ServiceMonitor()コンストラクタ
public function ServiceMonitor()

ランタイムバージョン: AIR 1.0

ServiceMonitor オブジェクトを作成します。

このクラスは、通常、特定のサービスタイプを監視するためにサブクラス化されます。

ServiceMonitor オブジェクト(またはサブクラスオブジェクト)を作成した後、start() メソッドを呼び出してサービスのステータスの監視を開始します。

Timer オブジェクトと同様に、呼び出し元は、ServiceMonitor オブジェクトへの参照を維持する必要があります。維持しないと、ランタイムがオブジェクトを削除し、監視が終了します。

メソッドの詳細
AIR-only checkStatus()メソッド
protected function checkStatus():void

ランタイムバージョン: AIR 1.0

サービスのステータスを確認します。

サービスのステータスを確認するために、サブクラスはメソッドをオーバーライドします。

通常、このメソッドはネットワーク処理を開始します。ネットワーク処理が完了または失敗すると、available プロパティが設定されます。

JavaScript コードは、「スペシャライザ」オブジェクトの checkStatus() メソッドを定義することで、このメソッドを特化できます。

AIR-only makeJavascriptSubclass()メソッド 
public static function makeJavascriptSubclass(constructorFunction:Object):void

ランタイムバージョン: AIR 1.0

ServiceMonitor パブリックメソッドを JavaScript のコンストラクタ関数のプロトタイプに追加します。

ServiceMonitor パブリック関数を ServiceMonitor オブジェクトに転送する JavaScript のコンストラクタ関数のプロトタイプに関数を追加します。これは、ActionScript 基本クラスの標準の JavaScript サブクラスに似たものになります。

JavaScript クラスは、ServiceMonitor を次のように特化します。

     // JavaScript Constructor function
     function MyHTTPMonitor(url, method)
     {
         // "that" variable makes "this" available in closures below
         var that = this;
         // Required initialization of the service monitor, returns the actual ServiceMonitor object.
         this.monitor = this.initServiceMonitor();
         // Initializes URLStream and event handlers.
         this._urlStream = new air.URLStream();
         this._urlRequest = new air.URLRequest(url);
         if (method)
         {
             this._urlRequest.method = method;
         }
         else
         {
             this._urlRequest.method = "GET";
         }
         function onStatus(event) {
             that.monitor.available = Number(event.status) == 200;
             that._urlStream.close();
         }
         function onError(event)
         {
             that.monitor.available = false;
             that._urlStream.close();
         }
         this._urlStream.addEventListener(air.HTTPStatusEvent.HTTP_RESPONSE_STATUS, onStatus);
         this._urlStream.addEventListener(air.SecurityErrorEvent.SECURITY_ERROR, onError);
         this._urlStream.addEventListener(air.IOErrorEvent.IO_ERROR, onError);
     }
          // Augment JavaScript prototype with public methods from ServiceMonitor
     air.ServiceMonitor.makeJavascriptSubclass(MyHTTPMonitor);
          // Implement specializer functions, just as you would when subclassing a JavaScript class
     MyHTTPMonitor.prototype.checkStatus = function()
     {
         air.trace('OVERRIDDEN checkStatus!', this);
         this._urlStream.load(this._urlRequest);
     }
     

JavaScript クラスを使用するには :

     var httpMon = new MyHTTPMonitor('http://www.adobe.com')
     

AIRAliases.js ファイルおよび ServiceMonitor.swf ファイルを、必ず script タグと一緒にロードしてください。

パラメータ

constructorFunction:Object — JavaScript オブジェクトの prototype プロパティです。例えば、スペシャライザオブジェクトとして機能するように使用している JavaScript オブジェクトの名前が MyHTTPMonitor の場合、このパラメータの値として MyHTTPMonitor.prototype を渡します。

AIR-only start()メソッド 
public function start():void

ランタイムバージョン: AIR 1.0

サービスモニタを開始します。

AIR-only stop()メソッド 
public function stop():void

ランタイムバージョン: AIR 1.0

サービスの監視を停止します。

AIR-only toString()メソッド 
override public function toString():String

ランタイムバージョン: AIR 1.0

指定されたオブジェクトのストリング表現を返します。

メモ : Object クラスのメソッドは、Object のプロトタイプに動的に作成されます。Object のサブクラスでこのメソッドを再定義する場合は、override キーワードを使用しないでください。例えば、Object のサブクラスでは、基本クラスのオーバーライドを使用する代わりに function toString():String が実装されます。

戻り値
String — オブジェクトのストリング表現です。
イベントの詳細
AIR-only status イベント
イベントオブジェクトの型: flash.events.StatusEvent
プロパティ StatusEvent.type = flash.events.StatusEvent.STATUS

ランタイムバージョン: AIR 1.0

サービスステータスが変化したことを示します。

code プロパティの値は、"Service.available" または "Service.unavailable" のどちらかですが、ServiceMonitor.available プロパティの値を確認することをお勧めします。

type プロパティ (status イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
codeオブジェクトのステータスの説明です。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
level"status""warning""error" など、メッセージのカテゴリです。
targetそのステータスをレポートするオブジェクトです。




 

 

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

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/air/net/ServiceMonitor.html