1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116
/* * @(#)JMXPrincipal.java 1.15 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.management.remote; import java.io.Serializable; import java.security.Principal; /** * <p>The identity of a remote client of the JMX Remote API.</p> * * <p>Principals such as this <code>JMXPrincipal</code> * may be associated with a particular <code>Subject</code> * to augment that <code>Subject</code> with an additional * identity. Refer to the {@link javax.security.auth.Subject} * class for more information on how to achieve this. * Authorization decisions can then be based upon * the Principals associated with a <code>Subject</code>. * * @see java.security.Principal * @see javax.security.auth.Subject * @since 1.5 * @since.unbundled 1.0 */ public class JMXPrincipal implements Principal, Serializable { private static final long serialVersionUID = -4184480100214577411L; /** * @serial The JMX Remote API name for the identity represented by * this <code>JMXPrincipal</code> object. * @see #getName() */ private String name; /** * <p>Creates a JMXPrincipal for a given identity.</p> * * @param name the JMX Remote API name for this identity. * * @exception NullPointerException if the <code>name</code> is * <code>null</code>. */ public JMXPrincipal(String name) { if (name == null) throw new NullPointerException("illegal null input"); this.name = name; } /** * Returns the name of this principal. * * <p> * * @return the name of this <code>JMXPrincipal</code>. */ public String getName() { return name; } /** * Returns a string representation of this <code>JMXPrincipal</code>. * * <p> * * @return a string representation of this <code>JMXPrincipal</code>. */ public String toString() { return("JMXPrincipal: " + name); } /** * Compares the specified Object with this <code>JMXPrincipal</code> * for equality. Returns true if the given object is also a * <code>JMXPrincipal</code> and the two JMXPrincipals * have the same name. * * <p> * * @param o Object to be compared for equality with this * <code>JMXPrincipal</code>. * * @return true if the specified Object is equal to this * <code>JMXPrincipal</code>. */ public boolean equals(Object o) { if (o == null) return false; if (this == o) return true; if (!(o instanceof JMXPrincipal)) return false; JMXPrincipal that = (JMXPrincipal)o; return (this.getName().equals(that.getName())); } /** * Returns a hash code for this <code>JMXPrincipal</code>. * * <p> * * @return a hash code for this <code>JMXPrincipal</code>. */ public int hashCode() { return name.hashCode(); } }