| 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文件及其项的元信息。
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 filename
. TheJarFile
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 filename
. 创建一个从指定名称文件读取的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 specifiedFile
object. TheJarFile
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 specifiedFile
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 specifiedFile
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
-
the JAR file manifest, or
getJarEntry
public JarEntry getJarEntry(String name)
-
Returns the
JarEntry
for the given entry name ornull
if not found. 返回给定项名称的JarEntry,如果未找到,返回null。 -
-
Parameters:
-
name
- the JAR file entry name JAR文件项
Returns:
-
the
JarEntry
for the given entry name ornull
if not found. 给定项名称的JarEntry,如果未找到,返回null。
See Also:
-
JarEntry
-
getEntry
public ZipEntry getEntry(String name)
-
Returns the
ZipEntry
for the given entry name ornull
if not found. 返回给定项名称的ZipEntry,如果未找到,返回null。 -
-
Parameters:
-
name
- the JAR file entry name JAR文件项
Returns:
-
the
ZipEntry
for the given entry name ornull
if not found 给定项名称的ZipEntry,如果未找到,返回null
See Also:
-
ZipEntry
-
entries
public Enumeration entries()
- Returns an enumeration of the ZIP file entries. 返回ZIP文件项的枚举。
-
-
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 classZipFile
-
-
-
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项签名不正确时抛出。
-
| 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.