1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127
/* * @(#)PasswordCallback.java 1.19 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.security.auth.callback; /** * <p> Underlying security services instantiate and pass a * <code>PasswordCallback</code> to the <code>handle</code> * method of a <code>CallbackHandler</code> to retrieve password information. * * @version 1.19, 11/17/05 * @see javax.security.auth.callback.CallbackHandler */ public class PasswordCallback implements Callback, java.io.Serializable { private static final long serialVersionUID = 2267422647454909926L; /** * @serial * @since 1.4 */ private String prompt; /** * @serial * @since 1.4 */ private boolean echoOn; /** * @serial * @since 1.4 */ private char[] inputPassword; /** * Construct a <code>PasswordCallback</code> with a prompt * and a boolean specifying whether the password should be displayed * as it is being typed. * * <p> * * @param prompt the prompt used to request the password. <p> * * @param echoOn true if the password should be displayed * as it is being typed. * * @exception IllegalArgumentException if <code>prompt</code> is null or * if <code>prompt</code> has a length of 0. */ public PasswordCallback(String prompt, boolean echoOn) { if (prompt == null || prompt.length() == 0) throw new IllegalArgumentException(); this.prompt = prompt; this.echoOn = echoOn; } /** * Get the prompt. * * <p> * * @return the prompt. */ public String getPrompt() { return prompt; } /** * Return whether the password * should be displayed as it is being typed. * * <p> * * @return the whether the password * should be displayed as it is being typed. */ public boolean isEchoOn() { return echoOn; } /** * Set the retrieved password. * * <p> This method makes a copy of the input <i>password</i> * before storing it. * * <p> * * @param password the retrieved password, which may be null. * * @see #getPassword */ public void setPassword(char[] password) { this.inputPassword = (password == null ? null : (char[])password.clone()); } /** * Get the retrieved password. * * <p> This method returns a copy of the retrieved password. * * <p> * * @return the retrieved password, which may be null. * * @see #setPassword */ public char[] getPassword() { return (inputPassword == null? null : (char[])inputPassword.clone()); } /** * Clear the retrieved password. */ public void clearPassword() { if (inputPassword != null) { for (int i = 0; i < inputPassword.length; i++) inputPassword[i] = ' '; } } }