mirror of
https://github.com/autc04/Retro68.git
synced 2024-12-11 19:49:32 +00:00
173 lines
5.3 KiB
Java
173 lines
5.3 KiB
Java
|
/* JarEntry.java - Represents an entry in a jar file
|
||
|
Copyright (C) 2000, 2006 Free Software Foundation, Inc.
|
||
|
|
||
|
This file is part of GNU Classpath.
|
||
|
|
||
|
GNU Classpath is free software; you can redistribute it and/or modify
|
||
|
it under the terms of the GNU General Public License as published by
|
||
|
the Free Software Foundation; either version 2, or (at your option)
|
||
|
any later version.
|
||
|
|
||
|
GNU Classpath is distributed in the hope that it will be useful, but
|
||
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
|
General Public License for more details.
|
||
|
|
||
|
You should have received a copy of the GNU General Public License
|
||
|
along with GNU Classpath; see the file COPYING. If not, write to the
|
||
|
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
||
|
02110-1301 USA.
|
||
|
|
||
|
Linking this library statically or dynamically with other modules is
|
||
|
making a combined work based on this library. Thus, the terms and
|
||
|
conditions of the GNU General Public License cover the whole
|
||
|
combination.
|
||
|
|
||
|
As a special exception, the copyright holders of this library give you
|
||
|
permission to link this library with independent modules to produce an
|
||
|
executable, regardless of the license terms of these independent
|
||
|
modules, and to copy and distribute the resulting executable under
|
||
|
terms of your choice, provided that you also meet, for each linked
|
||
|
independent module, the terms and conditions of the license of that
|
||
|
module. An independent module is a module which is not derived from
|
||
|
or based on this library. If you modify this library, you may extend
|
||
|
this exception to your version of the library, but you are not
|
||
|
obligated to do so. If you do not wish to do so, delete this
|
||
|
exception statement from your version. */
|
||
|
|
||
|
package java.util.jar;
|
||
|
|
||
|
import java.io.IOException;
|
||
|
import java.security.cert.Certificate;
|
||
|
import java.util.Set;
|
||
|
import java.util.zip.ZipEntry;
|
||
|
|
||
|
/**
|
||
|
* Extension to a ZipEntry that contains manifest attributes and certificates.
|
||
|
* Both the Atrributes and the Certificates can be null when not set.
|
||
|
* Note that the <code>getCertificates()</code> method only returns a
|
||
|
* valid value after all of the data of the entry has been read.
|
||
|
* <p>
|
||
|
* There are no public methods to set the attributes or certificate of an
|
||
|
* Entru. Only JarEntries created by the classes in <code>java.util.jar</code>
|
||
|
* will have these properties set.
|
||
|
*
|
||
|
* @since 1.2
|
||
|
* @author Mark Wielaard (mark@klomp.org)
|
||
|
*/
|
||
|
|
||
|
public class JarEntry extends ZipEntry
|
||
|
{
|
||
|
// (Package local) fields
|
||
|
|
||
|
Attributes attr;
|
||
|
JarFile jarfile;
|
||
|
|
||
|
// Constructors
|
||
|
|
||
|
/**
|
||
|
* Creates a new JarEntry with the specified name and no attributes or
|
||
|
* or certificates. Calls <code>super(name)</code> so all other (zip)entry
|
||
|
* fields are null or -1.
|
||
|
*
|
||
|
* @param name the name of the new jar entry
|
||
|
* @exception NullPointerException when the supplied name is null
|
||
|
* @exception IllegalArgumentException when the supplied name is longer
|
||
|
* than 65535 bytes
|
||
|
*/
|
||
|
public JarEntry(String name) throws NullPointerException,
|
||
|
IllegalArgumentException
|
||
|
{
|
||
|
super(name);
|
||
|
attr = null;
|
||
|
jarfile = null;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a new JarEntry with the specified ZipEntry as template for
|
||
|
* all properties of the entry. Both attributes and certificates will be
|
||
|
* null.
|
||
|
*
|
||
|
* @param entry the ZipEntry whose fields should be copied
|
||
|
*/
|
||
|
public JarEntry(ZipEntry entry)
|
||
|
{
|
||
|
super(entry);
|
||
|
attr = null;
|
||
|
jarfile = null;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a new JarEntry with the specified JarEntry as template for
|
||
|
* all properties of the entry.
|
||
|
*
|
||
|
* @param entry the jarEntry whose fields should be copied
|
||
|
*/
|
||
|
public JarEntry(JarEntry entry)
|
||
|
{
|
||
|
super(entry);
|
||
|
try
|
||
|
{
|
||
|
attr = entry.getAttributes();
|
||
|
}
|
||
|
catch (IOException _)
|
||
|
{
|
||
|
}
|
||
|
jarfile = entry.jarfile;
|
||
|
}
|
||
|
|
||
|
// Methods
|
||
|
|
||
|
/**
|
||
|
* Returns a copy of the Attributes set for this entry.
|
||
|
* When no Attributes are set in the manifest null is returned.
|
||
|
*
|
||
|
* @return a copy of the Attributes set for this entry
|
||
|
* @exception IOException This will never be thrown. It is here for
|
||
|
* binary compatibility.
|
||
|
*/
|
||
|
public Attributes getAttributes() throws IOException
|
||
|
{
|
||
|
if (attr != null)
|
||
|
{
|
||
|
return (Attributes) attr.clone();
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
return null;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Returns a copy of the certificates set for this entry.
|
||
|
* When no certificates are set or when not all data of this entry has
|
||
|
* been read null is returned.
|
||
|
* <p>
|
||
|
* To make sure that this call returns a valid value you must read all
|
||
|
* data from the JarInputStream for this entry.
|
||
|
* When you don't need the data for an entry but want to know the
|
||
|
* certificates that are set for the entry then you can skip all data by
|
||
|
* calling <code>skip(entry.getSize())</code> on the JarInputStream for
|
||
|
* the entry.
|
||
|
*
|
||
|
* @return a copy of the certificates set for this entry
|
||
|
*/
|
||
|
public Certificate[] getCertificates()
|
||
|
{
|
||
|
if (jarfile != null)
|
||
|
{
|
||
|
synchronized (jarfile)
|
||
|
{
|
||
|
if (jarfile.entryCerts != null)
|
||
|
{
|
||
|
Set certs = (Set) jarfile.entryCerts.get(getName());
|
||
|
if (certs != null
|
||
|
&& jarfile.verified.get(getName()) == Boolean.TRUE)
|
||
|
return (Certificate[]) certs.toArray(new Certificate[certs.size()]);
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
return null;
|
||
|
}
|
||
|
}
|