All Packages  Class Hierarchy  This Package  Previous  Next  Index  

Class java.net.JarURLConnection

java.lang.Object
    |
    +----java.net.URLConnection
            |
            +----java.net.JarURLConnection

public abstract class JarURLConnection

extends URLConnection

The syntax of a JAR URL is:

 jar:!/{entry}
 

for example: jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class

Jar URLs should be used to either refer to single JAR entries or as base URLs, to refer to JAR files as codebases, or relative URLs. The example above is a full 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 connection = url.openConnection(); Manifest manifest = connection.getManifest();

Examples:

A Jar entry

jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class

A Jar file

jar:http://www.foo.com/bar/baz.jar!/

A Jar directory

jar:http://www.foo.com/bar/baz.jar!/COM/foo/

!/ is refered to as the separator.

When constructing a JAR url, the following rules apply:

• if there is no context URL and the specification passed to the URL constructor doesn't contains a separator, the URL is considered to refer to a JarFile.
• if there is a context URL, the context URL is assumed to refer to a JAR file or a Jar directory.
• if the specification begins with a '/', the Jar directory is ignored, and the spec is considered to be at the root of the Jar file.

  Examples:

  context: jar:http://www.foo.com/bar/jar.jar!/, spec:baz/entry.txt
  url:jar:http://www.foo.com/bar/baz/jar.jar!/baz/entry.txt
  context: jar:http://www.foo.com/bar/jar.jar!/baz, spec:entry.txt
  url:jar:http://www.foo.com/bar/baz/jar.jar!/baz/entry.txt
  context: jar:http://www.foo.com/bar/jar.jar!/baz, spec:/entry.txt
  url:jar:http://www.foo.com/bar/baz/jar.jar!/entry.txt

Since:

JDK1.2

See Also:

URL, URLConnection, JarFile, JarInputStream, Manifest, ZipEntry

---

JarURLConnection(URL)

getAttributes()

Return the Attributes for this JAR file entry, or null if none.

getEntryName()

Return the entry name for this connection.

getIdentities()

Returns the Identity objects for this JAR entry, or null if none.

getJarEntry()

getJarFile()

Return the JarFile for this connection.

getJarFileURL()

Returns the URL for the Jar file for this connection.

getMainAttributes()

Returns the main Attributes for the JAR file, or null if none.

getManifest()

Returns the Manifest for this connection, or null if none.

JarURLConnection

protected JarURLConnection(URL url) throws MalformedURLException

getJarFileURL

public URL getJarFileURL()

Returns the URL for the Jar file for this connection.

getEntryName

public String getEntryName()

Return the entry name for this connection.

getJarFile

public abstract JarFile getJarFile() throws IOException

Return the JarFile for this connection. The returned object is not modifiable, and will throw UnsupportedOperationException.

getManifest

public Manifest getManifest() throws IOException

Returns the Manifest for this connection, or null if none.

getJarEntry

public JarEntry getJarEntry() throws IOException

getAttributes

public Attributes getAttributes() throws IOException

Return the Attributes for this JAR file entry, or null if none.

getMainAttributes

public Attributes getMainAttributes() throws IOException

Returns the main Attributes for the JAR file, or null if none.

getIdentities

public Identity[] getIdentities() throws IOException

Returns the Identity objects for this JAR entry, or null if none.

---

All Packages  Class Hierarchy  This Package  Previous  Next  Index  

---

Submit a bug or feature