0N/A/*
3261N/A * Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
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
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
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 *
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,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage com.sun.security.auth;
0N/A
0N/Aimport java.security.Principal;
0N/Aimport javax.naming.InvalidNameException;
0N/Aimport javax.naming.ldap.LdapName;
0N/A
0N/A/**
0N/A * A principal identified by a distinguished name as specified by
2507N/A * <a href="http://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>.
0N/A *
0N/A * <p>
0N/A * After successful authentication, a user {@link java.security.Principal}
0N/A * can be associated with a particular {@link javax.security.auth.Subject}
0N/A * to augment that <code>Subject</code> with an additional identity.
0N/A * Authorization decisions can then be based upon the
0N/A * <code>Principal</code>s that are associated with a <code>Subject</code>.
0N/A *
0N/A * <p>
0N/A * This class is immutable.
0N/A *
0N/A * @since 1.6
0N/A */
0N/Apublic final class LdapPrincipal implements Principal, java.io.Serializable {
0N/A
0N/A private static final long serialVersionUID = 6820120005580754861L;
0N/A
0N/A /**
0N/A * The principal's string name
0N/A *
0N/A * @serial
0N/A */
0N/A private final String nameString;
0N/A
0N/A /**
0N/A * The principal's name
0N/A *
0N/A * @serial
0N/A */
0N/A private final LdapName name;
0N/A
0N/A /**
0N/A * Creates an LDAP principal.
0N/A *
0N/A * @param name The principal's string distinguished name.
0N/A * @throws InvalidNameException If a syntax violation is detected.
0N/A * @exception NullPointerException If the <code>name</code> is
0N/A * <code>null</code>.
0N/A */
0N/A public LdapPrincipal(String name) throws InvalidNameException {
0N/A if (name == null) {
0N/A throw new NullPointerException("null name is illegal");
0N/A }
0N/A this.name = getLdapName(name);
0N/A nameString = name;
0N/A }
0N/A
0N/A /**
0N/A * Compares this principal to the specified object.
0N/A *
0N/A * @param object The object to compare this principal against.
0N/A * @return true if they are equal; false otherwise.
0N/A */
0N/A public boolean equals(Object object) {
0N/A if (this == object) {
0N/A return true;
0N/A }
0N/A if (object instanceof LdapPrincipal) {
0N/A try {
0N/A
0N/A return
0N/A name.equals(getLdapName(((LdapPrincipal)object).getName()));
0N/A
0N/A } catch (InvalidNameException e) {
0N/A return false;
0N/A }
0N/A }
0N/A return false;
0N/A }
0N/A
0N/A /**
0N/A * Computes the hash code for this principal.
0N/A *
0N/A * @return The principal's hash code.
0N/A */
0N/A public int hashCode() {
0N/A return name.hashCode();
0N/A }
0N/A
0N/A /**
0N/A * Returns the name originally used to create this principal.
0N/A *
0N/A * @return The principal's string name.
0N/A */
0N/A public String getName() {
0N/A return nameString;
0N/A }
0N/A
0N/A /**
0N/A * Creates a string representation of this principal's name in the format
2507N/A * defined by <a href="http://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>.
0N/A * If the name has zero components an empty string is returned.
0N/A *
0N/A * @return The principal's string name.
0N/A */
0N/A public String toString() {
0N/A return name.toString();
0N/A }
0N/A
0N/A // Create an LdapName object from a string distinguished name.
0N/A private LdapName getLdapName(String name) throws InvalidNameException {
0N/A return new LdapName(name);
0N/A }
0N/A}