JavaTM Platform
Standard Ed. 6

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_READOPEN_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 文件已关闭,则可能抛出此异常

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策