org.apache.ws.security
Class WSUsernameTokenPrincipal

java.lang.Object
  extended by org.apache.ws.security.WSUsernameTokenPrincipal
All Implemented Interfaces:
Serializable, Principal

public class WSUsernameTokenPrincipal
extends Object
implements Principal, Serializable

This class implements the Principal interface and represents a UsernameToken user.

In addition to the principal's name this principal object also contains the nonce and created time of the UsernameToken (refer to the OASIS WS Security specification, UsernameToken profile). These values are set only if the password of UsernameToken was of type PasswordDigest.

Furthermore the password type is provided to the application. The password type is the string of the type attribute of the password element inside the username token. Refer to the OASIS WSS specification for predefined password types.

The equals() method use the prinicipal's name only and does not compare nonce or created time.

Modelled according to the example provided by JAAS documentation

Author:
Davanum Srinivas (dims@yahoo.com)., Werner Dittmann (Werner.Dittmann@siemens.com).
See Also:
Principal, Subject, Serialized Form

Constructor Summary
WSUsernameTokenPrincipal(String name, boolean digest)
          Create a WSUsernameTokenPrincipal with a WSUsernameToken username.
 
Method Summary
 boolean equals(Object o)
          Compares the specified Object with this WSUsernameTokenPrincipal for equality.
 String getCreatedTime()
          Return the WSUsernameToken created time for this WSUsernameTokenPrincipal.
 String getName()
          Return the WSUsernameToken username for this WSUsernameTokenPrincipal.
 String getNonce()
          Return the WSUsernameToken nonce for this WSUsernameTokenPrincipal.
 String getPassword()
          Return the WSUsernameToken password for this WSUsernameTokenPrincipal.
 String getPasswordType()
           
 int hashCode()
          Return a hash code for this WSUsernameTokenPrincipal.
 boolean isPasswordDigest()
          Return the WSUsernameToken password type for this WSUsernameTokenPrincipal.
 void setCreatedTime(String createdTime)
          Set the WSUsernameToken created time for this WSUsernameTokenPrincipal.
 void setNonce(String nonce)
          Set the WSUsernameToken nonce for this WSUsernameTokenPrincipal.
 void setPassword(String password)
          Set the WSUsernameToken password for this WSUsernameTokenPrincipal.
 void setPasswordType(String passwordType)
           
 String toString()
          Return a string representation of this WSUsernameTokenPrincipal.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

WSUsernameTokenPrincipal

public WSUsernameTokenPrincipal(String name,
                                boolean digest)
Create a WSUsernameTokenPrincipal with a WSUsernameToken username.

Parameters:
name - the WSUsernameToken username for this user.
Method Detail

getName

public String getName()
Return the WSUsernameToken username for this WSUsernameTokenPrincipal.

Specified by:
getName in interface Principal
Returns:
the WSUsernameToken username for this WSUsernameTokenPrincipal

isPasswordDigest

public boolean isPasswordDigest()
Return the WSUsernameToken password type for this WSUsernameTokenPrincipal.

Returns:
true if the password type was PassowrdDigest

setPassword

public void setPassword(String password)
Set the WSUsernameToken password for this WSUsernameTokenPrincipal.

Parameters:
password -

getPassword

public String getPassword()
Return the WSUsernameToken password for this WSUsernameTokenPrincipal.

Returns:
the WSUsernameToken password for this WSUsernameTokenPrincipal

setNonce

public void setNonce(String nonce)
Set the WSUsernameToken nonce for this WSUsernameTokenPrincipal.

Parameters:
nonce -

getNonce

public String getNonce()
Return the WSUsernameToken nonce for this WSUsernameTokenPrincipal.

Returns:
the WSUsernameToken nonce for this WSUsernameTokenPrincipal

setCreatedTime

public void setCreatedTime(String createdTime)
Set the WSUsernameToken created time for this WSUsernameTokenPrincipal.

Parameters:
createdTime -

getCreatedTime

public String getCreatedTime()
Return the WSUsernameToken created time for this WSUsernameTokenPrincipal.

Returns:
the WSUsernameToken created time for this WSUsernameTokenPrincipal

toString

public String toString()
Return a string representation of this WSUsernameTokenPrincipal.

Specified by:
toString in interface Principal
Overrides:
toString in class Object
Returns:
a string representation of this WSUsernameTokenPrincipal.

getPasswordType

public String getPasswordType()
Returns:
Returns the passwordType.

setPasswordType

public void setPasswordType(String passwordType)
Parameters:
passwordType - The passwordType to set.

equals

public boolean equals(Object o)
Compares the specified Object with this WSUsernameTokenPrincipal for equality. Returns true if the given object is also a WSUsernameTokenPrincipal and the two WSUsernameTokenPrincipals have the same username.

Specified by:
equals in interface Principal
Overrides:
equals in class Object
Parameters:
o - Object to be compared for equality with this WSUsernameTokenPrincipal.
Returns:
true if the specified Object is equal equal to this WSUsernameTokenPrincipal.

hashCode

public int hashCode()
Return a hash code for this WSUsernameTokenPrincipal.

Specified by:
hashCode in interface Principal
Overrides:
hashCode in class Object
Returns:
a hash code for this WSUsernameTokenPrincipal.


Copyright © 2004-2013 The Apache Software Foundation. All Rights Reserved.