/*

 * 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.  Oracle designates this

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

 * by Oracle 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

package java.awt;

import java.awt.peer.MenuComponentPeer;

import java.io.IOException;

import java.io.ObjectInputStream;

import java.security.AccessControlContext;

import java.security.AccessController;

/**

 * The abstract class {@code MenuComponent} is the superclass

 * of all menu-related components. In this respect, the class

 * {@code MenuComponent} is analogous to the abstract superclass

 * {@code Component} for AWT components.

 * <p>

 * Menu components receive and process AWT events, just as components do,

 * through the method {@code processEvent}.

 *

 * @author      Arthur van Hoff

 * @since       1.0

 */

public abstract class MenuComponent implements java.io.Serializable {

    static {

        /* ensure that the necessary native libraries are loaded */

        Toolkit.loadLibraries();

        if (!GraphicsEnvironment.isHeadless()) {

            initIDs();

        }

    }

    transient volatile MenuComponentPeer peer;

    /**

     * The {@code AppContext} of the {@code MenuComponent}.

     * This is set in the constructor and never changes.

     */

    /**

     * The menu component's font. This value can be

     * {@code null} at which point a default will be used.

     * This defaults to {@code null}.

     *

     * @serial

     * @see #setFont(Font)

     * @see #getFont()

     */

    /**

     * The menu component's name, which defaults to {@code null}.

     * @serial

     * @see #getName()

     * @see #setName(String)

     */

    /**

     * A variable to indicate whether a name is explicitly set.

     * If {@code true} the name will be set explicitly.

     * This defaults to {@code false}.

     * @serial

     * @see #setName(String)

     */

    /**

     * Defaults to {@code false}.

     * @serial

     * @see #dispatchEvent(AWTEvent)

     */

    /*

     * The menu's AccessControlContext.

     */

    private transient volatile AccessControlContext acc =

            AccessController.getContext();

    /*

     * Returns the acc this menu component was constructed with.

     */

    final AccessControlContext getAccessControlContext() {

        if (acc == null) {

            throw new SecurityException(

                    "MenuComponent is missing AccessControlContext");

        }

        return acc;

    }

    /*

     * Internal constants for serialization.

     */

    static final String actionListenerK = Component.actionListenerK;

    static final String itemListenerK = Component.itemListenerK;

    /*

     * JDK 1.1 serialVersionUID

     */

    private static final long serialVersionUID = -4536902356223894379L;

    static {

        AWTAccessor.setMenuComponentAccessor(

            new AWTAccessor.MenuComponentAccessor() {

                @Override

                public AppContext getAppContext(MenuComponent menuComp) {

                    return menuComp.appContext;

                }

                @Override

                public void setAppContext(MenuComponent menuComp,

                                          AppContext appContext) {

                    menuComp.appContext = appContext;

                }

                @Override

                @SuppressWarnings("unchecked")

                public <T extends MenuComponentPeer> T getPeer(MenuComponent menuComp) {

                    return (T) menuComp.peer;

                }

                @Override

                public MenuContainer getParent(MenuComponent menuComp) {

                    return menuComp.parent;

                }

                @Override

                public void setParent(MenuComponent menuComp, MenuContainer menuContainer) {

                    menuComp.parent = menuContainer;

                }

                @Override

                public Font getFont_NoClientCode(MenuComponent menuComp) {

                    return menuComp.getFont_NoClientCode();

                }

            });

    }

    /**

     * Creates a {@code MenuComponent}.

     * @exception HeadlessException if

     *    {@code GraphicsEnvironment.isHeadless}

     *    returns {@code true}

     * @see java.awt.GraphicsEnvironment#isHeadless

     */

    public MenuComponent() throws HeadlessException {

        GraphicsEnvironment.checkHeadless();

        appContext = AppContext.getAppContext();

    }

    /**

     * Constructs a name for this {@code MenuComponent}.

     * Called by {@code getName} when the name is {@code null}.

     * @return a name for this {@code MenuComponent}

     */

    String constructComponentName() {

        return null; // For strict compliance with prior platform versions, a MenuComponent

                     // that doesn't set its name should return null from

                     // getName()

    }

    final ComponentFactory getComponentFactory() {

        final Toolkit toolkit = Toolkit.getDefaultToolkit();

        if (toolkit instanceof ComponentFactory) {

            return (ComponentFactory) toolkit;

        }

        throw new AWTError("UI components are unsupported by: " + toolkit);

    }

    /**

     * Gets the name of the menu component.

     * @return        the name of the menu component

     * @see           java.awt.MenuComponent#setName(java.lang.String)

     * @since         1.1

     */

    public String getName() {

        if (name == null && !nameExplicitlySet) {

            synchronized(this) {

                if (name == null && !nameExplicitlySet)

                    name = constructComponentName();

            }

        }

        return name;

    }

    /**

     * Sets the name of the component to the specified string.

     * @param         name    the name of the menu component

     * @see           java.awt.MenuComponent#getName

     * @since         1.1

     */

    public void setName(String name) {

        synchronized(this) {

            this.name = name;

            nameExplicitlySet = true;

        }

    }

    /**

     * Returns the parent container for this menu component.

     * @return    the menu component containing this menu component,

     *                 or {@code null} if this menu component

     *                 is the outermost component, the menu bar itself

     */

    public MenuContainer getParent() {

        return getParent_NoClientCode();

    }

    // NOTE: This method may be called by privileged threads.

    //       This functionality is implemented in a package-private method

    //       to insure that it cannot be overridden by client subclasses.

    //       DO NOT INVOKE CLIENT CODE ON THIS THREAD!

    final MenuContainer getParent_NoClientCode() {

        return parent;

    }

    /**

     * Gets the font used for this menu component.

     * @return   the font used in this menu component, if there is one;

     *                  {@code null} otherwise

     * @see     java.awt.MenuComponent#setFont

     */

    public Font getFont() {

        Font font = this.font;

        if (font != null) {

            return font;

        }

        MenuContainer parent = this.parent;

        if (parent != null) {

            return parent.getFont();

        }

        return null;

    }

    // NOTE: This method may be called by privileged threads.

    //       This functionality is implemented in a package-private method

    //       to insure that it cannot be overridden by client subclasses.

    //       DO NOT INVOKE CLIENT CODE ON THIS THREAD!

    final Font getFont_NoClientCode() {

        Font font = this.font;

        if (font != null) {

            return font;

        }

        // The MenuContainer interface does not have getFont_NoClientCode()

        // and it cannot, because it must be package-private. Because of

        // this, we must manually cast classes that implement

        // MenuContainer.

        Object parent = this.parent;

        if (parent != null) {

            if (parent instanceof Component) {

                font = ((Component)parent).getFont_NoClientCode();

            } else if (parent instanceof MenuComponent) {

                font = ((MenuComponent)parent).getFont_NoClientCode();

            }

        }

        return font;

    } // getFont_NoClientCode()

    /**

     * Sets the font to be used for this menu component to the specified

     * font. This font is also used by all subcomponents of this menu

     * component, unless those subcomponents specify a different font.

     * <p>

     * Some platforms may not support setting of all font attributes

     * of a menu component; in such cases, calling {@code setFont}

     * will have no effect on the unsupported font attributes of this

     * menu component.  Unless subcomponents of this menu component

     * specify a different font, this font will be used by those

     * subcomponents if supported by the underlying platform.

     *

     * @param     f   the font to be set

     * @see       #getFont

     * @see       Font#getAttributes

     * @see       java.awt.font.TextAttribute

     */

    public void setFont(Font f) {

        synchronized (getTreeLock()) {

            font = f;

            //Fixed 6312943: NullPointerException in method MenuComponent.setFont(Font)

            MenuComponentPeer peer = this.peer;

            if (peer != null) {

                peer.setFont(f);

            }

        }

    }

    /**

     * Removes the menu component's peer.  The peer allows us to modify the

     * appearance of the menu component without changing the functionality of

     * the menu component.

     */

    public void removeNotify() {

        synchronized (getTreeLock()) {

            MenuComponentPeer p = this.peer;

            if (p != null) {

                Toolkit.getEventQueue().removeSourceEvents(this, true);

                this.peer = null;

                p.dispose();

            }

        }

    }

    /**

     * Posts the specified event to the menu.

     * This method is part of the Java 1.0 event system

     * and it is maintained only for backwards compatibility.

     * Its use is discouraged, and it may not be supported

     * in the future.

     * @param evt the event which is to take place

     * @return unconditionally returns false

     * @deprecated As of JDK version 1.1, replaced by {@link

     * #dispatchEvent(AWTEvent) dispatchEvent}.

     */

    @Deprecated

    public boolean postEvent(Event evt) {

        MenuContainer parent = this.parent;

        if (parent != null) {

            parent.postEvent(evt);

        }

        return false;

    }

    /**

     * Delivers an event to this component or one of its sub components.

     * @param e the event

     */

    public final void dispatchEvent(AWTEvent e) {

        dispatchEventImpl(e);

    }

    void dispatchEventImpl(AWTEvent e) {

        EventQueue.setCurrentEventAndMostRecentTime(e);

        Toolkit.getDefaultToolkit().notifyAWTEventListeners(e);

        if (newEventsOnly ||

            (parent != null && parent instanceof MenuComponent &&

             ((MenuComponent)parent).newEventsOnly)) {

            if (eventEnabled(e)) {

                processEvent(e);

            } else if (e instanceof ActionEvent && parent != null) {

                e.setSource(parent);

                ((MenuComponent)parent).dispatchEvent(e);

            }

        } else { // backward compatibility

            Event olde = e.convertToOld();

            if (olde != null) {

                postEvent(olde);

            }

        }

    }

    // REMIND: remove when filtering is done at lower level

    boolean eventEnabled(AWTEvent e) {

        return false;

    }

    /**

     * Processes events occurring on this menu component.

     * <p>Note that if the event parameter is {@code null}

     * the behavior is unspecified and may result in an

     * exception.

     *

     * @param e the event

     * @since 1.1

     */

    protected void processEvent(AWTEvent e) {

    }

    /**

     * Returns a string representing the state of this

     * {@code MenuComponent}. This method is intended to be used

     * only for debugging purposes, and the content and format of the

     * returned string may vary between implementations. The returned

     * string may be empty but may not be {@code null}.

     *

     * @return     the parameter string of this menu component

     */

    protected String paramString() {

        String thisName = getName();

        return (thisName != null? thisName : "");

    }

    /**

     * Returns a representation of this menu component as a string.

     * @return  a string representation of this menu component

     */

    public String toString() {

        return getClass().getName() + "[" + paramString() + "]";

    }

    /**

     * Gets this component's locking object (the object that owns the thread

     * synchronization monitor) for AWT component-tree and layout

     * operations.

     * @return this component's locking object

     */

    protected final Object getTreeLock() {

        return Component.LOCK;

    }

    /**

     * Reads the menu component from an object input stream.

     *

     * @param s the {@code ObjectInputStream} to read

     * @exception HeadlessException if

     *   {@code GraphicsEnvironment.isHeadless} returns

     *   {@code true}

     * @serial

     * @see java.awt.GraphicsEnvironment#isHeadless

     */

    private void readObject(ObjectInputStream s)

        throws ClassNotFoundException, IOException, HeadlessException

    {

        GraphicsEnvironment.checkHeadless();

        acc = AccessController.getContext();

        s.defaultReadObject();

        appContext = AppContext.getAppContext();

    }

    /**

     * Initialize JNI field and method IDs.

     */

    private static native void initIDs();

    /*

     * --- Accessibility Support ---

     *

     *  MenuComponent will contain all of the methods in interface Accessible,

     *  though it won't actually implement the interface - that will be up

     *  to the individual objects which extend MenuComponent.

     */

    AccessibleContext accessibleContext = null;

    /**

     * Gets the {@code AccessibleContext} associated with

     * this {@code MenuComponent}.

     *

     * The method implemented by this base class returns {@code null}.

     * Classes that extend {@code MenuComponent}

     * should implement this method to return the

     * {@code AccessibleContext} associated with the subclass.

     *

     * @return the {@code AccessibleContext} of this

     *     {@code MenuComponent}

     * @since 1.3

     */

    public AccessibleContext getAccessibleContext() {

        return accessibleContext;

    }

    /**

     * Inner class of {@code MenuComponent} used to provide

     * default support for accessibility.  This class is not meant

     * to be used directly by application developers, but is instead

     * meant only to be subclassed by menu component developers.

     * <p>

     * The class used to obtain the accessible role for this object.

     * @since 1.3

     */

    protected abstract class AccessibleAWTMenuComponent

        extends AccessibleContext

        implements java.io.Serializable, AccessibleComponent,

                   AccessibleSelection

    {

        /*

         * JDK 1.3 serialVersionUID

         */

        private static final long serialVersionUID = -4269533416223798698L;

        /**

         * Although the class is abstract, this should be called by