FileUpload

Kind of class:	public class
Package:	com.example.programmingas3.fileio
Inherits from:	UIComponent
Classpath:	com.example.programmingas3.fileio.FileUpload
File last modified:	Thursday, 01 June 2006, 10:58:24

► View source

▼ Hide source

package com.example.programmingas3.fileio {
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;
    
    import mx.controls.Button;
    import mx.controls.ProgressBar;
    import mx.core.UIComponent;

    public class FileUpload extends UIComponent {
        // Hard-code the URL of the remote upload script.
        private const UPLOAD_URL:String = "http://www.yourdomain.com/upload_script.cfm";
        private var fr:FileReference;
        // Define reference to the upload ProgressBar component.
        private var pb:ProgressBar;
        // Define reference to the "Cancel" button which will immediately stop the upload in progress.
        private var btn:Button;

        public function FileUpload() {
        }

        /**
         * Set references to the components, and add listeners for the SELECT,
         * OPEN, PROGRESS, and COMPLETE events.
         */
        public function init(pb:ProgressBar, btn:Button):void {
            // Set up the references to the progress bar and cancel button, which are passed from the calling script.
            this.pb = pb;
            this.btn = btn;
            
            fr = new FileReference();
            fr.addEventListener(Event.SELECT, selectHandler);
            fr.addEventListener(Event.OPEN, openHandler);
            fr.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            fr.addEventListener(Event.COMPLETE, completeHandler);
        }

        /**
         * Immediately cancel the upload in progress and disable the cancel button.
         */
        public function cancelUpload():void {
            fr.cancel();
            pb.label = "UPLOAD CANCELLED";
            btn.enabled = false;
        }

        /**
         * Launch the browse dialog box which allows the user to select a file to upload to the server.
         */
        public function startUpload():void {
            fr.browse();
        }

        /**
         * Begin uploading the file specified in the UPLOAD_URL constant.
         */
        private function selectHandler(event:Event):void {
            var request:URLRequest = new URLRequest();
            request.url = UPLOAD_URL;
            fr.upload(request);
        }

        /**
         * When the OPEN event has dispatched, change the progress bar's label 
         * and enable the "Cancel" button, which allows the user to abort the 
         * upload operation.
         */
        private function openHandler(event:Event):void {
            pb.label = "UPLOADING";
            btn.enabled = true;
        }

        /**
         * While the file is uploading, update the progress bar's status and label.
         */
        private function progressHandler(event:ProgressEvent):void {
            pb.label = "UPLOADING %3%%";
            pb.setProgress(event.bytesLoaded, event.bytesTotal);
        }

        /**
         * Once the upload has completed, change the progress bar's label and 
         * disable the "Cancel" button since the upload is already completed.
         */
        private function completeHandler(event:Event):void {
            pb.label = "UPLOADING COMPLETE";
            pb.setProgress(0, 100);
            btn.enabled = false;
        }
    }
}

Summary

Constructor

FileUpload

Constants

UPLOAD_URL : String

Instance properties

fr : FileReference
pb : ProgressBar
btn : Button

Instance methods

init (pb:ProgressBar, btn:Button) : void
- Set references to the components, and add listeners for the SELECT, OPEN, PROGRESS, and COMPLETE events.
cancelUpload : void
- Immediately cancel the upload in progress and disable the cancel button.
startUpload : void
- Launch the browse dialog box which allows the user to select a file to upload to the server.
selectHandler (event:Event) : void
- Begin uploading the file specified in the UPLOAD_URL constant.
openHandler (event:Event) : void
- When the OPEN event has dispatched, change the progress bar's label and enable the "Cancel" button, which allows the user to abort the upload operation.
progressHandler (event:ProgressEvent) : void
- While the file is uploading, update the progress bar's status and label.
completeHandler (event:Event) : void
- Once the upload has completed, change the progress bar's label and disable the "Cancel" button since the upload is already completed.

Constructor

FileUpload

public function FileUpload (

)

Constants

UPLOAD_URL

private const UPLOAD_URL:String = "http://www.yourdomain.com/upload_script.cfm"

(read)

Instance properties

btn

private btn:Button

(read)

fr

private fr:FileReference

(read)

pb

private pb:ProgressBar

(read)

Instance methods

cancelUpload

public function cancelUpload (

) : void

Immediately cancel the upload in progress and disable the cancel button.

completeHandler

private function completeHandler (

event:Event) : void

Once the upload has completed, change the progress bar's label and
disable the "Cancel" button since the upload is already completed.

init

public function init (

pb:ProgressBar, btn:Button) : void

Set references to the components, and add listeners for the SELECT,
OPEN, PROGRESS, and COMPLETE events.

openHandler

private function openHandler (

event:Event) : void

When the OPEN event has dispatched, change the progress bar's label
and enable the "Cancel" button, which allows the user to abort the
upload operation.

progressHandler

private function progressHandler (

event:ProgressEvent) : void

While the file is uploading, update the progress bar's status and label.

selectHandler

private function selectHandler (

event:Event) : void

Begin uploading the file specified in the UPLOAD_URL constant.

startUpload

public function startUpload (

) : void

Launch the browse dialog box which allows the user to select a file to upload to the server.