java.util.jar.JarFile翻译

 

Overview  Package   Class  Use  Tree  Deprecated  Index  Help			JavaTM 2 Platform Std. Ed. v1.4.1
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES    <script type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); } //--> </script> All Classes
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

java.util.jar
Class JarFile

java.lang.Object
  |
  +--java.util.zip.ZipFile
        |
        +--java.util.jar.JarFile

All Implemented Interfaces:

java.util.zip.ZipConstants

---

public class JarFile extends ZipFile

The JarFile class is used to read the contents of a JAR file from any file that can be opened with java.io.RandomAccessFile. It extends the class java.util.zip.ZipFile with support for reading an optional Manifest entry. The Manifest can be used to specify meta-information about the JAR file and its entries. JarFile类被用来从使用java.io.RandomAccessFile打开的任何文件中读取JAR文件的 内容。它继承自类 java.util.zip.ZipFile，支持读取可选的 Manifest项。 Manifest可以用于说明JAR文件及其项的元信息。

Since:

1.2

See Also:

Manifest , ZipFile , JarEntry

---

Field Summary
static String	MANIFEST_NAME           The JAR manifest file name. JAR声明文件名。

 

Fields inherited from class java.util.zip.ZipFile

CENATT, CENATX, CENCOM, CENCRC, CENDSK, CENEXT, CENFLG, CENHDR, CENHOW, CENLEN, CENNAM, CENOFF, CENSIG, CENSIZ, CENTIM, CENVEM, CENVER, ENDCOM, ENDHDR, ENDOFF, ENDSIG, ENDSIZ, ENDSUB, ENDTOT, EXTCRC, EXTHDR, EXTLEN, EXTSIG, EXTSIZ, LOCCRC, LOCEXT, LOCFLG, LOCHDR, LOCHOW, LOCLEN, LOCNAM, LOCSIG, LOCSIZ, LOCTIM, LOCVER, OPEN_DELETE, OPEN_READ

 

Constructor Summary

JarFile(File file)           Creates a new JarFile to read from the specified File object. 创建一个从指定File对象读取的JarFile。

JarFile(File file, boolean verify)           Creates a new JarFile to read from the specified File object. 创建一个从指定File对象读取的JarFile。

JarFile(File file, boolean verify, int mode)           Creates a new JarFile to read from the specified File object in the specified mode. 创建一个处于指定模式的从指定File对象读取的JarFile。

JarFile(String name)           Creates a new JarFile to read from the specified file name. 创建一个从指定名称文件读取的JarFile。

JarFile(String name, boolean verify)           Creates a new JarFile to read from the specified file name. 创建一个从指定名称文件读取的JarFile。

 

Method Summary
Enumeration	entries()           Returns an enumeration of the ZIP file entries. 返回ZIP文件项的枚举。
ZipEntry	getEntry(String name)           Returns the ZipEntry for the given entry name or null if not found. 返回给定项名称的ZipEntry，如果未找到，返回null。
InputStream	getInputStream(ZipEntry ze)           Returns an input stream for reading the contents of the specified ZIP file entry. 返回读取指定ZIP文件项内容的输入流。
JarEntry	getJarEntry(String name)           Returns the JarEntry for the given entry name or null if not found. 返回给定项名称的JarEntry，如果未找到，返回null。
Manifest	getManifest()           Returns the JAR file manifest, or null if none. 返回JAR文件声明，如果没有返回null。

 

Methods inherited from class java.util.zip.ZipFile

close, finalize, getName, size

 

Methods inherited from class java.lang.Object

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

 

Field Detail

MANIFEST_NAME

public static final String MANIFEST_NAME

The JAR manifest file name. JAR声明文件名。

See Also:

Constant Field Values

Constructor Detail

JarFile

public JarFile(String name)
        throws IOException

Creates a new JarFile to read from the specified file name. The JarFile will be verified if it is signed. 创建一个从指定名称文件读取的JarFile。如果JAR文件已被签名，应该验证。

Parameters:

name - the name of the JAR file to be opened for reading 要打开读取的JAR文件名

Throws:

IOException - if an I/O error has occurred 如果发生I/O错误时抛出

SecurityException - if access to the file is denied by the SecurityManager 如果SecurityManager拒绝文件访问时抛出

---

JarFile

public JarFile(String name,
               boolean verify)
        throws IOException

Creates a new JarFile to read from the specified file name. 创建一个从指定名称文件读取的JarFile。

Parameters:

name - the name of the JAR file to be opened for reading 要打开读取的JAR文件名

verify - whether or not to verify the JarFile if it is signed. 如果JarFile被签名，是否应验证。

Throws:

IOException - if an I/O error has occurred 如果发生I/O错误时抛出

SecurityException - if access to the file is denied by the SecurityManager 如果SecurityManager拒绝文件访问时抛出

---

JarFile

public JarFile(File file)
        throws IOException

Creates a new JarFile to read from the specified File object. The JarFile will be verified if it is signed. 创建一个从指定File对象读取的JarFile。如果JAR文件已被签名，应该验证。

Parameters:

file - the JAR file to be opened for reading 要打开读取的JAR文件

Throws:

IOException - if an I/O error has occurred 如果发生I/O错误时抛出

SecurityException - if access to the file is denied by the SecurityManager 如果SecurityManager拒绝文件访问时抛出

---

JarFile

public JarFile(File file,
               boolean verify)
        throws IOException

Creates a new JarFile to read from the specified File object. 创建一个从指定File对象读取的JarFile。

Parameters:

file - the JAR file to be opened for reading 要打开读取的JAR文件

verify - whether or not to verify the JarFile if it is signed. 如果JarFile被签名，是否应验证。

Throws:

IOException - if an I/O error has occurred 如果发生I/O错误时抛出

SecurityException - if access to the file is denied by the SecurityManager. 如果SecurityManager拒绝文件访问时抛出

---

JarFile

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

Creates a new JarFile to read from the specified File object in the specified mode. The mode argument must be either OPEN_READ or OPEN_READ | OPEN_DELETE. 创建一个处于指定模式的从指定File对象读取的JarFile。mode参数必须是OPEN_READ或者OPEN_READ | OPEN_DELETE。

Parameters:

file - the JAR file to be opened for reading 要打开读取的JAR文件

verify - whether or not to verify the JarFile if it is signed. 如果JarFile被签名，是否应验证。

mode - the mode in which the file is to be opened 文件被打开的模式

Throws:

IOException - if an I/O error has occurred 如果发生I/O错误时抛出

IllegalArgumentException - If the mode argument is invalid 如果mode参数无效抛出

SecurityException - if access to the file is denied by the SecurityManager 如果SecurityManager拒绝文件访问时抛出

Method Detail

getManifest

public Manifest getManifest()
                     throws IOException

Returns the JAR file manifest, or null if none. 返回JAR文件声明，如果没有返回null。

Returns:

the JAR file manifest, or null if none JAR文件声明，如果没有返回null

IOException

---

getJarEntry

public JarEntry getJarEntry(String name)

Returns the JarEntry for the given entry name or null if not found. 返回给定项名称的JarEntry，如果未找到，返回null。

Parameters:

name - the JAR file entry name JAR文件项

Returns:

the JarEntry for the given entry name or null if not found. 给定项名称的JarEntry，如果未找到，返回null。

See Also:

JarEntry

---

getEntry

public ZipEntry getEntry(String name)

Returns the ZipEntry for the given entry name or null if not found. 返回给定项名称的ZipEntry，如果未找到，返回null。

Overrides:

getEntry in class ZipFile

Parameters:

name - the JAR file entry name JAR文件项

Returns:

the ZipEntry for the given entry name or null if not found 给定项名称的ZipEntry，如果未找到，返回null

See Also:

ZipEntry

---

entries

public Enumeration entries()

Returns an enumeration of the ZIP file entries. 返回ZIP文件项的枚举。

Overrides:

entries in class ZipFile

Returns:

an enumeration of the ZIP file entries ZIP文件项的枚举

---

getInputStream

public InputStream getInputStream(ZipEntry ze)
                           throws IOException

Returns an input stream for reading the contents of the specified ZIP file entry. 返回读取指定ZIP文件项内容的输入流。

Overrides:

getInputStream in class ZipFile

Parameters:

ze - the zip file entry zip文件项

Returns:

an input stream for reading the contents of the specified ZIP file entry 读取指定ZIP文件项内容的输入流

Throws:

ZipException - if a ZIP format error has occurred 如果发生ZIP格式错误抛出

IOException - if an I/O error has occurred 如果发生I/O错误时抛出

SecurityException - if any of the JarFile entries are incorrectly signed. 如果任一个JarFile项签名不正确时抛出。

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help			JavaTM 2 Platform Std. Ed. v1.4.1
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES    <script type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); } //--> </script> All Classes
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation . That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.