PasswordCredential


1   /*
2    * The contents of this file are subject to the terms 
3    * of the Common Development and Distribution License 
4    * (the License).  You may not use this file except in
5    * compliance with the License.
6    * 
7    * You can obtain a copy of the license at 
8    * https://glassfish.dev.java.net/public/CDDLv1.0.html or
9    * glassfish/bootstrap/legal/CDDLv1.0.txt.
10   * See the License for the specific language governing 
11   * permissions and limitations under the License.
12   * 
13   * When distributing Covered Code, include this CDDL 
14   * Header Notice in each file and include the License file 
15   * at glassfish/bootstrap/legal/CDDLv1.0.txt.  
16   * If applicable, add the following below the CDDL Header, 
17   * with the fields enclosed by brackets [] replaced by
18   * you own identifying information: 
19   * "Portions Copyrighted [year] [name of copyright owner]"
20   * 
21   * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
22   */
23  
24  package javax.resource.spi.security;
25  
26  import javax.resource.spi.ManagedConnectionFactory  ;
27  
28  /**
29   * The class PasswordCredential acts as a holder for username and
30   * password.
31   *
32   * @see javax.resource.spi.ManagedConnectionFactory
33   *
34   * @author  Rahul Sharma
35   * @version 0.6
36   * @since   0.6
37   */
38  
39  public final class PasswordCredential implements java.io.Serializable   {
40  
41    private String   userName;
42    private char[] password;
43    private ManagedConnectionFactory   mcf;
44  
45    /**
46     * Creates a new <code>PasswordCredential</code> object from the given
47     * user name and password.
48     *
49     * <p> Note that the given user password is cloned before it is stored in
50     * the new <code>PasswordCredential</code> object.
51     *
52     * @param userName the user name
53     * @param password the user's password
54    **/
55    public 
56    PasswordCredential(String   userName, char[] password) {
57      this.userName = userName;
58      this.password = (char[])password.clone();
59    }
60  
61    /**
62     * Returns the user name.
63     *
64     * @return the user name
65    **/
66    public 
67    String   getUserName() {
68      return userName;
69    }
70  
71    /**
72     * Returns the user password.
73     *
74     * <p> Note that this method returns a reference to the password. It is
75     * the caller's responsibility to zero out the password information after
76     * it is no longer needed.
77     *
78     * @return the password
79    **/
80    public 
81    char[] getPassword() {
82      return password;
83    }
84  
85    /** Gets the target ManagedConnectionFactory for which the user name and 
86     *  password has been set by the application server. A ManagedConnection-
87     *  Factory uses this field to find out whether PasswordCredential should
88     *  be used by it for sign-on to the target EIS instance.
89     *
90     *  @return    ManagedConnectionFactory instance for which user name and
91     *             password have been specified
92     **/
93    public
94    ManagedConnectionFactory   getManagedConnectionFactory() {
95      return mcf;
96    }
97  
98   /**  Sets the target ManagedConenctionFactory instance for which the user 
99    *   name and password has been set by the application server.
100    *
101    *  @param     mcf   ManagedConnectionFactory instance for which user name
102    *                   and password have been specified
103    **/
104   public
105   void setManagedConnectionFactory(ManagedConnectionFactory   mcf) {
106     this.mcf = mcf;
107   }
108 
109   /** Compares this PasswordCredential with the specified object for 
110    *  equality. The two PasswordCredential instances are the same if
111    *  they are equal in username and password.
112    *
113    *  @param other  Object to which PasswordCredential is to be compared
114    *  @return <tt>true</tt> if and if the specified object is a
115    *            PasswordCredential whose username and password are
116    *            equal to this instance.
117   **/
118   public 
119   boolean equals(Object   other) {
120     if (!(other instanceof PasswordCredential  ))
121       return false;
122 
123     PasswordCredential   pc = (PasswordCredential  )other;
124 
125     if (!(userName.equals(pc.userName)))
126       return false;
127 
128     if (password.length != pc.password.length)
129       return false;
130     
131     for (int i = 0; i < password.length;i++) {
132       if (password[i] != pc.password[i]) 
133     return false;
134     }
135 
136     return true;
137   }
138 
139   /** Returns the hash code for this PasswordCredential
140    * 
141    *  @return  hash code for this PasswordCredential
142   **/
143   public
144   int hashCode() {
145     String   s = userName;
146     s += new String  (password);
147     return s.hashCode();
148   }
149 
150 }
151 
152
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Free Books Free Magazines
Popular Tags