/*
* Copyright 1990-2007 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
*
* This program 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.
*
* 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 version 2 for more details (a copy is
* included at /legal/license.txt).
*
* 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 or visit www.sun.com if you need additional
* information or have any questions.
*/
package com.sun.midp.main;
import com.sun.midp.midlet.*;
import com.sun.midp.lcdui.*;
import com.sun.midp.midletsuite.*;
import com.sun.midp.configurator.Constants;
import com.sun.midp.i18n.ResourceConstants;
import com.sun.midp.installer.InternalMIDletSuiteImpl;
import com.sun.midp.log.*;
/**
* The class presents abstract MIDlet suite loader with routines to prepare
* runtime environment for CLDC a suite execution.
*/
abstract class CldcMIDletSuiteLoader extends AbstractMIDletSuiteLoader {
/** Event producer to send MIDlet state events to the AMS isolate. */
protected MIDletControllerEventProducer midletControllerEventProducer;
/** Listener for MIDlet related events (state changes, etc). */
protected MIDletEventListener midletEventListener;
/**
* Provides interface for display foreground notification,
* functionality that can not be publicly added to a javax package.
*/
protected ForegroundEventListener foregroundEventListener;
/** Core initialization of a MIDlet suite loader */
protected void init() {
isolateId = MIDletSuiteUtils.getIsolateId();
amsIsolateId = MIDletSuiteUtils.getAmsIsolateId();
// Hint VM of startup beginning: system init phase
MIDletSuiteUtils.vmBeginStartUp(isolateId);
super.init();
}
/**
* Creates all needed objects of a MIDlet suite environment, but
* only initialization that is done, will be to pass other created objects,
* and the current and AMS isolate IDs. It is mostly event-related
* objects, however subclasses can extend the environment with more
* specific parts
*/
protected void createSuiteEnvironment() {
midletControllerEventProducer =
new MIDletControllerEventProducer(
eventQueue,
amsIsolateId,
isolateId);
foregroundController = new CldcForegroundController(
midletControllerEventProducer);
// creates display container, needs foregroundController
super.createSuiteEnvironment();
foregroundEventListener = new ForegroundEventListener(
eventQueue,
displayContainer);
midletStateHandler =
MIDletStateHandler.getMidletStateHandler();
MIDletStateListener midletStateListener =
new CldcMIDletStateListener(internalSecurityToken,
displayContainer,
midletControllerEventProducer);
midletStateHandler.initMIDletStateHandler(
internalSecurityToken,
midletStateListener,
new CldcMIDletLoader(internalSecurityToken),
new CldcPlatformRequest(internalSecurityToken));
midletEventListener = new MIDletEventListener(
internalSecurityToken,
midletStateHandler,
eventQueue);
}
/**
* Does all initialization for already created objects of a MIDlet suite
* environment. Subclasses can also extend the initialization with
* various global system initializations needed for all suites.
*/
protected void initSuiteEnvironment() {
super.initSuiteEnvironment();
}
/**
* Starts MIDlet suite in the prepared environment
* Overrides super method to hint VM of system startup
* phase is ended
*
* @throws Exception can be thrown during execution
*/
protected void startSuite() throws Exception {
// Hint VM of startup finish: system init phase
MIDletSuiteUtils.vmEndStartUp(isolateId);
super.startSuite();
}
/**
* Creates MIDlet suite instance by suite ID
*
* @return MIDlet suite to load
*
* @throws Exception in the case MIDlet suite can not be
* created because of a security reasons or some problems
* related to suite storage
*/
protected MIDletSuite createMIDletSuite() throws Exception {
MIDletSuiteStorage storage;
MIDletSuite suite = null;
if (suiteId == MIDletSuite.INTERNAL_SUITE_ID) {
// assume a class name of a MIDlet in the classpath
suite = InternalMIDletSuiteImpl.create(midletDisplayName, suiteId);
} else {
storage = MIDletSuiteStorage.
getMIDletSuiteStorage(internalSecurityToken);
suite = storage.getMIDletSuite(suiteId, false);
Logging.initLogSettings(suiteId);
}
return suite;
}
protected void closeSuite() {
super.closeSuite();
// shutdown any preempting
if (displayEventHandler != null) {
displayEventHandler.donePreempting(null);
}
}
/**
* Gets error code by exception type
*
* @param t exception instance
* @return error code
*/
static protected int getErrorCode(Throwable t) {
if (t instanceof ClassNotFoundException) {
return Constants.MIDLET_CLASS_NOT_FOUND;
} else if (t instanceof InstantiationException) {
return Constants.MIDLET_INSTANTIATION_EXCEPTION;
} else if (t instanceof IllegalAccessException) {
return Constants.MIDLET_ILLEGAL_ACCESS_EXCEPTION;
} else if (t instanceof OutOfMemoryError) {
return Constants.MIDLET_OUT_OF_MEM_ERROR;
} else if (t instanceof MIDletSuiteLockedException) {
return Constants.MIDLET_INSTALLER_RUNNING;
} else {
return Constants.MIDLET_CONSTRUCTOR_FAILED;
}
}
/**
* Gets AMS error message ID by generic error code
*
* @param errorCode generic error code
* @return AMS error ID
*/
static protected int getErrorMessageId(int errorCode) {
switch (errorCode) {
case Constants.MIDLET_SUITE_DISABLED:
return ResourceConstants.
AMS_MIDLETSUITELDR_MIDLETSUITE_DISABLED;
case Constants.MIDLET_SUITE_NOT_FOUND:
return ResourceConstants.
AMS_MIDLETSUITELDR_MIDLETSUITE_NOTFOUND;
case Constants.MIDLET_CLASS_NOT_FOUND:
return ResourceConstants.
AMS_MIDLETSUITELDR_CANT_LAUNCH_MISSING_CLASS;
case Constants.MIDLET_INSTANTIATION_EXCEPTION:
return ResourceConstants.
AMS_MIDLETSUITELDR_CANT_LAUNCH_ILL_OPERATION;
case Constants.MIDLET_ILLEGAL_ACCESS_EXCEPTION:
return ResourceConstants.
AMS_MIDLETSUITELDR_CANT_LAUNCH_ILL_OPERATION;
case Constants.MIDLET_OUT_OF_MEM_ERROR:
return ResourceConstants.
AMS_MIDLETSUITELDR_QUIT_OUT_OF_MEMORY;
default:
return ResourceConstants.
AMS_MIDLETSUITELDR_UNEXPECTEDLY_QUIT;
}
}
/**
* Handles exception occurred during MIDlet suite execution.
* @param t exception instance
*/
public void handleException(Throwable t) {
t.printStackTrace();
int errorCode = getErrorCode(t);
reportError(errorCode, t.getMessage());
}
}
|
