001: /*
002: *
003: *
004: * Copyright 1990-2007 Sun Microsystems, Inc. All Rights Reserved.
005: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
006: *
007: * This program is free software; you can redistribute it and/or
008: * modify it under the terms of the GNU General Public License version
009: * 2 only, as published by the Free Software Foundation.
010: *
011: * This program is distributed in the hope that it will be useful, but
012: * WITHOUT ANY WARRANTY; without even the implied warranty of
013: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
014: * General Public License version 2 for more details (a copy is
015: * included at /legal/license.txt).
016: *
017: * You should have received a copy of the GNU General Public License
018: * version 2 along with this work; if not, write to the Free Software
019: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA
021: *
022: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
023: * Clara, CA 95054 or visit www.sun.com if you need additional
024: * information or have any questions.
025: */
026:
027: package com.sun.midp.installer;
028:
029: /**
030: * Holds the state of an installation, so it can restarted after it has
031: * been stopped.
032: */
033: public interface InstallState {
034: /**
035: * Gets the last recoverable exception that stopped the install.
036: * Non-recoverable exceptions are thrown and not saved in the state.
037: *
038: * @return last exception that stopped the install
039: */
040: public InvalidJadException getLastException();
041:
042: /**
043: * Gets the unique name that the installed suite was stored with.
044: *
045: * @return storage name that can be used to load the suite
046: */
047: public int getID();
048:
049: /**
050: * Sets the username to be used for HTTP authentication.
051: *
052: * @param theUsername 8 bit username, cannot contain a ":"
053: */
054: public void setUsername(String theUsername);
055:
056: /**
057: * Sets the password to be used for HTTP authentication.
058: *
059: * @param thePassword 8 bit password
060: */
061: public void setPassword(String thePassword);
062:
063: /**
064: * Sets the username to be used for HTTP proxy authentication.
065: *
066: * @param theUsername 8 bit username, cannot contain a ":"
067: */
068: public void setProxyUsername(String theUsername);
069:
070: /**
071: * Sets the password to be used for HTTP proxy authentication.
072: *
073: * @param thePassword 8 bit password
074: */
075: public void setProxyPassword(String thePassword);
076:
077: /**
078: * Gets a property of the application to be installed.
079: * First from the JAD, then if not found, the JAR manifest.
080: *
081: * @param key key of the property
082: *
083: * @return value of the property or null if not found
084: */
085: public String getAppProperty(String key);
086:
087: /**
088: * Gets the URL of the JAR.
089: *
090: * @return URL of the JAR
091: */
092: public String getJarUrl();
093:
094: /**
095: * Gets the label for the downloaded JAR.
096: *
097: * @return suite name
098: */
099: public String getSuiteName();
100:
101: /**
102: * Gets the expected size of the JAR.
103: *
104: * @return size of the JAR in K bytes
105: */
106: public int getJarSize();
107:
108: /**
109: * Gets the authoriztion path of this suite. The path starts with
110: * the most trusted CA that authorized this suite.
111: *
112: * @return array of CA names or null if the suite was not signed
113: */
114: public String[] getAuthPath();
115: }
|