source: 3thparty/jupload/src/main/java/wjhk/jupload2/JUploadApplet.java @ 3951

//
// $Id: JUploadApplet.java 1376 2010-07-28 21:47:39Z etienne_sf $
//
// jupload - A file upload applet.
// Copyright 2007 The JUpload Team
//
// Created: ?
// Creator: William JinHua Kwong
// Last modified: $Date: 2010-07-28 18:47:39 -0300 (Qua, 28 Jul 2010) $
//
// This program is free software; you can redistribute it and/or modify it under
// the terms of the GNU General Public License as published by the Free Software
// Foundation; either version 2 of the License, or (at your option) any later
// version. This program is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
// details. You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software Foundation, Inc.,
// 675 Mass Ave, Cambridge, MA 02139, USA.

package wjhk.jupload2;

import java.lang.reflect.InvocationTargetException;

import javax.swing.JApplet;
import javax.swing.JOptionPane;
import javax.swing.SwingUtilities;

import wjhk.jupload2.context.JUploadContext;
import wjhk.jupload2.context.JUploadContextApplet;
import wjhk.jupload2.context.JavascriptHandler;
import wjhk.jupload2.exception.JUploadException;
import wjhk.jupload2.policies.UploadPolicy;

/**
 * The applet. It contains quite only the call to creation of the
 * {@link JUploadContextApplet}, which contains the technical context. This
 * context is responsible for loading the relevant {@link UploadPolicy}. <BR>
 * <BR>
 * The behavior of the applet can easily be adapted, by : <DIR> <LI>Using an
 * existing {@link wjhk.jupload2.policies.UploadPolicy}, and specifying
 * parameters. <LI>Creating a new upload policy, based on the
 * {@link wjhk.jupload2.policies.DefaultUploadPolicy}, or created from scratch.
 * <BR>
 * For all details on this point, please read the <a
 * href="../../../howto-customization.html">howto-customization.html</a> page.
 * 
 * @author William JinHua Kwong (largely updated by etienne_sf)
 * @version $Revision: 1376 $
 */
public class JUploadApplet extends JApplet {

        /** A generated serialVersionUID, to avoid warning during compilation */
        private static final long serialVersionUID = -3207851532114846776L;

        /**
         * The current execution context.
         */
        transient JUploadContext juploadContext = null;

        /**
         * Called each time the applet is shown on the web page.
         */
        @Override
        public void init() {
                class JUploadAppletInitializer implements Runnable {
                        JUploadApplet applet;

                        JUploadAppletInitializer(JUploadApplet applet) {
                                this.applet = applet;
                        }

                        public void run() {
                                juploadContext = new JUploadContextApplet(applet);
                        }
                }

                try {
                        SwingUtilities.invokeAndWait(new JUploadAppletInitializer(this));
                } catch (InterruptedException e) {
                        // Hum, if we get here, there may be no logging system built ..
                        // Let's output something in the Java consoles
                        e.printStackTrace();
                } catch (InvocationTargetException e) {
                        // Hum, if we get here, there may be no logging system built ..
                        // Let's output something in the Java consoles
                        e.printStackTrace();
                }

                if (this.juploadContext == null) {
                        JOptionPane
                                        .showMessageDialog(
                                                        null,
                                                        "An error occured during applet initialization. Please check the java console output",
                                                        "Alert", JOptionPane.ERROR_MESSAGE);
                } else {
                        // Let's refresh the display, and have the caret well placed.
                        try {
                                this.juploadContext.getUploadPolicy().displayInfo(
                                                "JUploadApplet is now initialized.");
                        } catch (JUploadException e) {
                                // Can't use standard JUpload log mode...
                                System.out.println("JUploadApplet is now initialized.");
                        }
                }
        }

        /**
         * Called each time the applet is shown on the web page.
         */
        @Override
        public void start() {
                if (this.juploadContext == null) {
                        String msg = "An error occured during applet initialization. Please check the java console output (juploadContext is null in applet.start())";
                        JOptionPane.showMessageDialog(null, msg, "Alert",
                                        JOptionPane.ERROR_MESSAGE);
                        throw new java.lang.IllegalStateException(msg);
                } else {
                        try {
                                this.juploadContext.getUploadPolicy().start();
                                this.juploadContext.getUploadPolicy().displayInfo(
                                                "JUploadApplet is now started.");
                        } catch (JUploadException e) {
                                // Can't use standard JUpload log mode...
                                System.out.println("JUploadApplet is now started.");
                        }
                        this.validate();
                }
        }

        /**
         * @see java.applet.Applet#stop()
         */
        @Override
        public void stop() {
                try {
                        this.juploadContext.getUploadPolicy().displayInfo(
                                        "JUploadApplet is now stopped.");
                } catch (JUploadException e) {
                        // Can't use standard JUpload log mode...
                        System.out.println("JUploadApplet is now stopped.");
                }
        }

        /**
         * @see java.applet.Applet#destroy()
         */
        @Override
        public void destroy() {
                class JUploadAppletDestroyer implements Runnable {
                        JUploadApplet applet;

                        JUploadAppletDestroyer(JUploadApplet applet) {
                                this.applet = applet;
                        }

                        public void run() {
                                applet.juploadContext.runUnload();
                                applet.getContentPane().removeAll();
                        }
                }
                try {
                        this.juploadContext.getUploadPolicy().displayInfo(
                                        "JUploadApplet is being destroyed.");
                } catch (JUploadException e1) {
                        // Can't use standard JUpload log mode...
                        System.out.println("JUploadApplet is now destroyed.");
                }

                // Execute a job on the event-dispatching thread:
                // destroying this applet's GUI.
                try {
                        SwingUtilities.invokeAndWait(new JUploadAppletDestroyer(this));
                } catch (Exception e) {
                }
        }

        /**
         * This allow runtime modifications of properties, from javascript.
         * Currently, this can only be used after full initialization. This method
         * only calls the UploadPolicy.setProperty method. <BR>
         * Ex: document.jupload.setProperty(prop, value);
         * 
         * @param prop
         *            The property name that must be set.
         * @param value
         *            The value of this property.
         * @see JUploadContext#setProperty(String, String)
         */
        public void setProperty(String prop, String value) {
                this.juploadContext.setProperty(prop, value);
        }

        /**
         * Javascript can call this method to start the upload.
         * 
         * @return Returns the upload result. See the constants defined in the
         *         {@link JavascriptHandler} javadoc.
         */
        public String startUpload() {
                return this.juploadContext.startUpload();
        }

        /**
         * @see java.applet.Applet#getParameterInfo()
         */
        public String[][] getParameterInfo() {
                // FIXME Implement Applet.getParameterInfo()
                return null;
        }

        /**
         * @see java.applet.Applet#getAppletInfo()
         */
        public String getAppletInfo() {
                return "JUpload applet, available at http://jupload.sourceforge.net";
        }

}