/*
*
*
* 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.installer;
/** Enables a MIDlet to respond installation warnings and status updates. */
public interface InstallListener {
/**
* Called with the current state of the install so the user can be
* asked to override the warning. To get the warning from the state
* call {@link InstallState#getLastException()}. If false is returned,
* the last exception in the state will be thrown and
* {@link Installer#wasStopped()} will return true if called.
*
* @param state current state of the install.
*
* @return true if the user wants to continue, false to stop the install
*/
public boolean warnUser(InstallState state);
/**
* Called with the current state of the install so the user can be
* asked to confirm the jar download.
* If false is returned, the an I/O exception thrown and
* {@link Installer#wasStopped()} will return true if called.
*
* @param state current state of the install.
*
* @return true if the user wants to continue, false to stop the install
*/
public boolean confirmJarDownload(InstallState state);
/**
* Called with the current status of the install. See
* {@link Installer} for the status codes.
*
* @param status current status of the install.
* @param state current state of the install.
*/
public void updateStatus(int status, InstallState state);
/**
* Called with the current state of the install so the user can be
* asked to confirm if the RMS data should be kept for new version of
* an updated suite.
* If false is returned, the an I/O exception thrown and
* {@link Installer#wasStopped()} will return true if called.
*
* @param state current state of the install.
*
* @return true if the user wants to keep the RMS data for the next suite
*/
public boolean keepRMS(InstallState state);
/**
* Called with the current state of the install so the user can be
* asked to confirm the authentication path.
* If false is returned, the an I/O exception thrown and
* {@link Installer#wasStopped()} will return true if called.
*
* @param state current state of the install.
*
* @return true if the user wants to continue, false to stop the install
*/
public boolean confirmAuthPath(InstallState state);
}
|