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
/* * @(#)JarEntry.java 1.23 05/11/30 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.util.jar; import java.io.IOException; import java.util.zip.ZipEntry; import java.security.CodeSigner; import java.security.cert.Certificate; /** * This class is used to represent a JAR file entry. */ public class JarEntry extends ZipEntry { Attributes attr; Certificate[] certs; CodeSigner[] signers; /** * Creates a new <code>JarEntry</code> for the specified JAR file * entry name. * * @param name the JAR file entry name * @exception NullPointerException if the entry name is <code>null</code> * @exception IllegalArgumentException if the entry name is longer than * 0xFFFF bytes. */ public JarEntry(String name) { super(name); } /** * Creates a new <code>JarEntry</code> with fields taken from the * specified <code>ZipEntry</code> object. * @param ze the <code>ZipEntry</code> object to create the * <code>JarEntry</code> from */ public JarEntry(ZipEntry ze) { super(ze); } /** * Creates a new <code>JarEntry</code> with fields taken from the * specified <code>JarEntry</code> object. * * @param je the <code>JarEntry</code> to copy */ public JarEntry(JarEntry je) { this((ZipEntry)je); this.attr = je.attr; this.certs = je.certs; this.signers = je.signers; } /** * Returns the <code>Manifest</code> <code>Attributes</code> for this * entry, or <code>null</code> if none. * * @return the <code>Manifest</code> <code>Attributes</code> for this * entry, or <code>null</code> if none */ public Attributes getAttributes() throws IOException { return attr; } /** * Returns the <code>Certificate</code> objects for this entry, or * <code>null</code> if none. This method can only be called once * the <code>JarEntry</code> has been completely verified by reading * from the entry input stream until the end of the stream has been * reached. Otherwise, this method will return <code>null</code>. * * <p>The returned certificate array comprises all the signer certificates * that were used to verify this entry. Each signer certificate is * followed by its supporting certificate chain (which may be empty). * Each signer certificate and its supporting certificate chain are ordered * bottom-to-top (i.e., with the signer certificate first and the (root) * certificate authority last). * * @return the <code>Certificate</code> objects for this entry, or * <code>null</code> if none. */ public Certificate[] getCertificates() { return certs == null ? null : (Certificate[]) certs.clone(); } /** * Returns the <code>CodeSigner</code> objects for this entry, or * <code>null</code> if none. This method can only be called once * the <code>JarEntry</code> has been completely verified by reading * from the entry input stream until the end of the stream has been * reached. Otherwise, this method will return <code>null</code>. * * <p>The returned array comprises all the code signers that have signed * this entry. * * @return the <code>CodeSigner</code> objects for this entry, or * <code>null</code> if none. * * @since 1.5 */ public CodeSigner[] getCodeSigners() { return signers == null ? null : (CodeSigner[]) signers.clone(); } }