0N/A/*
3659N/A * Copyright (c) 2003, 2011, 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 java.security;
0N/A
3233N/Aimport java.io.*;
0N/Aimport java.security.cert.CertPath;
0N/A
0N/A/**
0N/A * This class encapsulates information about a code signer.
0N/A * It is immutable.
0N/A *
0N/A * @since 1.5
0N/A * @author Vincent Ryan
0N/A */
0N/A
0N/Apublic final class CodeSigner implements Serializable {
0N/A
0N/A private static final long serialVersionUID = 6819288105193937581L;
0N/A
0N/A /**
0N/A * The signer's certificate path.
0N/A *
0N/A * @serial
0N/A */
0N/A private CertPath signerCertPath;
0N/A
0N/A /*
0N/A * The signature timestamp.
0N/A *
0N/A * @serial
0N/A */
0N/A private Timestamp timestamp;
0N/A
0N/A /*
0N/A * Hash code for this code signer.
0N/A */
0N/A private transient int myhash = -1;
0N/A
0N/A /**
0N/A * Constructs a CodeSigner object.
0N/A *
0N/A * @param signerCertPath The signer's certificate path.
0N/A * It must not be <code>null</code>.
0N/A * @param timestamp A signature timestamp.
0N/A * If <code>null</code> then no timestamp was generated
0N/A * for the signature.
0N/A * @throws NullPointerException if <code>signerCertPath</code> is
0N/A * <code>null</code>.
0N/A */
0N/A public CodeSigner(CertPath signerCertPath, Timestamp timestamp) {
0N/A if (signerCertPath == null) {
0N/A throw new NullPointerException();
0N/A }
0N/A this.signerCertPath = signerCertPath;
0N/A this.timestamp = timestamp;
0N/A }
0N/A
0N/A /**
0N/A * Returns the signer's certificate path.
0N/A *
0N/A * @return A certificate path.
0N/A */
0N/A public CertPath getSignerCertPath() {
0N/A return signerCertPath;
0N/A }
0N/A
0N/A /**
0N/A * Returns the signature timestamp.
0N/A *
0N/A * @return The timestamp or <code>null</code> if none is present.
0N/A */
0N/A public Timestamp getTimestamp() {
0N/A return timestamp;
0N/A }
0N/A
0N/A /**
0N/A * Returns the hash code value for this code signer.
0N/A * The hash code is generated using the signer's certificate path and the
0N/A * timestamp, if present.
0N/A *
0N/A * @return a hash code value for this code signer.
0N/A */
0N/A public int hashCode() {
0N/A if (myhash == -1) {
0N/A if (timestamp == null) {
0N/A myhash = signerCertPath.hashCode();
0N/A } else {
0N/A myhash = signerCertPath.hashCode() + timestamp.hashCode();
0N/A }
0N/A }
0N/A return myhash;
0N/A }
0N/A
0N/A /**
0N/A * Tests for equality between the specified object and this
0N/A * code signer. Two code signers are considered equal if their
0N/A * signer certificate paths are equal and if their timestamps are equal,
0N/A * if present in both.
0N/A *
0N/A * @param obj the object to test for equality with this object.
0N/A *
0N/A * @return true if the objects are considered equal, false otherwise.
0N/A */
0N/A public boolean equals(Object obj) {
0N/A if (obj == null || (!(obj instanceof CodeSigner))) {
0N/A return false;
0N/A }
0N/A CodeSigner that = (CodeSigner)obj;
0N/A
0N/A if (this == that) {
0N/A return true;
0N/A }
0N/A Timestamp thatTimestamp = that.getTimestamp();
0N/A if (timestamp == null) {
0N/A if (thatTimestamp != null) {
0N/A return false;
0N/A }
0N/A } else {
0N/A if (thatTimestamp == null ||
0N/A (! timestamp.equals(thatTimestamp))) {
0N/A return false;
0N/A }
0N/A }
0N/A return signerCertPath.equals(that.getSignerCertPath());
0N/A }
0N/A
0N/A /**
0N/A * Returns a string describing this code signer.
0N/A *
0N/A * @return A string comprising the signer's certificate and a timestamp,
0N/A * if present.
0N/A */
0N/A public String toString() {
0N/A StringBuffer sb = new StringBuffer();
0N/A sb.append("(");
0N/A sb.append("Signer: " + signerCertPath.getCertificates().get(0));
0N/A if (timestamp != null) {
0N/A sb.append("timestamp: " + timestamp);
0N/A }
0N/A sb.append(")");
0N/A return sb.toString();
0N/A }
2346N/A
3233N/A // Explicitly reset hash code value to -1
3233N/A private void readObject(ObjectInputStream ois)
3233N/A throws IOException, ClassNotFoundException {
3233N/A ois.defaultReadObject();
3233N/A myhash = -1;
3233N/A }
0N/A}