Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 32fe410a authored by Steve Block's avatar Steve Block
Browse files

Improve JavaDoc for saved username/password pairs

Change-Id: Ief079666eb1250f0a57089c778669b638a259194
parent e09e976d
Loading
Loading
Loading
Loading
+6 −2
Original line number Diff line number Diff line
@@ -582,12 +582,16 @@ public class WebView extends AbsoluteLayout
    //-------------------------------------------------------------------------

    /**
     * Saves the username and password for a particular host in this WebView's
     * internal database.
     * Sets a username and password pair for the specified host. This data is
     * used by the Webview to autocomplete username and password fields in web
     * forms. Note that this is unrelated to the credentials used for HTTP
     * authentication.
     *
     * @param host the host that required the credentials
     * @param username the username for the given host
     * @param password the password for the given host
     * @see WebViewDatabase#clearUsernamePassword
     * @see WebViewDatabase#hasUsernamePassword
     */
    public void savePassword(String host, String username, String password) {
        checkThread();
+11 −6
Original line number Diff line number Diff line
@@ -23,7 +23,7 @@ import android.content.Context;
 * application has stored any of the following types of browsing data and
 * to clear any such stored data for all WebViews in the application.
 * <ul>
 *  <li>Username/password pairs entered into web forms</li>
 *  <li>Username/password pairs for web forms</li>
 *  <li>HTTP authentication username/password pairs</li>
 *  <li>Data entered into text fields (e.g. for autocomplete suggestions)</li>
 * </ul>
@@ -43,18 +43,23 @@ public class WebViewDatabase {
    }

    /**
     * Gets whether there are any username/password combinations
     * from web pages saved.
     * Gets whether there are any saved username/password pairs for web forms.
     * Note that these are unrelated to HTTP authentication credentials.
     *
     * @return true if there are any username/passwords used in web
     *         forms saved
     * @return true if there are any saved username/password pairs
     * @see WebView#savePassword
     * @see clearUsernamePassword
     */
    public boolean hasUsernamePassword() {
        throw new MustOverrideException();
    }

    /**
     * Clears any username/password combinations saved from web forms.
     * Clears any saved username/password pairs for web forms.
     * Note that these are unrelated to HTTP authentication credentials.
     *
     * @see WebView#savePassword
     * @see hasUsernamePassword
     */
    public void clearUsernamePassword() {
        throw new MustOverrideException();