001    /*
002     * This file is part of the Echo Point Project.  This project is a
003     * collection of Components that have extended the Echo Web Application
004     * Framework Version 3.
005     *
006     * Version: MPL 1.1
007     *
008     * The contents of this file are subject to the Mozilla Public License Version
009     * 1.1 (the "License"); you may not use this file except in compliance with
010     * the License. You may obtain a copy of the License at
011     * http://www.mozilla.org/MPL/
012     *
013     * Software distributed under the License is distributed on an "AS IS" basis,
014     * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
015     * for the specific language governing rights and limitations under the
016     * License.
017     */
018    package echopoint.tucana.event;
019    
020    import java.io.Serializable;
021    import java.util.EventListener;
022    
023    /**
024     * An interface that defines the methods that are notified as a client content
025     * download command progresses.
026     *
027     * @author Rakesh 2008-11-11
028     * @version $Id: DownloadCallback.java 92 2008-11-11 19:49:44Z sptrakesh $
029     */
030    public interface DownloadCallback extends EventListener, Serializable
031    {
032      /**
033       * Indicate that a content download process has been started.
034       *
035       * @param event The download event object.
036       */
037      void downloadStarted( final DownloadStartEvent event );
038    
039      /**
040       * Indicate that a content download process has ended successfully.
041       *
042       * @param event The download event object.
043       */
044      void downloadFinished( final DownloadFinishEvent event );
045    
046      /**
047       * Indicate that a content download process failed, usually due to reasons
048       * other than client cancellation.
049       *
050       * @param event The download fail event object.
051       */
052      void downloadFailed( final DownloadFailEvent event );
053    }