org.apache.shiro.authc
Interface MergableAuthenticationInfo

All Superinterfaces:
AuthenticationInfo, Serializable
All Known Implementing Classes:
SimpleAccount, SimpleAuthenticationInfo

public interface MergableAuthenticationInfo
extends AuthenticationInfo

An extension of the AuthenticationInfo interface to be implemented by classes that support merging with other AuthenticationInfo instances.

This allows an instance of this class to be an aggregation, or composition of account data from across multiple Realms Realms, not just one realm.

This is useful in a multi-realm authentication configuration - the individual AuthenticationInfo objects obtained from each realm can be merged into a single instance. This instance can then be returned at the end of the authentication process, giving the impression of a single underlying realm/data source.

Since:
0.9

Method Summary
 void merge(AuthenticationInfo info)
          Merges the given AuthenticationInfo into this instance.
 
Methods inherited from interface org.apache.shiro.authc.AuthenticationInfo
getCredentials, getPrincipals
 

Method Detail

merge

void merge(AuthenticationInfo info)
Merges the given AuthenticationInfo into this instance. The specific way that the merge occurs is up to the implementation, but typically it involves combining the principals and credentials together in this instance. The info argument should not be modified in any way.

Parameters:
info - the info that should be merged into this instance.


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