java.util.jar
类 JarFile

java.lang.Object
  java.util.zip.ZipFile
      java.util.jar.JarFile

public class JarFile
     

      extends 
      ZipFile
     

JarFile 类用于从任何可以使用 java.io.RandomAccessFile 打开的文件中读取 jar 文件的内容。它扩展了 java.util.zip.ZipFile 类，使之支持读取可选的 Manifest 条目。Manifest 可用于指定关于 jar 文件及其条目的元信息。

除非另行说明，否则将 null 参数传递给此类中的构造方法或方法都将抛出 NullPointerException。

从以下版本开始：

1.2

另请参见：

Manifest, ZipFile, JarEntry

字段摘要

static int	CENATT
static int	CENATX
static int	CENCOM
static int	CENCRC
static int	CENDSK
static int	CENEXT
static int	CENFLG
static int	CENHDR
static int	CENHOW
static int	CENLEN
static int	CENNAM
static int	CENOFF
static long	CENSIG
static int	CENSIZ
static int	CENTIM
static int	CENVEM
static int	CENVER
static int	ENDCOM
static int	ENDHDR
static int	ENDOFF
static long	ENDSIG
static int	ENDSIZ
static int	ENDSUB
static int	ENDTOT
static int	EXTCRC
static int	EXTHDR
static int	EXTLEN
static long	EXTSIG
static int	EXTSIZ
static int	LOCCRC
static int	LOCEXT
static int	LOCFLG
static int	LOCHDR
static int	LOCHOW
static int	LOCLEN
static int	LOCNAM
static long	LOCSIG
static int	LOCSIZ
static int	LOCTIM
static int	LOCVER
static String	MANIFEST_NAME JAR 清单文件名称。

从类 java.util.zip.ZipFile 继承的字段

OPEN_DELETE, OPEN_READ

构造方法摘要

JarFile(File file)
创建一个要从指定的 File 对象读取的新的 JarFile。

JarFile(File file, boolean verify)
创建一个要从指定的 File 对象读取的新的 JarFile。

JarFile(File file, boolean verify, int mode)
创建一个要从指定的 File 对象中以指定模式读取的新的 JarFile。

JarFile(String name)
创建一个要从指定的文件 name 读取的新的 JarFile。

JarFile(String name, boolean verify)
创建一个要从指定的文件 name 读取的新的 JarFile。

方法摘要

Enumeration<JarEntry>	entries() 返回 zip 文件条目的枚举。
ZipEntry	getEntry(String name) 返回给定条目名称的 ZipEntry；如果未找到，则返回 null。
InputStream	getInputStream(ZipEntry ze) 返回用于读取指定 zip 文件条目内容的输入流。
JarEntry	getJarEntry(String name) 返回给定条目名称的 JarEntry；如果未找到，则返回 null。
Manifest	getManifest() 返回 jar 文件清单；如果没有，则返回 null。

从类 java.util.zip.ZipFile 继承的方法

close, finalize, getName, size

从类 java.lang.Object 继承的方法

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

MANIFEST_NAME

public static final String MANIFEST_NAME

JAR 清单文件名称。

另请参见：

常量字段值

LOCSIG

public static final long LOCSIG

另请参见：

常量字段值

EXTSIG

public static final long EXTSIG

另请参见：

常量字段值

CENSIG

public static final long CENSIG

另请参见：

常量字段值

ENDSIG

public static final long ENDSIG

另请参见：

常量字段值

LOCHDR

public static final int LOCHDR

另请参见：

常量字段值

EXTHDR

public static final int EXTHDR

另请参见：

常量字段值

CENHDR

public static final int CENHDR

另请参见：

常量字段值

ENDHDR

public static final int ENDHDR

另请参见：

常量字段值

LOCVER

public static final int LOCVER

另请参见：

常量字段值

LOCFLG

public static final int LOCFLG

另请参见：

常量字段值

LOCHOW

public static final int LOCHOW

另请参见：

常量字段值

LOCTIM

public static final int LOCTIM

另请参见：

常量字段值

LOCCRC

public static final int LOCCRC

另请参见：

常量字段值

LOCSIZ

public static final int LOCSIZ

另请参见：

常量字段值

LOCLEN

public static final int LOCLEN

另请参见：

常量字段值

LOCNAM

public static final int LOCNAM

另请参见：

常量字段值

LOCEXT

public static final int LOCEXT

另请参见：

常量字段值

EXTCRC

public static final int EXTCRC

另请参见：

常量字段值

EXTSIZ

public static final int EXTSIZ

另请参见：

常量字段值

EXTLEN

public static final int EXTLEN

另请参见：

常量字段值

CENVEM

public static final int CENVEM

另请参见：

常量字段值

CENVER

public static final int CENVER

另请参见：

常量字段值

CENFLG

public static final int CENFLG

另请参见：

常量字段值

CENHOW

public static final int CENHOW

另请参见：

常量字段值

CENTIM

public static final int CENTIM

另请参见：

常量字段值

CENCRC

public static final int CENCRC

另请参见：

常量字段值

CENSIZ

public static final int CENSIZ

另请参见：

常量字段值

CENLEN

public static final int CENLEN

另请参见：

常量字段值

CENNAM

public static final int CENNAM

另请参见：

常量字段值

CENEXT

public static final int CENEXT

另请参见：

常量字段值

CENCOM

public static final int CENCOM

另请参见：

常量字段值

CENDSK

public static final int CENDSK

另请参见：

常量字段值

CENATT

public static final int CENATT

另请参见：

常量字段值

CENATX

public static final int CENATX

另请参见：

常量字段值

CENOFF

public static final int CENOFF

另请参见：

常量字段值

ENDSUB

public static final int ENDSUB

另请参见：

常量字段值

ENDTOT

public static final int ENDTOT

另请参见：

常量字段值

ENDSIZ

public static final int ENDSIZ

另请参见：

常量字段值

ENDOFF

public static final int ENDOFF

另请参见：

常量字段值

ENDCOM

public static final int ENDCOM

另请参见：

常量字段值

构造方法详细信息

JarFile

public JarFile(String name)
        throws IOException

创建一个要从指定的文件 name 读取的新的 JarFile。如果文件是签名的，则将验证 JarFile。

参数：

name - 要打开供读取的 jar 文件名称

抛出：

IOException - 如果发生 I/O 错误

SecurityException - 如果对文件的访问被 SecurityManager 拒绝

JarFile

public JarFile(String name,
               boolean verify)
        throws IOException

创建一个要从指定的文件 name 读取的新的 JarFile。

参数：

name - 要打开供读取的 jar 文件名称

verify - 如果文件是签名的，是否验证 jar 文件

抛出：

IOException - 如果发生 I/O 错误

SecurityException - 如果对文件的访问被 SecurityManager 拒绝

JarFile

public JarFile(File file)
        throws IOException

创建一个要从指定的 File 对象读取的新的 JarFile。如果文件是签名的，则将验证 JarFile。

参数：

file - 要打开供读取的 jar 文件

抛出：

IOException - 如果发生 I/O 错误

SecurityException - 如果对文件的访问被 SecurityManager 拒绝

JarFile

public JarFile(File file,
               boolean verify)
        throws IOException

创建一个要从指定的 File 对象读取的新的 JarFile。

参数：

file - 要打开供读取的 jar 文件

verify - 如果文件是签名的，是否验证 jar 文件。

抛出：

IOException - 如果发生 I/O 错误

SecurityException - 如果对文件的访问被 SecurityManager 拒绝。

JarFile

public JarFile(File file,
               boolean verify,
               int mode)
        throws IOException

创建一个要从指定的 File 对象中以指定模式读取的新的 JarFile。模式参数必须是 OPEN_READ 或 OPEN_READ | OPEN_DELETE。

参数：

file - 要打开供读取的 jar 文件

verify - 如果文件是签名的，是否验证 jar 文件。

mode - 打开文件的模式

抛出：

IOException - 如果发生 I/O 错误

IllegalArgumentException - 如果 mode 参数无效

SecurityException - 如果对文件的访问被 SecurityManager 拒绝

从以下版本开始：

1.3

方法详细信息

getManifest

public Manifest getManifest()
                     throws IOException

返回 jar 文件清单；如果没有，则返回 null。

返回：

jar 文件清单；如果没有，则返回 null

抛出：

IllegalStateException - 如果 jar 文件已关闭，则可能抛出此异常

IOException

getJarEntry

public JarEntry getJarEntry(String name)

返回给定条目名称的 JarEntry；如果未找到，则返回 null。

参数：

name - jar 文件条目名称

返回：

给定条目名称的 JarEntry；如果未找到，则返回 null。

抛出：

IllegalStateException - 如果 jar 文件已关闭，则可能抛出此异常

另请参见：

JarEntry

getEntry

public ZipEntry getEntry(String name)

返回给定条目名称的 ZipEntry；如果未找到，则返回 null。

覆盖：

类 ZipFile 中的 getEntry

参数：

name - jar 文件条目名称

返回：

给定条目名称的 ZipEntry；如果未找到，则返回 null

抛出：

IllegalStateException - 如果 jar 文件已关闭，则可能抛出此异常

另请参见：

ZipEntry

entries

public Enumeration<JarEntry> entries()

返回 zip 文件条目的枚举。

覆盖：

类 ZipFile 中的 entries

返回：

ZIP 文件条目的枚举

getInputStream

public InputStream getInputStream(ZipEntry ze)
                           throws IOException

返回用于读取指定 zip 文件条目内容的输入流。

覆盖：

类 ZipFile 中的 getInputStream

参数：

ze - zip 文件条目

返回：

用于读取指定 zip 文件条目内容的输入流

抛出：

ZipException - 如果出现 zip 文件格式错误

IOException - 如果发生 I/O 错误

SecurityException - 如果有任何未正确签名的 jar 文件条目。

IllegalStateException - 如果 jar 文件已关闭，则可能抛出此异常