之前使用過的（來點印象）

login("classpath:shiro-authenticator-all-success.ini");
Subject subject = SecurityUtils.getSubject();
//得到一個身份集合，其包含了Realm驗證成功的身份資訊
PrincipalCollection principalCollection = subject.getPrincipals();
Assert.assertEquals(2, principalCollection.asList().size());

protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
	String username = (String) principals.getPrimaryPrincipal();
	SimpleAuthorizationInfo authorizationInfo = new SimpleAuthorizationInfo();
	authorizationInfo.setRoles(userService.findRoles(username));
	authorizationInfo.setStringPermissions(userService.findPermissions(username));
	return authorizationInfo;
}
 

PrincipalCollection是一個身份集合，因為我們可以在Shiro中同時配置多個Realm，所以呢身份資訊可能就有多個；因此其提供了PrincipalCollection用於聚合這些身份資訊：

public interface PrincipalCollection extends Iterable, Serializable {
	Object getPrimaryPrincipal(); //得到主要的身份
	<T> T oneByType(Class<T> type); //根據身份型別獲取第一個
	<T> Collection<T> byType(Class<T> type); //根據身份型別獲取一組
	List asList(); //轉換為List
	Set asSet(); //轉換為Set
	Collection fromRealm(String realmName); //根據Realm名字獲取
	Set<String> getRealmNames(); //獲取所有身份驗證通過的Realm名字
	boolean isEmpty(); //判斷是否為空
}
 

因為PrincipalCollection聚合了多個，此處最需要注意的是getPrimaryPrincipal，如果只有一個Principal 那麼直接返回即可，如果有多個Principal，則返回第一個（因為內部使用Map儲存，所以可以認為是返回任意一個）；oneByType / byType根據憑據的型別返回相應的Principal；fromRealm 根據Realm 名字（每個Principal 都與一個Realm 關聯）獲取相應的Principal。

MutablePrincipalCollection是一個可變的PrincipalCollection介面，即提供瞭如下可變方法：

public interface MutablePrincipalCollection extends PrincipalCollection {
	void add(Object principal, String realmName); //新增Realm-Principal的關聯
	void addAll(Collection principals, String realmName); //新增一組Realm-Principal的關聯
	void addAll(PrincipalCollection principals);//新增PrincipalCollection
	void clear();//清空
}
 

目前Shiro只提供了一個實現SimplePrincipalCollection，還記得之前的AuthenticationStrategy實現嘛，用於在多Realm 時判斷是否滿足條件的，在大多數實現中（繼承了
AbstractAuthenticationStrategy）afterAttempt 方法會進行AuthenticationInfo（實現了MergableAuthenticationInfo）的merge，比如SimpleAuthenticationInfo 會合並多個Principal為一個PrincipalCollection。

示例：

1. 準備三個Realm

public class MyRealm1 implements Realm{
	public AuthenticationInfo getAuthenticationInfo(AuthenticationToken arg0) throws AuthenticationException {
		SimpleAuthenticationInfo simpleAuthenticationInfo = new SimpleAuthenticationInfo(
				"zhang",	//身份 字串型別
				"123",		//憑據
				getName()	//Realm Name
		);
		return simpleAuthenticationInfo;
	}
	public String getName() {
		return "a";	//realm name為"a"
	}
	public boolean supports(AuthenticationToken token) {
		return token instanceof UsernamePasswordToken;
	}
}

和MyRealm1完全一樣，只是Realm名字為b

3. MyRealm3

public class MyRealm3 implements Realm{
	public AuthenticationInfo getAuthenticationInfo(AuthenticationToken arg0) throws AuthenticationException {
		User user = new User("zhang","123");
		SimpleAuthenticationInfo simpleAuthenticationInfo = new SimpleAuthenticationInfo(
				user,	//身份User型別 
				"123",		//憑據
				getName()	//Realm Name
		);
		return simpleAuthenticationInfo;
	}
	public String getName() {
		return "c";	//realm name為"c"
	}
	public boolean supports(AuthenticationToken token) {
		return token instanceof UsernamePasswordToken;
	}
}

4. ini配置（shiro-multirealm.ini）

[main]
realm1=chapter6.realm.MyRealm1
realm2=chapter6.realm.MyRealm2
realm3=chapter6.realm.MyRealm3
securityManager.realms=$realm1,$realm2,$realm3

5. 測試用例

因為我們的Realm 中沒有進行身份及憑據驗證，所以相當於身份驗證都是成功的，都將返回.

public class PrincialCollectionTest {
	@Test
	public void test(){
		//因為Realm裡沒有進行驗證，所以相當於每個Realm都身份驗證成功了
		login("classpath:chapter6/ini/shiro-multirealm.ini","zhang","123");
		Subject subject = SecurityUtils.getSubject();
		/*
		 * 我們可以直接呼叫subject.getPrincipal獲取PrimaryPrincipal（即所謂的第一個）；
		 * 或者通過subject.getPrincipals獲取PrincipalCollection；然後通過其getPrimaryPrincipal獲取PrimaryPrincipal。
		 */
		Object primaryPrincipal1 = subject.getPrincipal();
		PrincipalCollection principalCollection = subject.getPrincipals();
		/*
		 * 返回第一個，但內部是Map儲存，所以可以理解為隨機返回
		 */
		Object primaryPrincipal2 = principalCollection.getPrimaryPrincipal();
		//但是因為多個Realm都返回了Principal，所以此處到底是哪個是不確定的
		Assert.assertEquals(primaryPrincipal1, primaryPrincipal2);
		/*
		 * 獲取所有身份驗證成功的Realm名字。返回a b c
		 */
		Set<String> realmNames = principalCollection.getRealmNames();
		System.out.println(realmNames);
		//==>[a, b, c]
		/*
		 * 因為MyRealm1和MyRealm2返回的憑據都是zhang，所以排重了
		 */
		//asList和asSet的結果是一樣的,因為將身份資訊轉換為Set/List，即使轉換為List，也是先轉換為Set再完成的。
		Set<Object> principals = principalCollection.asSet();
		System.out.println(principals);
		//==>[zhang, User {id=null, username=zhang, password=123, salt=null, locked=false}]
		/*
		 * 根據Realm名字獲取身份，因為Realm名字可以重複，所以可能多個身份，建議Realm名字儘量不要重複。
		 */
		Collection<User> users = principalCollection.fromRealm("c");
		System.out.println(users);
		//==>[User {id=null, username=zhang, password=123, salt=null, locked=false}]
	}
	public void login(String configFile,String username,String password){
		//1. 獲取SecurityManager工廠，此處使用Ini配置檔案初始化SecurityManager
		Factory<SecurityManager> factory = new IniSecurityManagerFactory(configFile);
		//2. 得到SecurityManager例項，並繫結給SecurityUtils
		SecurityManager securityManager = factory.getInstance();
		SecurityUtils.setSecurityManager(securityManager);
		//3. 得到Subject及建立使用者名稱/密碼身份驗證Token（即使用者身份/憑證）
		Subject subject = SecurityUtils.getSubject();
		UsernamePasswordToken token = new UsernamePasswordToken(username,password);
		subject.login(token);
	}
}