javaruntimes/midp/runtime/javasrc/com/nokia/mj/impl/rt/midp/ApplicationUtilsImpl.java
/*
* Copyright (c) 2009 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:
*
*/
package com.nokia.mj.impl.rt.midp;
import java.security.Permission;
import java.security.AccessControlException;
import com.nokia.mj.impl.rt.support.ApplicationUtils;
import com.nokia.mj.impl.rt.support.ApplicationInfo;
import com.nokia.mj.impl.security.midp.authorization.AccessControllerFactoryImpl;
import com.nokia.mj.impl.security.midp.authorization.AccessControllerImpl;
import com.nokia.mj.impl.utils.Uid;
import com.nokia.mj.impl.utils.exception.UserCancelException;
/**
* A MIDP runtime specific implementation of ApplicationUtils class of the
* runtime support API.
*/
public class ApplicationUtilsImpl extends ApplicationUtils
{
private AccessControllerImpl mAccessController;
private boolean mStandAlone = false;
/*** ----------------------------- PUBLIC ------------------------------ */
/**
* Informs all the registered shutdown listeners about the coming
* shutdown.
*/
public static void doShutdownImpl()
{
try
{
((ApplicationUtilsImpl)sInstance).doShutdown();
}
catch (Throwable t)
{
Log.logE("Error in doShutdownImpl: " , t);
}
}
public static void setStandAloneMode()
{
((ApplicationUtilsImpl)sInstance).mStandAlone = true;
}
/**
* @see com.nokia.mj.impl.rt.support.ApplicationUtils#
* releaseStartWaiterImpl().
*/
public static void releaseStartWaiterImpl(boolean doStart)
{
if (Log.mOn) Log.logI("ApplicationUtilsImpl.releaseStartWaiterImpl("
+ doStart + ").");
((ApplicationUtilsImpl)sInstance).releaseStartWaiter(doStart);
}
/**
* @see com.nokia.mj.impl.rt.support.ApplicationUtils#
* notifyExitCmd().
*/
public void notifyExitCmd()
{
// Informs the life cycle about a forceful exit request.
if (Log.mOn) Log.logI("ApplicationUtilsImpl.notifyExitCmd().");
MidletLifeCycle.getInstance().terminateMidletRequest(true);
}
/**
* @see com.nokia.mj.impl.rt.support.ApplicationUtils#
* pauseApplication().
*/
public void pauseApplication()
{
if (Log.mOn) Log.logI("ApplicationUtilsImpl.pauseApplication().");
MidletLifeCycle.getInstance().pauseApplication();
}
/**
* @see com.nokia.mj.impl.rt.support.ApplicationUtils#
* resumeApplication().
*/
public void resumeApplication()
{
if (Log.mOn) Log.logI("ApplicationUtilsImpl.resumeApplication().");
MidletLifeCycle.getInstance().resumeRequest();
}
/**
* @see com.nokia.mj.impl.rt.support.ApplicationUtils#
* checkPermission(java.security.Permission).
*/
public void checkPermission(Permission p)
throws AccessControlException,
NullPointerException
{
if (mStandAlone)
{
// For standalone MIDlet everything is allowed.
return;
}
if (p == null)
{
throw new NullPointerException("Check permission called with null "+
"Permission");
}
if (mAccessController == null)
{
// If this is a first time, get the access controller.
try
{
mAccessController =
AccessControllerFactoryImpl.
getAccessController(ApplicationInfo.getInstance().
getSuiteUid(), ApplicationInfo.
getInstance().getName());
}
catch (Throwable t)
{
throw new AccessControlException("Error creating " +
"AccessControllerFactory. Reason "+t);
}
if (mAccessController == null)
{
throw new AccessControlException("Error in AccessController");
}
}
try
{
// Check the permissions
mAccessController.checkPermission(p);
}
catch (UserCancelException uce)
{
// Do not propagate UserCancelException further,
// throw AccessControlException instead.
if (uce.getRootException() instanceof AccessControlException)
{
throw(AccessControlException)uce.getRootException();
}
else
{
throw new AccessControlException("User cancelled");
}
}
catch (AccessControlException a)
{
throw(a);
}
catch (Throwable t)
{
Log.logE("Error in checking permission: " + p, t);
throw new AccessControlException("Error in " +
"Security impl. Reason "+t);
}
}
/**
* @see com.nokia.mj.impl.rt.support.ApplicationUtils#
* checkPermission(java.security.Permission).
*/
public void checkPermission(Uid appUid,Permission p)
throws AccessControlException,
NullPointerException
{
checkPermission(p);
}
}