1 /** 2 * This file Copyright (c) 2003-2018 Magnolia International 3 * Ltd. (http://www.magnolia-cms.com). All rights reserved. 4 * 5 * 6 * This file is dual-licensed under both the Magnolia 7 * Network Agreement and the GNU General Public License. 8 * You may elect to use one or the other of these licenses. 9 * 10 * This file is distributed in the hope that it will be 11 * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the 12 * implied warranty of MERCHANTABILITY or FITNESS FOR A 13 * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT. 14 * Redistribution, except as permitted by whichever of the GPL 15 * or MNA you select, is prohibited. 16 * 17 * 1. For the GPL license (GPL), you can redistribute and/or 18 * modify this file under the terms of the GNU General 19 * Public License, Version 3, as published by the Free Software 20 * Foundation. You should have received a copy of the GNU 21 * General Public License, Version 3 along with this program; 22 * if not, write to the Free Software Foundation, Inc., 51 23 * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 24 * 25 * 2. For the Magnolia Network Agreement (MNA), this file 26 * and the accompanying materials are made available under the 27 * terms of the MNA which accompanies this distribution, and 28 * is available at http://www.magnolia-cms.com/mna.html 29 * 30 * Any modifications to this file must keep this entire header 31 * intact. 32 * 33 */ 34 package info.magnolia.cms.security.auth; 35 36 37 import java.security.Principal; 38 import java.util.ArrayList; 39 import java.util.Collection; 40 import java.util.Iterator; 41 42 import org.apache.commons.lang3.StringUtils; 43 import org.apache.commons.lang3.builder.ToStringBuilder; 44 import org.apache.commons.lang3.builder.ToStringStyle; 45 46 47 /** 48 * Principal collection implementation based on simple list. Collection is managed externally. 49 */ 50 public class PrincipalCollectionImpl implements PrincipalCollection { 51 52 private static final String NAME = "PrincipalCollection"; 53 54 /** 55 * Collection of principal objects. 56 */ 57 private final Collection<Principal> collection; 58 59 private String name; 60 61 public PrincipalCollectionImpl() { 62 this.collection = new ArrayList<Principal>(); 63 } 64 65 public PrincipalCollectionImpl(Collection<Principal> principals) { 66 this.collection = principals; 67 } 68 69 /** 70 * Gets name given to this principal. 71 */ 72 @Override 73 public String getName() { 74 if (StringUtils.isEmpty(this.name)) { 75 return NAME; 76 } 77 return this.name; 78 } 79 80 /** 81 * Sets this principal name. 82 */ 83 @Override 84 public void setName(String name) { 85 this.name = name; 86 } 87 88 /** 89 * Sets internal collection of principals. 90 * 91 * @deprecated since 4.5 92 */ 93 @Override 94 @Deprecated 95 public void set(Collection<Principal> collection) { 96 throw new UnsupportedOperationException("use addAll() instead"); 97 } 98 99 /** 100 * Adds principal to the internal collection of principals. 101 * 102 * @param principal to be added to the collection 103 */ 104 @Override 105 public void add(Principal principal) { 106 this.collection.add(principal); 107 } 108 109 /** 110 * Adds principals to the internal collection of principals. 111 * 112 * @param principal to be added to the collection 113 */ 114 @Override 115 public void addAll(Collection<Principal> principal) { 116 this.collection.addAll(principal); 117 } 118 119 /** 120 * Removes principal from the collection if present or does nothing in case principal was not present in the collection. 121 * 122 * @param principal to be removed from the collection 123 */ 124 @Override 125 public void remove(Principal principal) { 126 this.collection.remove(principal); 127 } 128 129 /** 130 * removes all principals from the collection. 131 */ 132 @Override 133 public void clearAll() { 134 this.collection.clear(); 135 } 136 137 /** 138 * Checks if this collection contains specified principal. 139 * 140 * @return true if the specified object exist in the collection, false otherwise. 141 */ 142 @Override 143 public boolean contains(Principal principal) { 144 return this.collection.contains(principal); 145 } 146 147 /** 148 * Checks if this collection contains principal with the specified name. 149 * 150 * @return true if the collection contains the principal by the specified name, false otherwise. 151 */ 152 @Override 153 public boolean contains(String name) { 154 return this.get(name) != null; 155 } 156 157 /** 158 * Gets principal associated to the specified name from the collection. 159 * 160 * @return principal object associated to the specified name. 161 */ 162 @Override 163 public Principal get(String name) { 164 //TODO: change internal collection to a map and store names as keys to avoid loops !!!! 165 Iterator<Principal> principalIterator = this.collection.iterator(); 166 while (principalIterator.hasNext()) { 167 Principal principal = principalIterator.next(); 168 if (StringUtils.equalsIgnoreCase(name, principal.getName())) { 169 return principal; 170 } 171 } 172 return null; 173 } 174 175 /** 176 * @return collection of principals 177 */ 178 @Override 179 public Collection<Principal> getCollection() { 180 return collection; 181 } 182 183 /** 184 * Returns an iterator over the collection of principals. 185 * 186 * @return iterator for Principal objects 187 */ 188 @Override 189 public Iterator<Principal> iterator() { 190 return collection.iterator(); 191 } 192 193 /** 194 * @see java.lang.Object#toString() 195 */ 196 @Override 197 public String toString() { 198 return new ToStringBuilder(this, ToStringStyle.SHORT_PREFIX_STYLE).append("name", getName()).toString(); 199 } 200 }