(AIR only)
Packageair.net
Classpublic class URLMonitor
InheritanceURLMonitor Inheritance ServiceMonitor Inheritance EventDispatcher Inheritance Object

Product Version : AIR 1.0

The URLMonitor class monitors availability of an HTTP- or HTTPS-based service.

This class is included in the ServiceMonitorShim.swc file. To use classes in the air.net package in Adobe® Flash® CS3 Professional, you must first drag the ServiceMonitorShim component from the Components panel to the Library and then add the following import statement to your ActionScript 3.0 code:

import air.net.*;



Public Properties
 PropertyDefined By
  acceptableStatusCodes : Array
The numeric status codes representing a successful result.
URLMonitor
 Inheritedavailable : Boolean
Whether the service is currently considered "available." The initial value is false until either a status check sets the property to true or the the property is initialized to true explicitly. Typically, this property is set by the checkStatus() implementation in a subclass or specializer, but if the application has independent information about a service's availability (for example, a request just succeeded or failed), the property can be set explicitly.
ServiceMonitor
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 InheritedlastStatusUpdate : Date
[read-only] The time of the last status update.
ServiceMonitor
 InheritedpollInterval : Number
The interval, in milliseconds, for polling the server.
ServiceMonitor
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
 Inheritedrunning : Boolean
[read-only] Whether the monitor has been started.
ServiceMonitor
  urlRequest : URLRequest
[read-only] The URLRequest object representing the probe request.
URLMonitor
Public Methods
 MethodDefined By
  
URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)
Creates a URLMonitor Object for a specified HTTP- or HTTPS-based service.
URLMonitor
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
EventDispatcher
 Inherited
Dispatches an event into the event flow.
EventDispatcher
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
makeJavascriptSubclass(constructorFunction:Object):void
[static] Adds public ServiceMonitor methods to a JavaScript constructor function's prototype.
ServiceMonitor
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Starts the service monitor.
ServiceMonitor
 Inherited
Stops monitoring the service.
ServiceMonitor
  
Returns the string representation of the specified object.
URLMonitor
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Protected Methods
 MethodDefined By
  
Attempts to load content from a URL in the background, to check for a returned HTTP status code.
URLMonitor
Events
 Event Summary Defined By
 InheritedDispatched when Flash Player or an AIR application gains operating system focus and becomes active.EventDispatcher
 InheritedDispatched when Flash Player or an AIR application loses operating system focus and is becoming inactive.EventDispatcher
 InheritedIndicates that the service status has changed.ServiceMonitor
Property Detail
acceptableStatusCodesproperty
acceptableStatusCodes:Array  [read-write]

Product Version : AIR 1.0

The numeric status codes representing a successful result.


Implementation
    public function get acceptableStatusCodes():Array
    public function set acceptableStatusCodes(value:Array):void
urlRequestproperty 
urlRequest:URLRequest  [read-only]

Product Version : AIR 1.0

The URLRequest object representing the probe request.


Implementation
    public function get urlRequest():URLRequest
Constructor Detail
URLMonitor()Constructor
public function URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)

Product Version : AIR 1.0

Creates a URLMonitor Object for a specified HTTP- or HTTPS-based service.

After creating a URLMonitor, the caller should call the start() method to begin monitoring the status of the service.

As with the Timer object, the caller should maintain a reference to the URLMonitor object. Otherwise the runtime could delete the object, thereby ending the monitoring.

A URLRequest parameter specifies the probe request for polling the server. Typically, the request method will be either "GET" or "HEAD".

Parameters
urlRequest:URLRequest — The URLRequest object representing a probe request for polling the server.
 
acceptableStatusCodes:Array (default = null) — An array of numeric status codes listing the codes that represent a successful result.

If you do not specify a value for the acceptableStatusCodes property, the following status codes will be recognized as successful responses:

  • 200 (OK)
  • 202 (Accepted)
  • 204 (No content
  • 205 (Reset content)
  • 206 (Partial content, in response to request with a Range header)
Method Detail
checkStatus()method
override protected function checkStatus():void

Product Version : AIR 1.0

Attempts to load content from a URL in the background, to check for a returned HTTP status code.

If it receives a status code that is listed in the acceptableStatusCodes property, the available property will be set to true. If it receives a status code that is not in the acceptableStatusCodes list, or if there is a security error or I/O error, the available property will be set to false.

toString()method 
override public function toString():String

Product Version : AIR 1.0

Returns the string representation of the specified object.

Note: Methods of the Object class are dynamically created on Object's prototype. To redefine this method in a subclass of Object, do not use the override keyword. For example, a subclass of Object implements function toString():String instead of using an override of the base class.

Returns
String — A string representation of the object.




 


 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/air/net/URLMonitor.html