/**
* 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;
storage = MIDletSuiteStorage.getMIDletSuiteStorage(internalSecurityToken);
if (suiteId == MIDletSuite.INTERNAL_SUITE_ID) {
// assume a class name of a MIDlet in the classpath
suite = InternalMIDletSuiteImpl.create(storage, midletDisplayName, suiteId);
} else {
suite = storage.getMIDletSuite(suiteId, false);
Logging.initLogSettings(suiteId);
}
return suite;
}
/**
* Starts a MIDlet in a new Isolate or queues the execution of the named Application suite to run.
* The current application suite should terminate itself normally to make resources available to
* the new application suite. Only one package and set of MIDlets can be queued in this manner. If
* multiple calls to execute are made, the package and MIDlets specified during the <em>last</em>
* invocation will be executed when the current application is terminated.
*
* @param securityToken security token of the calling class
* @param externalAppId ID of MIDlet to invoke, given by an external application manager
* @param suiteId ID of an installed suite
* @param midlet class name of MIDlet to invoke
* @param displayName name to display to the user
* @param arg0 if not null, this parameter will be available to the MIDlet as application property
* arg-0
* @param arg1 if not null, this parameter will be available to the MIDlet as application property
* arg-1
* @param arg2 if not null, this parameter will be available to the MIDlet as application property
* arg-2
* @param memoryReserved the minimum amount of memory guaranteed to be available to the isolate at
* any time; < 0 if not used
* @param memoryTotal the total amount of memory that the isolate can reserve; < 0 if not used
* @param priority priority to set for the new isolate; <= 0 if not used
* @param profileName name of the profile to set for the new isolate; null if not used
* @return true if the MIDlet suite MUST first exit before the MIDlet is run
* @exception SecurityException if the caller does not have permission to manage midlets
*/
public static boolean executeWithArgs(
SecurityToken securityToken,
int externalAppId,
int suiteId,
String midlet,
String displayName,
String arg0,
String arg1,
String arg2,
int memoryReserved,
int memoryTotal,
int priority,
String profileName) {
MIDletSuiteStorage midletSuiteStorage;
// Note: getMIDletSuiteStorage performs an AMS permission check.
if (securityToken != null) {
midletSuiteStorage = MIDletSuiteStorage.getMIDletSuiteStorage(securityToken);
} else {
midletSuiteStorage = MIDletSuiteStorage.getMIDletSuiteStorage();
}
return AmsUtil.executeWithArgs(
midletSuiteStorage,
externalAppId,
suiteId,
midlet,
displayName,
arg0,
arg1,
arg2,
memoryReserved,
memoryTotal,
priority,
profileName);
}
/**
* Starts a MIDlet in a new Isolate. Called from the AMS MIDlet suite.
*
* @param id ID of an installed suite
* @param midlet class name of MIDlet to invoke
* @param displayName name to display to the user
* @param arg0 if not null, this parameter will be available to the MIDlet as application property
* arg-0
* @param arg1 if not null, this parameter will be available to the MIDlet as application property
* arg-1
* @param arg2 if not null, this parameter will be available to the MIDlet as application property
* arg-2
* @return Isolate that the MIDlet suite was started in
*/
public static Isolate startMidletInNewIsolate(
int id, String midlet, String displayName, String arg0, String arg1, String arg2) {
// Note: getMIDletSuiteStorage performs an AMS permission check
return startMidletCommon(
MIDletSuiteStorage.getMIDletSuiteStorage(),
0,
id,
midlet,
displayName,
arg0,
arg1,
arg2,
-1,
-1,
Isolate.MIN_PRIORITY - 1,
null,
Constants.MIDP_NO_DEBUG);
}
/** Creates environment objects needed to AMS task */
protected void createSuiteEnvironment() {
foregroundController = this;
lcduiEnvironment =
new LCDUIEnvironmentForCDC(
internalSecurityToken, eventQueue, isolateId, foregroundController);
foregroundEventProducer = new CdcForegroundEventProducer(eventQueue);
// creates display container, needs foregroundController
super.createSuiteEnvironment();
midletStateHandler = MIDletStateHandler.getMidletStateHandler();
MIDletSuiteStorage mss = MIDletSuiteStorage.getMIDletSuiteStorage(internalSecurityToken);
midletStateHandler.initMIDletStateHandler(
internalSecurityToken, this, new CdcMIDletLoader(mss), this);
MidletSuiteContainer msc = new MidletSuiteContainer(mss);
RmsEnvironment.init(internalSecurityToken, msc);
}
/**
* Starts a MIDlet in a new Isolate. Check that the MIDlet is is not realy running and is not
* already being started. If so, return immediately.
*
* @param midletSuiteStorage midletSuiteStorage for obtaining a classpath
* @param externalAppId ID of MIDlet to invoke, given by an external application manager
* @param id ID of an installed suite
* @param midlet class name of MIDlet to invoke
* @param displayName name to display to the user
* @param arg0 if not null, this parameter will be available to the MIDlet as application property
* arg-0
* @param arg1 if not null, this parameter will be available to the MIDlet as application property
* arg-1
* @param arg2 if not null, this parameter will be available to the MIDlet as application property
* arg-2
* @param memoryReserved the minimum amount of memory guaranteed to be available to the isolate at
* any time; < 0 if not used
* @param memoryTotal the total amount of memory that the isolate can reserve; < 0 if not used
* @param priority priority to set for the new isolate; <= 0 if not used
* @param profileName name of the profile to set for the new isolate; null if not used
* @param debugMode debug option for the new isolate, one of: MIDP_NO_DEBUG, MIDP_DEBUG_SUSPEND,
* MIDP_DEBUG_NO_SUSPEND
* @return Isolate that the MIDlet suite was started in; <code>null</code> if the MIDlet is
* already running
*/
private static Isolate startMidletCommon(
MIDletSuiteStorage midletSuiteStorage,
int externalAppId,
int id,
String midlet,
String displayName,
String arg0,
String arg1,
String arg2,
int memoryReserved,
int memoryTotal,
int priority,
String profileName,
int debugMode) {
Isolate isolate;
String[] args = {
Integer.toString(id),
midlet,
displayName,
arg0,
arg1,
arg2,
Integer.toString(externalAppId),
String.valueOf(debugMode)
};
String[] classpath = midletSuiteStorage.getMidletSuiteClassPath(id);
if (classpath[0] == null) {
if (id == MIDletSuite.INTERNAL_SUITE_ID) {
/*
* Avoid a null pointer exception, rommized midlets don't need
* a classpath.
*/
classpath[0] = "";
} else {
throw new IllegalArgumentException("Suite " + id + " not found");
}
}
Vector cpExtElements = new Vector();
String isolateClassPath = System.getProperty("classpathext");
if (isolateClassPath != null) {
splitClassPath(cpExtElements, isolateClassPath);
}
/*
* Include paths to dynamic components belonging to this suite
* and to the "internal" suite (actually, to AMS) into class
* path for the new Isolate.
*/
DynamicComponentStorage componentStorage = DynamicComponentStorage.getComponentStorage();
ComponentInfo[] ci = componentStorage.getListOfSuiteComponents(id);
ComponentInfo[] ciAms =
componentStorage.getListOfSuiteComponents(MIDletSuite.INTERNAL_SUITE_ID);
int numOfComponents = 0;
// calculate the number of the components to be added to the class path
if (ci != null) {
numOfComponents += ci.length;
}
if (ciAms != null) {
numOfComponents += ciAms.length;
}
if (numOfComponents > 0) {
Vector ciVector = new Vector(numOfComponents);
// add the suite's own components
if (ci != null) {
for (int i = 0; i < ci.length; i++) {
ciVector.addElement(ci[i]);
}
}
// add the shared (belonging to AMS) components
if (ciAms != null) {
for (int i = 0; i < ciAms.length; i++) {
ciVector.addElement(ciAms[i]);
}
}
/*
* IMPL_NOTE: currently is assumed that each component may have
* not more than 1 entry in class path.
* Later it will be possible to have 2: 1 for MONET.
* + 1 is for System.getProperty("classpathext").
*/
int n = 0;
try {
for (int i = 0; i < ciVector.size(); i++) {
final ComponentInfo nextComponent = ((ComponentInfo) ciVector.elementAt(i));
final String[] componentPath =
componentStorage.getComponentClassPath(nextComponent.getComponentId());
if (componentPath != null) {
for (int j = 0; j < componentPath.length; j++) {
cpExtElements.addElement(componentPath[j]);
++n;
}
}
}
} catch (Exception e) {
/*
* if something is wrong with a dynamic component, just
* don't use the components, this error is not fatal
*/
cpExtElements.setSize(cpExtElements.size() - n);
if (Logging.REPORT_LEVEL <= Logging.ERROR) {
e.printStackTrace();
Logging.report(
Logging.ERROR,
LogChannels.LC_AMS,
"Cannot use a dynamic component when starting '"
+ midlet
+ "' from the suite with id = "
+ id);
}
}
}
try {
StartMIDletMonitor app = StartMIDletMonitor.okToStart(id, midlet);
if (app == null) {
// Isolate is already running; don't start it again
return null;
}
final String[] classpathext = new String[cpExtElements.size()];
cpExtElements.copyInto(classpathext);
isolate =
new Isolate(
"com.sun.midp.main.AppIsolateMIDletSuiteLoader", args, classpath, classpathext);
app.setIsolate(isolate);
} catch (Throwable t) {
t.printStackTrace();
throw new RuntimeException("Can't create Isolate****");
}
try {
int reserved, limit;
if (memoryReserved >= 0) {
reserved = memoryReserved;
} else {
reserved = Constants.SUITE_MEMORY_RESERVED * 1024;
}
if (memoryTotal > 0) {
limit = memoryTotal;
} else {
limit = Constants.SUITE_MEMORY_LIMIT;
if (limit < 0) {
limit = isolate.totalMemory();
} else {
limit = limit * 1024;
}
int heapSize = getMidletHeapSize(id, midlet);
if ((heapSize > 0) && (heapSize < limit)) {
limit = heapSize;
}
}
isolate.setMemoryQuota(reserved, limit);
if (priority >= Isolate.MIN_PRIORITY) {
isolate.setPriority(priority);
}
if (profileName != null) {
IsolateUtil.setProfile(isolate, profileName);
}
isolate.setDebug(debugMode);
isolate.setAPIAccess(true);
isolate.start();
// Ability to launch midlet implies right to use Service API
// for negotiations with isolate being run
Link[] isolateLinks = SystemServiceLinkPortal.establishLinksFor(isolate, getTrustedToken());
LinkPortal.setLinks(isolate, isolateLinks);
} catch (Throwable t) {
int errorCode;
String msg;
if (Logging.REPORT_LEVEL <= Logging.WARNING) {
t.printStackTrace();
}
if (t instanceof IsolateStartupException) {
/*
* An error occured in the
* initialization or configuration of the new isolate
* before any application code is invoked, or if this
* Isolate was already started or is terminated.
*/
errorCode = Constants.MIDLET_ISOLATE_CONSTRUCTOR_FAILED;
msg = "Can't start Application.";
} else if (t instanceof IsolateResourceError) {
/* The system has exceeded the maximum Isolate count. */
errorCode = Constants.MIDLET_ISOLATE_RESOURCE_LIMIT;
msg = "No more concurrent applications allowed.";
} else if (t instanceof IllegalArgumentException) {
/* Requested profile doesn't exist. */
errorCode = Constants.MIDLET_ISOLATE_CONSTRUCTOR_FAILED;
msg = "Invalid profile name: " + profileName;
} else if (t instanceof OutOfMemoryError) {
/* The reserved memory cannot be allocated */
errorCode = Constants.MIDLET_OUT_OF_MEM_ERROR;
msg = "Not enough memory to run the application.";
} else {
errorCode = Constants.MIDLET_ISOLATE_CONSTRUCTOR_FAILED;
msg = t.toString();
}
midletControllerEventProducer.sendMIDletStartErrorEvent(
id, midlet, externalAppId, errorCode, msg);
throw new RuntimeException(msg);
}
return isolate;
}