|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.net.URLConnection
java.net.JarURLConnection
public abstract class JarURLConnection
A URL Connection to a Java ARchive (JAR) file or an entry in a JAR file.
The syntax of a JAR URL is:
jar:<url>!/{entry}
for example:
jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class
Jar URLs should be used to refer to a JAR file or entries in
a JAR file. The example above is a JAR URL which refers to a JAR
entry. If the entry name is omitted, the URL refers to the whole
JAR file:
jar:http://www.foo.com/bar/baz.jar!/
Users should cast the generic URLConnection to a JarURLConnection when they know that the URL they created is a JAR URL, and they need JAR-specific functionality. For example:
URL url = new URL("jar:file:/home/duke/duke.jar!/"); JarURLConnection jarConnection = (JarURLConnection)url.openConnection(); Manifest manifest = jarConnection.getManifest();
Examples:
jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class
jar:http://www.foo.com/bar/baz.jar!/
jar:http://www.foo.com/bar/baz.jar!/COM/foo/
!/
is refered to as the separator.
When constructing a JAR url via new URL(context, spec)
,
the following rules apply:
Examples:
URL
,
URLConnection
,
JarFile
,
JarInputStream
,
Manifest
,
ZipEntry
Method Summary | |
---|---|
Attributes |
getAttributes()
Return the Attributes object for this connection if the URL for it points to a JAR file entry, null otherwise. |
Certificate[] |
getCertificates()
Return the Certificate object for this connection if the URL for it points to a JAR file entry, null otherwise. |
String |
getEntryName()
Return the entry name for this connection. |
JarEntry |
getJarEntry()
Return the JAR entry object for this connection, if any. |
abstract JarFile |
getJarFile()
Return the JAR file for this connection. |
URL |
getJarFileURL()
Returns the URL for the Jar file for this connection. |
Attributes |
getMainAttributes()
Returns the main Attributes for the JAR file for this connection. |
Manifest |
getManifest()
Returns the Manifest for this connection, or null if none. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Method Detail |
---|
public URL getJarFileURL()
public String getEntryName()
public abstract JarFile getJarFile() throws IOException
IOException
- if an IOException occurs while trying to
connect to the JAR file for this connection.URLConnection.connect()
public Manifest getManifest() throws IOException
IOException
- if getting the JAR file for this
connection causes an IOException to be trown.getJarFile()
public JarEntry getJarEntry() throws IOException
IOException
- if getting the JAR file for this
connection causes an IOException to be trown.getJarFile()
,
getJarEntry()
public Attributes getAttributes() throws IOException
IOException
- if getting the JAR entry causes an
IOException to be thrown.getJarEntry()
public Attributes getMainAttributes() throws IOException
IOException
- if getting the manifest causes an
IOException to be thrown.getJarFile()
,
getManifest()
public Certificate[] getCertificates() throws IOException
null
***NOTE: In J2ME CDC, there is no support for certificates by design.
If CDC by itself or a J2ME profile built on CDC does not add back the
java.security.Signature class (plus all its dependencies),
a null
value must always be returned.
IOException
- if getting the JAR entry causes an
IOException to be thrown.getJarEntry()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |