javauis/mmapi_qt/baseline/javasrc/com/nokia/microedition/media/Setup.java
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Thu, 27 May 2010 12:49:31 +0300
changeset 26 dc7c549001d5
parent 23 98ccebc37403
permissions -rw-r--r--
Revision: v2.1.26 Kit: 2010121

/*
* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  This class setup MMA plugins.
*
*/


package com.nokia.microedition.media;

import com.nokia.mj.impl.utils.Logger;

/**
 * Class used to setup external components.
 */
public class Setup
{
    // Class names used to invoke external components.
    private static final String[] MMA_PLUGINS =
    {
        "com.nokia.amms.MMAInvokeListenerImpl"
    };

    /**
     * Private constructor not to allow construction.
     */
    private Setup()
    {
    }

    /**
     * Setup external components.
     * @param aEventSourceHandle Native handle MMA event source.
     */
    public static void setup(int aEventSourceHandle)
    {
        // Go through all plugins
        for (int i = 0; i < MMA_PLUGINS.length; i++)
        {
            invokeComponent(aEventSourceHandle, MMA_PLUGINS[ i ]);
        }
    }

    /**
     * Invokes other component. This method returns without creating the
     * components if the class is not found.
     *
     * @param aEventSourceHandle Handle to native mma event source.
     * @param aClassName Full class name to create. Class must have public
     * default constructor and implement MMAInvokeListener interface.
     * @throws OutOfMemoryError if component cannot be created.
     */
    private static void invokeComponent(int aEventSourceHandle, String aClassName)
    {
        try
        {
            Class invokerClass =
                Class.forName(aClassName);
            MMAInvokeListener invoker =
                (MMAInvokeListener)invokerClass.newInstance();
            invoker.notifyInvoke(aEventSourceHandle);
        }
        catch (InstantiationException ie)
        {
            throw new OutOfMemoryError("Instantiation failed, " + ie.toString());
        }
        catch (IllegalAccessException iae)
        {
            throw new OutOfMemoryError("Illegal access, " + iae.toString());
        }
        catch (ClassNotFoundException cnfe)
        {
            // If invoker class cannot be found, plugin is not added to J2ME
            // build and MMA is used without it.
            Logger.ELOG(Logger.EJavaMMAPI, "MMA::Setup:: ", cnfe);
        }
    }
}
// End of File