libcore.io

Class ClassPathURLStreamHandler

java.lang.Object

java.net.URLStreamHandler

libcore.net.url.JarHandler

libcore.io.ClassPathURLStreamHandler

public class ClassPathURLStreamHandler
extends JarHandler

A URLStreamHandler for a specific class path JarFile. This class avoids the need to open a jar file multiple times to read resources if the jar file can be held open. The URLConnection objects created are a subclass of JarURLConnection.

Use getEntryUrlOrNull(String) to obtain a URL backed by this stream handler.

Constructor Summary

Constructors

Constructor and Description
ClassPathURLStreamHandler(String jarFileName)

Method Summary

Modifier and Type	Method and Description
void	close() Used from tests to indicate this stream handler is finished with.
URL	getEntryUrlOrNull(String entryName) Returns a URL backed by this stream handler for the named resource, or null if the entry cannot be found under the exact name presented.
boolean	isEntryStored(String entryName) Returns true if an entry with the specified name exists and is stored (not compressed), and false otherwise.
protected URLConnection	openConnection(URL url) Returns a connection to the jar file pointed by this URL in the file system

Methods inherited from class libcore.net.url.JarHandler

parseURL, toExternalForm

Methods inherited from class java.net.URLStreamHandler

equals, getDefaultPort, getHostAddress, hashCode, hostsEqual, openConnection, sameFile, setURL, setURL

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassPathURLStreamHandler

public ClassPathURLStreamHandler(String jarFileName)
                          throws IOException

Throws:

IOException

Method Detail

getEntryUrlOrNull

public URL getEntryUrlOrNull(String entryName)

Returns a URL backed by this stream handler for the named resource, or null if the entry cannot be found under the exact name presented.

isEntryStored

public boolean isEntryStored(String entryName)

Returns true if an entry with the specified name exists and is stored (not compressed), and false otherwise.

openConnection

protected URLConnection openConnection(URL url)
                                throws IOException

Description copied from class: JarHandler

Returns a connection to the jar file pointed by this URL in the file system

Overrides:

openConnection in class JarHandler

Parameters:

url - java.net.URL The URL to which the connection is pointing to

Returns:

java.net.URLConnection A connection to the resource pointed by this url.

Throws:

IOException - thrown if an IO error occurs when this method tries to establish connection.

close

public void close()
           throws IOException

Used from tests to indicate this stream handler is finished with.

Throws:

IOException