IdentityScope.java revision 2195
2362N/A * Copyright 1996-2006 Sun Microsystems, Inc. All Rights Reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 0N/A * published by the Free Software Foundation. Sun designates this 0N/A * particular file as subject to the "Classpath" exception as provided 0N/A * by Sun in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 2362N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, 0N/A * CA 95054 USA or visit www.sun.com if you need additional information or 0N/A * have any questions. 0N/A * <p>This class represents a scope for identities. It is an Identity 0N/A * itself, and therefore has a name and can have a scope. It can also 0N/A * optionally have a public key and associated certificates. 0N/A * <p>An IdentityScope can contain Identity objects of all kinds, including 0N/A * Signers. All types of Identity objects can be retrieved, added, and 0N/A * removed using the same methods. Note that it is possible, and in fact 0N/A * expected, that different types of identity scopes will 0N/A * apply different policies for their various operations on the 0N/A * various types of Identities. 0N/A * <p>There is a one-to-one mapping between keys and identities, and 0N/A * there can only be one copy of one key per scope. For example, suppose 0N/A * <b>Acme Software, Inc</b> is a software publisher known to a user. 0N/A * Suppose it is an Identity, that is, it has a public key, and a set of 0N/A * associated certificates. It is named in the scope using the name 0N/A * "Acme Software". No other named Identity in the scope has the same 0N/A * public key. Of course, none has the same name as well. * @author Benjamin Renaud * @deprecated This class is no longer used. Its functionality has been * replaced by <code>java.security.KeyStore</code>, the * <code>java.security.cert</code> package, and * <code>java.security.Principal</code>. // initialize the system scope //Security.error("unable to establish a system scope from " + * This constructor is used for serialization only and should not * Constructs a new identity scope with the specified name. * @param name the scope name. * Constructs a new identity scope with the specified name and scope. * @param name the scope name. * @param scope the scope for the new identity scope. * @exception KeyManagementException if there is already an identity * with the same name in the scope. * Returns the system's identity scope. * @return the system's identity scope, or {@code null} if none has been * Sets the system's identity scope. * <p>First, if there is a security manager, its * <code>checkSecurityAccess</code> * method is called with <code>"setSystemScope"</code> * as its argument to see if it's ok to set the identity scope. * @param scope the scope to set. * @exception SecurityException if a security manager exists and its * <code>checkSecurityAccess</code> method doesn't allow * setting the identity scope. * @see SecurityManager#checkSecurityAccess * Returns the number of identities within this identity scope. * @return the number of identities within this identity scope. public abstract int size();
* Returns the identity in this scope with the specified name (if any). * @param name the name of the identity to be retrieved. * @return the identity named <code>name</code>, or null if there are * no identities named <code>name</code> in this scope. * Retrieves the identity whose name is the same as that of the * specified principal. (Note: Identity implements Principal.) * @param principal the principal corresponding to the identity * @return the identity whose name is the same as that of the * principal, or null if there are no identities of the same name * Retrieves the identity with the specified public key. * @param key the public key for the identity to be returned. * @return the identity with the given key, or null if there are * no identities in this scope with that key. * Adds an identity to this identity scope. * @param identity the identity to be added. * @exception KeyManagementException if the identity is not * valid, a name conflict occurs, another identity has the same * public key as the identity being added, or another exception * Removes an identity from this identity scope. * @param identity the identity to be removed. * @exception KeyManagementException if the identity is missing, * or another exception occurs. * Returns an enumeration of all identities in this identity scope. * @return an enumeration of all identities in this identity scope. * Returns a string representation of this identity scope, including * its name, its scope name, and the number of identities in this * @return a string representation of this identity scope.