001 /*
002 * Copyright 2003-2004 Sun Microsystems, Inc. All Rights Reserved.
003 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
004 *
005 * This code is free software; you can redistribute it and/or modify it
006 * under the terms of the GNU General Public License version 2 only, as
007 * published by the Free Software Foundation. Sun designates this
008 * particular file as subject to the "Classpath" exception as provided
009 * by Sun in the LICENSE file that accompanied this code.
010 *
011 * This code is distributed in the hope that it will be useful, but WITHOUT
012 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
013 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
014 * version 2 for more details (a copy is included in the LICENSE file that
015 * accompanied this code).
016 *
017 * You should have received a copy of the GNU General Public License version
018 * 2 along with this work; if not, write to the Free Software Foundation,
019 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
020 *
021 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
022 * CA 95054 USA or visit www.sun.com if you need additional information or
023 * have any questions.
024 */
025
026 package java.security;
027
028 import java.io.Serializable;
029 import java.security.cert.CertPath;
030
031 /**
032 * This class encapsulates information about a code signer.
033 * It is immutable.
034 *
035 * @since 1.5
036 * @version 1.11, 05/05/07
037 * @author Vincent Ryan
038 */
039
040 public final class CodeSigner implements Serializable {
041
042 private static final long serialVersionUID = 6819288105193937581L;
043
044 /**
045 * The signer's certificate path.
046 *
047 * @serial
048 */
049 private CertPath signerCertPath;
050
051 /*
052 * The signature timestamp.
053 *
054 * @serial
055 */
056 private Timestamp timestamp;
057
058 /*
059 * Hash code for this code signer.
060 */
061 private transient int myhash = -1;
062
063 /**
064 * Constructs a CodeSigner object.
065 *
066 * @param signerCertPath The signer's certificate path.
067 * It must not be <code>null</code>.
068 * @param timestamp A signature timestamp.
069 * If <code>null</code> then no timestamp was generated
070 * for the signature.
071 * @throws NullPointerException if <code>signerCertPath</code> is
072 * <code>null</code>.
073 */
074 public CodeSigner(CertPath signerCertPath, Timestamp timestamp) {
075 if (signerCertPath == null) {
076 throw new NullPointerException();
077 }
078 this .signerCertPath = signerCertPath;
079 this .timestamp = timestamp;
080 }
081
082 /**
083 * Returns the signer's certificate path.
084 *
085 * @return A certificate path.
086 */
087 public CertPath getSignerCertPath() {
088 return signerCertPath;
089 }
090
091 /**
092 * Returns the signature timestamp.
093 *
094 * @return The timestamp or <code>null</code> if none is present.
095 */
096 public Timestamp getTimestamp() {
097 return timestamp;
098 }
099
100 /**
101 * Returns the hash code value for this code signer.
102 * The hash code is generated using the signer's certificate path and the
103 * timestamp, if present.
104 *
105 * @return a hash code value for this code signer.
106 */
107 public int hashCode() {
108 if (myhash == -1) {
109 if (timestamp == null) {
110 myhash = signerCertPath.hashCode();
111 } else {
112 myhash = signerCertPath.hashCode()
113 + timestamp.hashCode();
114 }
115 }
116 return myhash;
117 }
118
119 /**
120 * Tests for equality between the specified object and this
121 * code signer. Two code signers are considered equal if their
122 * signer certificate paths are equal and if their timestamps are equal,
123 * if present in both.
124 *
125 * @param obj the object to test for equality with this object.
126 *
127 * @return true if the objects are considered equal, false otherwise.
128 */
129 public boolean equals(Object obj) {
130 if (obj == null || (!(obj instanceof CodeSigner))) {
131 return false;
132 }
133 CodeSigner that = (CodeSigner) obj;
134
135 if (this == that) {
136 return true;
137 }
138 Timestamp thatTimestamp = that.getTimestamp();
139 if (timestamp == null) {
140 if (thatTimestamp != null) {
141 return false;
142 }
143 } else {
144 if (thatTimestamp == null
145 || (!timestamp.equals(thatTimestamp))) {
146 return false;
147 }
148 }
149 return signerCertPath.equals(that.getSignerCertPath());
150 }
151
152 /**
153 * Returns a string describing this code signer.
154 *
155 * @return A string comprising the signer's certificate and a timestamp,
156 * if present.
157 */
158 public String toString() {
159 StringBuffer sb = new StringBuffer();
160 sb.append("(");
161 sb.append("Signer: " + signerCertPath.getCertificates().get(0));
162 if (timestamp != null) {
163 sb.append("timestamp: " + timestamp);
164 }
165 sb.append(")");
166 return sb.toString();
167 }
168 }
|