Class
JavaTM 2 Platform
Std. Ed. v1.4.1
SUMMARY: NESTED | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD
java.util.jar
Class JarFilejava.lang.Object
|
|
+--java.util.jar.JarFile
All Implemented Interfaces: java.util.zip.ZipConstants public class JarFile extends ZipFileThe 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, JarEntryField Summary
static String
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
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。
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
entries()
Returns an enumeration of the ZIP file entries. 返回ZIP文件项的枚举。
Returns the ZipEntry for the given entry name or null if not found. 返回给定项名称的ZipEntry，如果未找到，返回null。
Returns an input stream for reading the contents of the specified ZIP file entry. 返回读取指定ZIP文件项内容的输入流。
getJarEntry(String name)
Returns the JarEntry for the given entry name or null if not found. 返回给定项名称的JarEntry，如果未找到，返回null。
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_NAMEpublic static final String MANIFEST_NAME
The JAR manifest file name. JAR声明文件名。
See Also: Constant Field ValuesConstructor Detail
JarFilepublic 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拒绝文件访问时抛出JarFilepublic 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拒绝文件访问时抛出JarFilepublic 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拒绝文件访问时抛出JarFilepublic 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拒绝文件访问时抛出JarFilepublic 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
getManifestpublic 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 IOExceptiongetJarEntrypublic 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: JarEntrygetEntrypublic ZipEntry getEntry(String name)
Returns the ZipEntry for the given entry name or null if not found. 返回给定项名称的ZipEntry，如果未找到，返回null。
Overrides: getEntry in class ZipFileParameters: name - the JAR file entry name JAR文件项 Returns: the ZipEntry for the given entry name or null if not found 给定项名称的ZipEntry，如果未找到，返回null See Also: ZipEntryentriespublic Enumeration entries()
Returns an enumeration of the ZIP file entries. 返回ZIP文件项的枚举。
Overrides: entries in class ZipFileReturns: an enumeration of the ZIP file entries ZIP文件项的枚举getInputStreampublic 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 ZipFileParameters: 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
Class
JavaTM 2 Platform
Std. Ed. v1.4.1
SUMMARY: NESTED | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD
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.
