/*

 * Copyright 1996-2006 Sun Microsystems, Inc.  All Rights Reserved.

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Sun designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Sun in the LICENSE file that accompanied this code.

 *

 * This code 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

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,

 * CA 95054 USA or visit www.sun.com if you need additional information or

 * have any questions.

 */

package java.beans;

import com.sun.beans.finder.ClassFinder;

import java.applet.*;

import java.awt.*;

import java.beans.AppletInitializer;

import java.beans.beancontext.BeanContext;

import java.io.*;

import java.lang.reflect.Constructor;

import java.net.URL;

import java.lang.reflect.Array;

/**

 * This class provides some general purpose beans control methods.

 */

public class Beans {

    /**

     * <p>

     * Instantiate a JavaBean.

     * </p>

     *

     * @param     cls         the class-loader from which we should create

     *                        the bean.  If this is null, then the system

     *                        class-loader is used.

     * @param     beanName    the name of the bean within the class-loader.

     *                        For example "sun.beanbox.foobah"

     *

     * @exception java.lang.ClassNotFoundException if the class of a serialized

     *              object could not be found.

     * @exception java.io.IOException if an I/O error occurs.

     */

    public static Object instantiate(ClassLoader cls, String beanName) throws java.io.IOException, ClassNotFoundException {

        return Beans.instantiate(cls, beanName, null, null);

    }

    /**

     * <p>

     * Instantiate a JavaBean.

     * </p>

     *

     * @param     cls         the class-loader from which we should create

     *                        the bean.  If this is null, then the system

     *                        class-loader is used.

     * @param     beanName    the name of the bean within the class-loader.

     *                        For example "sun.beanbox.foobah"

     * @param     beanContext The BeanContext in which to nest the new bean

     *

     * @exception java.lang.ClassNotFoundException if the class of a serialized

     *              object could not be found.

     * @exception java.io.IOException if an I/O error occurs.

     */

    public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext) throws java.io.IOException, ClassNotFoundException {

        return Beans.instantiate(cls, beanName, beanContext, null);

    }

    /**

     * Instantiate a bean.

     * <p>

     * The bean is created based on a name relative to a class-loader.

     * This name should be a dot-separated name such as "a.b.c".

     * <p>

     * In Beans 1.0 the given name can indicate either a serialized object

     * or a class.  Other mechanisms may be added in the future.  In

     * beans 1.0 we first try to treat the beanName as a serialized object

     * name then as a class name.

     * <p>

     * When using the beanName as a serialized object name we convert the

     * given beanName to a resource pathname and add a trailing ".ser" suffix.

     * We then try to load a serialized object from that resource.

     * <p>

     * For example, given a beanName of "x.y", Beans.instantiate would first

     * try to read a serialized object from the resource "x/y.ser" and if

     * that failed it would try to load the class "x.y" and create an

     * instance of that class.

     * <p>

     * If the bean is a subtype of java.applet.Applet, then it is given

     * some special initialization.  First, it is supplied with a default

     * AppletStub and AppletContext.  Second, if it was instantiated from

     * a classname the applet's "init" method is called.  (If the bean was

     * deserialized this step is skipped.)

     * <p>

     * Note that for beans which are applets, it is the caller's responsiblity

     * to call "start" on the applet.  For correct behaviour, this should be done

     * after the applet has been added into a visible AWT container.

     * <p>

     * Note that applets created via beans.instantiate run in a slightly

     * different environment than applets running inside browsers.  In

     * particular, bean applets have no access to "parameters", so they may

     * wish to provide property get/set methods to set parameter values.  We

     * advise bean-applet developers to test their bean-applets against both

     * the JDK appletviewer (for a reference browser environment) and the

     * BDK BeanBox (for a reference bean container).

     *

     * @param     cls         the class-loader from which we should create

     *                        the bean.  If this is null, then the system

     *                        class-loader is used.

     * @param     beanName    the name of the bean within the class-loader.

     *                        For example "sun.beanbox.foobah"

     * @param     beanContext The BeanContext in which to nest the new bean

     * @param     initializer The AppletInitializer for the new bean

     *

     * @exception java.lang.ClassNotFoundException if the class of a serialized

     *              object could not be found.

     * @exception java.io.IOException if an I/O error occurs.

     */

    public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext, AppletInitializer initializer)

                        throws java.io.IOException, ClassNotFoundException {

        java.io.InputStream ins;

        java.io.ObjectInputStream oins = null;

        Object result = null;

        boolean serialized = false;

        java.io.IOException serex = null;

        // If the given classloader is null, we check if an

        // system classloader is available and (if so)

        // use that instead.

        // Note that calls on the system class loader will

        // look in the bootstrap class loader first.

        if (cls == null) {

            try {

                cls = ClassLoader.getSystemClassLoader();

            } catch (SecurityException ex) {

                // We're not allowed to access the system class loader.

                // Drop through.

            }

        }

        // Try to find a serialized object with this name

        final String serName = beanName.replace('.','/').concat(".ser");

        final ClassLoader loader = cls;

        ins = (InputStream)java.security.AccessController.doPrivileged

            (new java.security.PrivilegedAction() {

                public Object run() {

                    if (loader == null)

                        return ClassLoader.getSystemResourceAsStream(serName);

                    else

                        return loader.getResourceAsStream(serName);

                }

        });

        if (ins != null) {

            try {

                if (cls == null) {

                    oins = new ObjectInputStream(ins);

                } else {

                    oins = new ObjectInputStreamWithLoader(ins, cls);

                }

                result = oins.readObject();

                serialized = true;

                oins.close();

            } catch (java.io.IOException ex) {

                ins.close();

                // Drop through and try opening the class.  But remember

                // the exception in case we can't find the class either.

                serex = ex;

            } catch (ClassNotFoundException ex) {

                ins.close();

                throw ex;

            }

        }

        if (result == null) {

            // No serialized object, try just instantiating the class

            Class cl;

            try {

                cl = ClassFinder.findClass(beanName, cls);

            } catch (ClassNotFoundException ex) {

                // There is no appropriate class.  If we earlier tried to

                // deserialize an object and got an IO exception, throw that,

                // otherwise rethrow the ClassNotFoundException.

                if (serex != null) {

                    throw serex;

                }

                throw ex;

            }

            /*

             * Try to instantiate the class.

             */

            try {

                result = cl.newInstance();

            } catch (Exception ex) {

                // We have to remap the exception to one in our signature.

                // But we pass extra information in the detail message.

                throw new ClassNotFoundException("" + cl + " : " + ex, ex);

            }

        }

        if (result != null) {

            // Ok, if the result is an applet initialize it.

            AppletStub stub = null;

            if (result instanceof Applet) {

                Applet  applet      = (Applet) result;

                boolean needDummies = initializer == null;

                if (needDummies) {

                    // Figure our the codebase and docbase URLs.  We do this

                    // by locating the URL for a known resource, and then

                    // massaging the URL.

                    // First find the "resource name" corresponding to the bean

                    // itself.  So a serialzied bean "a.b.c" would imply a

                    // resource name of "a/b/c.ser" and a classname of "x.y"

                    // would imply a resource name of "x/y.class".

                    final String resourceName;

                    if (serialized) {

                        // Serialized bean

                        resourceName = beanName.replace('.','/').concat(".ser");

                    } else {

                        // Regular class

                        resourceName = beanName.replace('.','/').concat(".class");

                    }

                    URL objectUrl = null;

                    URL codeBase  = null;

                    URL docBase   = null;

                    // Now get the URL correponding to the resource name.

                    final ClassLoader cloader = cls;

                    objectUrl = (URL)

                        java.security.AccessController.doPrivileged

                        (new java.security.PrivilegedAction() {

                            public Object run() {

                                if (cloader == null)

                                    return ClassLoader.getSystemResource

                                                                (resourceName);

                                else

                                    return cloader.getResource(resourceName);

                            }

                    });

                    // If we found a URL, we try to locate the docbase by taking

                    // of the final path name component, and the code base by taking

                    // of the complete resourceName.

                    // So if we had a resourceName of "a/b/c.class" and we got an

                    // objectURL of "file://bert/classes/a/b/c.class" then we would

                    // want to set the codebase to "file://bert/classes/" and the

                    // docbase to "file://bert/classes/a/b/"

                    if (objectUrl != null) {

                        String s = objectUrl.toExternalForm();

                        if (s.endsWith(resourceName)) {

                            int ix   = s.length() - resourceName.length();

                            codeBase = new URL(s.substring(0,ix));

                            docBase  = codeBase;

                            ix = s.lastIndexOf('/');

                            if (ix >= 0) {

                                docBase = new URL(s.substring(0,ix+1));

                            }

                        }

                    }

                    // Setup a default context and stub.

                    BeansAppletContext context = new BeansAppletContext(applet);

                    stub = (AppletStub)new BeansAppletStub(applet, context, codeBase, docBase);

                    applet.setStub(stub);

                } else {

                    initializer.initialize(applet, beanContext);

                }

                // now, if there is a BeanContext, add the bean, if applicable.

                if (beanContext != null) {

                    beanContext.add(result);

                }

                // If it was deserialized then it was already init-ed.

                // Otherwise we need to initialize it.

                if (!serialized) {

                    // We need to set a reasonable initial size, as many

                    // applets are unhappy if they are started without

                    // having been explicitly sized.

                    applet.setSize(100,100);

                    applet.init();

                }

                if (needDummies) {

                  ((BeansAppletStub)stub).active = true;

                } else initializer.activate(applet);

            } else if (beanContext != null) beanContext.add(result);

        }

        return result;

    }

    /**

     * From a given bean, obtain an object representing a specified

     * type view of that source object.

     * <p>

     * The result may be the same object or a different object.  If

     * the requested target view isn't available then the given

     * bean is returned.

     * <p>

     * This method is provided in Beans 1.0 as a hook to allow the

     * addition of more flexible bean behaviour in the future.

     *

     * @param bean        Object from which we want to obtain a view.

     * @param targetType  The type of view we'd like to get.

     *

     */

    public static Object getInstanceOf(Object bean, Class<?> targetType) {

        return bean;

    }

    /**

     * Check if a bean can be viewed as a given target type.

     * The result will be true if the Beans.getInstanceof method

     * can be used on the given bean to obtain an object that

     * represents the specified targetType type view.

     *

     * @param bean  Bean from which we want to obtain a view.

     * @param targetType  The type of view we'd like to get.

     * @return "true" if the given bean supports the given targetType.

     *

     */

    public static boolean isInstanceOf(Object bean, Class<?> targetType) {

        return Introspector.isSubclass(bean.getClass(), targetType);

    }

    /**

     * Test if we are in design-mode.

     *

     * @return  True if we are running in an application construction

     *          environment.

     *

     * @see java.beans.DesignMode

     */

    public static boolean isDesignTime() {

        return designTime;

    }

    /**

     * Determines whether beans can assume a GUI is available.

     *

     * @return  True if we are running in an environment where beans

     *     can assume that an interactive GUI is available, so they

     *     can pop up dialog boxes, etc.  This will normally return

     *     true in a windowing environment, and will normally return

     *     false in a server environment or if an application is

     *     running as part of a batch job.

     *

     * @see java.beans.Visibility

     *

     */

    public static boolean isGuiAvailable() {

        return guiAvailable;

    }

    /**

     * Used to indicate whether of not we are running in an application

     * builder environment.

     *

     * <p>Note that this method is security checked

     * and is not available to (for example) untrusted applets.

     * More specifically, if there is a security manager,

     * its <code>checkPropertiesAccess</code>

     * method is called. This could result in a SecurityException.

     *

     * @param isDesignTime  True if we're in an application builder tool.

     * @exception  SecurityException  if a security manager exists and its

     *             <code>checkPropertiesAccess</code> method doesn't allow setting

     *              of system properties.

     * @see SecurityManager#checkPropertiesAccess

     */

    public static void setDesignTime(boolean isDesignTime)

                        throws SecurityException {

        SecurityManager sm = System.getSecurityManager();

        if (sm != null) {

            sm.checkPropertiesAccess();

        }

        designTime = isDesignTime;

    }

    /**

     * Used to indicate whether of not we are running in an environment

     * where GUI interaction is available.

     *

     * <p>Note that this method is security checked

     * and is not available to (for example) untrusted applets.

     * More specifically, if there is a security manager,

     * its <code>checkPropertiesAccess</code>

     * method is called. This could result in a SecurityException.

     *

     * @param isGuiAvailable  True if GUI interaction is available.

     * @exception  SecurityException  if a security manager exists and its

     *             <code>checkPropertiesAccess</code> method doesn't allow setting

     *              of system properties.

     * @see SecurityManager#checkPropertiesAccess

     */

    public static void setGuiAvailable(boolean isGuiAvailable)

                        throws SecurityException {

        SecurityManager sm = System.getSecurityManager();

        if (sm != null) {

            sm.checkPropertiesAccess();

        }

        guiAvailable = isGuiAvailable;

    }

    private static boolean designTime;

    private static boolean guiAvailable;

    static {

        guiAvailable = !GraphicsEnvironment.isHeadless();

    }

}

/**

 * This subclass of ObjectInputStream delegates loading of classes to

 * an existing ClassLoader.

 */

class ObjectInputStreamWithLoader extends ObjectInputStream

{

    private ClassLoader loader;

    /**

     * Loader must be non-null;

     */

    public ObjectInputStreamWithLoader(InputStream in, ClassLoader loader)

            throws IOException, StreamCorruptedException {

        super(in);

        if (loader == null) {

            throw new IllegalArgumentException("Illegal null argument to ObjectInputStreamWithLoader");

        }

        this.loader = loader;

    }

    /**

     * Use the given ClassLoader rather than using the system class

     */

    protected Class resolveClass(ObjectStreamClass classDesc)

        throws IOException, ClassNotFoundException {

        String cname = classDesc.getName();

        return ClassFinder.resolveClass(cname, this.loader);

    }

}

/**

 * Package private support class.  This provides a default AppletContext

 * for beans which are applets.

 */

class BeansAppletContext implements AppletContext {

    Applet target;

    java.util.Hashtable imageCache = new java.util.Hashtable();

    BeansAppletContext(Applet target) {

        this.target = target;

    }

    public AudioClip getAudioClip(URL url) {

        // We don't currently support audio clips in the Beans.instantiate

        // applet context, unless by some luck there exists a URL content

        // class that can generate an AudioClip from the audio URL.

        try {

            return (AudioClip) url.getContent();

        } catch (Exception ex) {

            return null;

        }

    }

    public synchronized Image getImage(URL url) {

        Object o = imageCache.get(url);

        if (o != null) {

            return (Image)o;

        }

        try {

            o = url.getContent();

            if (o == null) {

                return null;

            }

            if (o instanceof Image) {

                imageCache.put(url, o);

                return (Image) o;

            }

            // Otherwise it must be an ImageProducer.

            Image img = target.createImage((java.awt.image.ImageProducer)o);

            imageCache.put(url, img);

            return img;

        } catch (Exception ex) {

            return null;

        }

    }

    public Applet getApplet(String name) {

        return null;

    }

    public java.util.Enumeration getApplets() {

        java.util.Vector applets = new java.util.Vector();

        applets.addElement(target);

        return applets.elements();

    }

    public void showDocument(URL url) {

        // We do nothing.

    }

    public void showDocument(URL url, String target) {

        // We do nothing.

    }

    public void showStatus(String status) {

        // We do nothing.

    }

    public void setStream(String key, InputStream stream)throws IOException{

        // We do nothing.

    }

    public InputStream getStream(String key){

        // We do nothing.

        return null;

    }

    public java.util.Iterator getStreamKeys(){

        // We do nothing.

        return null;

    }

}

/**

 * Package private support class.  This provides an AppletStub

 * for beans which are applets.

 */

class BeansAppletStub implements AppletStub {

    transient boolean active;

    transient Applet target;

    transient AppletContext context;

    transient URL codeBase;

    transient URL docBase;

    BeansAppletStub(Applet target,

                AppletContext context, URL codeBase,

                                URL docBase) {

        this.target = target;

        this.context = context;

        this.codeBase = codeBase;

        this.docBase = docBase;

    }

    public boolean isActive() {

        return active;

    }

    public URL getDocumentBase() {

        // use the root directory of the applet's class-loader

        return docBase;

    }

    public URL getCodeBase() {

        // use the directory where we found the class or serialized object.

        return codeBase;

    }

    public String getParameter(String name) {

        return null;

    }

    public AppletContext getAppletContext() {

        return context;

    }

    public void appletResize(int width, int height) {

        // we do nothing.

    }

}