SerializablePrincipal (Apache Tomcat 7.0.67 API Documentation)

java.lang.Object
- org.apache.catalina.ha.session.SerializablePrincipal

All Implemented Interfaces:

java.io.Serializable
```
public class SerializablePrincipal
extends java.lang.Object
implements java.io.Serializable
```
Generic implementation of java.security.Principal that is available for use by Realm implementations. The GenericPrincipal does NOT implement serializable and I didn't want to change that implementation hence I implemented this one instead.

Author:

Filip Hanik

See Also:
Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected java.lang.String`	`name` The username of the user represented by this Principal.
`protected java.lang.String`	`password` The authentication credentials for the user represented by this Principal.
`protected Realm`	`realm` The Realm with which this Principal is associated.
`protected java.lang.String[]`	`roles` The set of roles associated with this user.
`protected static StringManager`	`sm` The string manager for this package.
`protected java.security.Principal`	`userPrincipal` The user principal, if present.

Constructor Summary

Constructors
Constructor and Description
`SerializablePrincipal()`
`SerializablePrincipal(java.lang.String name, java.lang.String password)` Construct a new Principal, associated with the specified Realm, for the specified username and password.
`SerializablePrincipal(java.lang.String name, java.lang.String password, java.util.List<java.lang.String> roles)` Construct a new Principal, associated with the specified Realm, for the specified username and password, with the specified role names (as Strings).
`SerializablePrincipal(java.lang.String name, java.lang.String password, java.util.List<java.lang.String> roles, java.security.Principal userPrincipal)` Construct a new Principal, associated with the specified Realm, for the specified username and password, with the specified role names (as Strings).

Method Summary

Methods
Modifier and Type	Method and Description
`static SerializablePrincipal`	`createPrincipal(GenericPrincipal principal)`
`java.lang.String`	`getName()`
`java.lang.String`	`getPassword()`
`GenericPrincipal`	`getPrincipal()`
`Realm`	`getRealm()`
`java.lang.String[]`	`getRoles()`
`static GenericPrincipal`	`readPrincipal(java.io.ObjectInput in)`
`void`	`setRealm(Realm realm)`
`java.lang.String`	`toString()` Return a String representation of this object, which exposes only information that should be public.
`static void`	`writePrincipal(GenericPrincipal p, java.io.ObjectOutput out)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - sm
```
protected static final StringManager sm
```
    The string manager for this package.
  - name
```
protected java.lang.String name
```
    The username of the user represented by this Principal.
  - password
```
protected java.lang.String password
```
    The authentication credentials for the user represented by this Principal.
  - realm
```
protected transient Realm realm
```
    The Realm with which this Principal is associated.
  - roles
```
protected java.lang.String[] roles
```
    The set of roles associated with this user.
  - userPrincipal
```
protected java.security.Principal userPrincipal
```
    The user principal, if present.
- Constructor Detail
  - SerializablePrincipal
```
public SerializablePrincipal()
```
  - SerializablePrincipal
```
public SerializablePrincipal(java.lang.String name,
                     java.lang.String password)
```
    Construct a new Principal, associated with the specified Realm, for the specified username and password.
    
    Parameters:
    name - The username of the user represented by this Principal
    password - Credentials used to authenticate this user
  - SerializablePrincipal
```
public SerializablePrincipal(java.lang.String name,
                     java.lang.String password,
                     java.util.List<java.lang.String> roles)
```
    Construct a new Principal, associated with the specified Realm, for the specified username and password, with the specified role names (as Strings).
    
    Parameters:
    name - The username of the user represented by this Principal
    password - Credentials used to authenticate this user
    roles - List of roles (must be Strings) possessed by this user
  - SerializablePrincipal
```
public SerializablePrincipal(java.lang.String name,
                     java.lang.String password,
                     java.util.List<java.lang.String> roles,
                     java.security.Principal userPrincipal)
```
    Construct a new Principal, associated with the specified Realm, for the specified username and password, with the specified role names (as Strings).
    
    Parameters:
    name - The username of the user represented by this Principal
    password - Credentials used to authenticate this user
    roles - List of roles (must be Strings) possessed by this user
    userPrincipal - The user principal to be exposed to applications
- Method Detail
  - getName
```
public java.lang.String getName()
```
  - getPassword
```
public java.lang.String getPassword()
```
  - getRealm
```
public Realm getRealm()
```
  - setRealm
```
public void setRealm(Realm realm)
```
  - getRoles
```
public java.lang.String[] getRoles()
```
  - toString
```
public java.lang.String toString()
```
    Return a String representation of this object, which exposes only information that should be public.
    
    Overrides:
    
    toString in class java.lang.Object
  - createPrincipal
```
public static SerializablePrincipal createPrincipal(GenericPrincipal principal)
```
  - getPrincipal
```
public GenericPrincipal getPrincipal()
```
  - readPrincipal
```
public static GenericPrincipal readPrincipal(java.io.ObjectInput in)
                                      throws java.io.IOException,
                                             java.lang.ClassNotFoundException
```
    Throws:
    
    java.io.IOException
    
    java.lang.ClassNotFoundException
  - writePrincipal
```
public static void writePrincipal(GenericPrincipal p,
                  java.io.ObjectOutput out)
                           throws java.io.IOException
```
    Throws:
    
    java.io.IOException

Class SerializablePrincipal

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

sm

name

password

realm

roles

userPrincipal

Constructor Detail

SerializablePrincipal

SerializablePrincipal

SerializablePrincipal

SerializablePrincipal

Method Detail

getName

getPassword

getRealm

setRealm

getRoles

toString

createPrincipal

getPrincipal

readPrincipal

writePrincipal