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 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149
/* * @(#)CodeSigner.java 1.5 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.security; import java.io.Serializable; import java.security.cert.CertPath; /** * This class encapsulates information about a code signer. * It is immutable. * * @since 1.5 * @version 1.5, 11/17/05 * @author Vincent Ryan */ public final class CodeSigner implements Serializable { private static final long serialVersionUID = 6819288105193937581L; /** * The signer's certificate path. * * @serial */ private CertPath signerCertPath; /* * The signature timestamp. * * @serial */ private Timestamp timestamp; /* * Hash code for this code signer. */ private transient int myhash = -1; /** * Constructs a CodeSigner object. * * @param signerCertPath The signer's certificate path. * It must not be <code>null</code>. * @param timestamp A signature timestamp. * If <code>null</code> then no timestamp was generated * for the signature. * @throws NullPointerException if <code>signerCertPath</code> is * <code>null</code>. */ public CodeSigner(CertPath signerCertPath, Timestamp timestamp) { if (signerCertPath == null) { throw new NullPointerException(); } this.signerCertPath = signerCertPath; this.timestamp = timestamp; } /** * Returns the signer's certificate path. * * @return A certificate path. */ public CertPath getSignerCertPath() { return signerCertPath; } /** * Returns the signature timestamp. * * @return The timestamp or <code>null</code> if none is present. */ public Timestamp getTimestamp() { return timestamp; } /** * Returns the hash code value for this code signer. * The hash code is generated using the signer's certificate path and the * timestamp, if present. * * @return a hash code value for this code signer. */ public int hashCode() { if (myhash == -1) { if (timestamp == null) { myhash = signerCertPath.hashCode(); } else { myhash = signerCertPath.hashCode() + timestamp.hashCode(); } } return myhash; } /** * Tests for equality between the specified object and this * code signer. Two code signers are considered equal if their * signer certificate paths are equal and if their timestamps are equal, * if present in both. * * @param obj the object to test for equality with this object. * * @return true if the objects are considered equal, false otherwise. */ public boolean equals(Object obj) { if (obj == null || (!(obj instanceof CodeSigner))) { return false; } CodeSigner that = (CodeSigner)obj; if (this == that) { return true; } Timestamp thatTimestamp = that.getTimestamp(); if (timestamp == null) { if (thatTimestamp != null) { return false; } } else { if (thatTimestamp == null || (! timestamp.equals(thatTimestamp))) { return false; } } return signerCertPath.equals(that.getSignerCertPath()); } /** * Returns a string describing this code signer. * * @return A string comprising the signer's certificate and a timestamp, * if present. */ public String toString() { StringBuffer sb = new StringBuffer(); sb.append("("); sb.append("Signer: " + signerCertPath.getCertificates().get(0)); if (timestamp != null) { sb.append("timestamp: " + timestamp); } sb.append(")"); return sb.toString(); } }