01: /*
02: JSPWiki - a JSP-based WikiWiki clone.
03:
04: Copyright (C) 2001-2002 Janne Jalkanen (Janne.Jalkanen@iki.fi)
05:
06: This program is free software; you can redistribute it and/or modify
07: it under the terms of the GNU Lesser General Public License as published by
08: the Free Software Foundation; either version 2.1 of the License, or
09: (at your option) any later version.
10:
11: This program is distributed in the hope that it will be useful,
12: but WITHOUT ANY WARRANTY; without even the implied warranty of
13: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14: GNU Lesser General Public License for more details.
15:
16: You should have received a copy of the GNU Lesser General Public License
17: along with this program; if not, write to the Free Software
18: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19: */
20: package com.ecyrd.jspwiki.auth.login;
21:
22: import java.security.Principal;
23:
24: /**
25: * Wrapper class for container-managed or externally-provided principals.
26: * Instances of PrincipalWrapper are immutable.
27: * @author Andrew Jaquith
28: * @since 2.3
29: */
30: public final class PrincipalWrapper implements Principal {
31: private final Principal m_principal;
32:
33: /**
34: * Constructs a new instance of this class by wrapping (decorating)
35: * the supplied principal.
36: * @param principal
37: */
38: public PrincipalWrapper(Principal principal) {
39: m_principal = principal;
40: }
41:
42: /**
43: * Returns the wrapped Principal used to construct this instance.
44: * @return the wrapped Principal decorated by this instance.
45: */
46: public final Principal getPrincipal() {
47: return m_principal;
48: }
49:
50: /**
51: * Returns the name of the wrapped principal.
52: */
53: public final String getName() {
54: return m_principal.getName();
55: }
56:
57: /**
58: * Two PrincipalWrapper objects are equal if their internally-wrapped
59: * principals are also equal.
60: */
61: public boolean equals(Object obj) {
62: if (!(obj instanceof PrincipalWrapper)) {
63: return false;
64: }
65: return m_principal.equals(((PrincipalWrapper) obj)
66: .getPrincipal());
67: }
68:
69: public int hashCode() {
70: return m_principal.hashCode() * 13;
71: }
72:
73: }
|