Android - An Open Handset Alliance Project

java.net
public abstract class

java.net.JarURLConnection

java.lang.Object
	java.net.URLConnection
		java.net.JarURLConnection

This class establishes a connection to a URL using the jar protocol. Jar URLs are specified as follows:

jar:!/{entry} where "!/" is called a seperator.

Summary

Fields

protected URLConnection jarFileURLConnection

Fields inherited from class java.net.URLConnection

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Protected Constructors

					JarURLConnection(URL url)
					Contructs an instance of `JarURLConnection`.

Public Methods

	Attributes	getAttributes()
		Answers the attributes of the JarEntry referenced by this `JarURLConnection`.
	Certificate[]	getCertificates()
		Answers the Certificates of the JarEntry referenced by this `URLConnection`.
	String	getEntryName()
		Answers the JarEntry name of the entry referenced by this `URLConnection`.
	JarEntry	getJarEntry()
		Answers the JarEntry of the entry referenced by this `URLConnection`.
abstract	JarFile	getJarFile()
		Answers the the JarFile referenced by this `URLConnection`.
	URL	getJarFileURL()
		Answers the URL of the JarFile referenced by this `URLConnection`.
	Attributes	getMainAttributes()
		Answers the main Attributes of the JarFile referenced by this `URLConnection`.
	Manifest	getManifest()
		Answers the Manifest associated with the Jar URL

Methods inherited from class java.net.URLConnection

addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getPermission, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

			void	addRequestProperty(String field, String newValue)
				Adds the given request property.
abstract			void	connect()
				Establishes the connection to the resource specified by this `URL` with this `method`, along with other options that can only be set before this connection is made.
			boolean	getAllowUserInteraction()
				Answers the value of `allowUserInteraction` which indicates if this connection allows user interaction
			int	getConnectTimeout()
				Returns a timeout of connection by milliseconds
			Object	getContent(Class[] types)
				Answers the object pointed to by this `URL`.
			Object	getContent()
				Answers the object pointed to by this `URL`.
			String	getContentEncoding()
				Answers the Content encoding type of the response body, null if no such field is found in the header response.
			int	getContentLength()
				Answers the length of the content or body in the response header in bytes.
			String	getContentType()
				Answers the type of the content.
			long	getDate()
				Answers the date in milliseconds since epoch when this response header was created, or 0 if the field `Date` is not found in the header.
		static	boolean	getDefaultAllowUserInteraction()
				Answers whether this connection allow user interaction by default.
		static	String	getDefaultRequestProperty(String field)
				This method is deprecated. Use getRequestProperty().
			boolean	getDefaultUseCaches()
				Answers whether this connection use caches by default.
			boolean	getDoInput()
				Answers whether this connection supports input.
			boolean	getDoOutput()
				Answers whether this connection supports output.
			long	getExpiration()
				Answers the date in milliseconds since epoch when this response header expires or 0 if the field `Expires` is not found in the header.
		static	FileNameMap	getFileNameMap()
				Answers the MIME table of this URL connection.
			String	getHeaderField(int pos)
				Answers the value of the field at position `pos.`
			String	getHeaderField(String key)
				Answers the value of the field corresponding to the `key` Answers `null` if there is no such field.
			long	getHeaderFieldDate(String field, long defaultValue)
				Answers the date value in the form of milliseconds since epoch corresponding to the field `field`.
			int	getHeaderFieldInt(String field, int defaultValue)
				Answers the integer value of the specified field.
			String	getHeaderFieldKey(int posn)
				Answers the name of the field at position specified by `posn`, null if there are fewer than `posn` fields.
			Map	getHeaderFields()
				Provides an unmodifiable map of the connection header values.
			long	getIfModifiedSince()
				Answers the value of `ifModifiedSince` of this connection in milliseconds since epoch
			InputStream	getInputStream()
				Creates an InputStream for reading from this URL Connection.
			long	getLastModified()
				Answers the value of the field `Last-Modified` in the response header, 0 if no such field exists
			OutputStream	getOutputStream()
				Creates an OutputStream for writing to this URL Connection.
			Permission	getPermission()
				Answers the permissions necessary to make the connection.
			int	getReadTimeout()
				Returns a timeout of reading by milliseconds
			Map	getRequestProperties()
				Provides an unmodifiable map of the request properties.
			String	getRequestProperty(String field)
				Answers the value corresponding to the field in the request Header, null if no such field exists.
			URL	getURL()
				Answers the `URL` of this connection
			boolean	getUseCaches()
				Answers whether this connection uses caches
		static	String	guessContentTypeFromName(String url)
				Determines the MIME type of the file specified by the `string` URL, using the filename extension.
		static	String	guessContentTypeFromStream(InputStream is)
				Examines the bytes of the input stream and returns the MIME type, null if no content type can be deduced.
			void	setAllowUserInteraction(boolean newValue)
				Sets the flag indicating whether this connection allows user interaction This can only be called prior to connection establishment.
			void	setConnectTimeout(int timeout)
				Sets a timeout for connection to perform non-block.
	synchronized	static	void	setContentHandlerFactory(ContentHandlerFactory contentFactory)
				Sets the current content handler factory to be `contentFactory`.
		static	void	setDefaultAllowUserInteraction(boolean allows)
				Set whether user interaction is allowed by default.
		static	void	setDefaultRequestProperty(String field, String value)
				This method is deprecated. Use getRequestProperty().
			void	setDefaultUseCaches(boolean newValue)
				Set whether caches are used by default.
			void	setDoInput(boolean newValue)
				Sets whether this URLConnection allows input.
			void	setDoOutput(boolean newValue)
				Sets whether this URLConnection allows output.
		static	void	setFileNameMap(FileNameMap map)
				With permission from the security manager, this method sets the `map` to be the MIME Table of this URL connection.
			void	setIfModifiedSince(long newValue)
				Sets the header field `ifModifiedSince`.
			void	setReadTimeout(int timeout)
				Sets a timeout for reading to perform non-block.
			void	setRequestProperty(String field, String newValue)
				Sets the value of the request header field `field` to `newValue` Only the current URL Connection is affected.
			void	setUseCaches(boolean newValue)
				Sets the flag indicating if this connection uses caches.
			String	toString()
				Answers the name of the class of the `URLConnection`

Methods inherited from class java.lang.Object

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

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Details

Fields

protected URLConnection jarFileURLConnection

Protected Constructors

protected JarURLConnection(URL url)

Contructs an instance of JarURLConnection.

Parameters

url	java.net.URL the URL that contains the location to connect to

Throws

MalformedURLException

Public Methods

public Attributes getAttributes()

Answers the attributes of the JarEntry referenced by this JarURLConnection.

Returns

java.util.jar.Attributes the attributes of the the JarEntry

Throws

IOException	thrown if an IO exception occurs while retrieving the JarEntry

public Certificate[] getCertificates()

Answers the Certificates of the JarEntry referenced by this URLConnection. This method will return null until the InputStream has been completely verified

Returns

Certificate[] the Certificates of the JarEntry.

Throws

IOException	thrown if there is an IO exception occurs while getting the JarEntry.

public String getEntryName()

Answers the JarEntry name of the entry referenced by this URLConnection.

Returns

java.lang.String the JarEntry name

public JarEntry getJarEntry()

Answers the JarEntry of the entry referenced by this URLConnection.

Returns

java.util.jar.JarEntry the JarEntry referenced

Throws

IOException

public abstract JarFile getJarFile()

Answers the the JarFile referenced by this URLConnection.

Returns

java.util.jar.JarFile the JarFile

Throws

IOException	thrown if an IO exception occurs while retrieving the Jar file

public URL getJarFileURL()

Answers the URL of the JarFile referenced by this URLConnection.

Returns

java.net.URL the URL of the JarFile.

public Attributes getMainAttributes()

Answers the main Attributes of the JarFile referenced by this URLConnection.

Returns

java.util.jar.Attributes the Attributes of the the JarFile

Throws

IOException	thrown if an IO exception occurs while retrieving the JarFile

public Manifest getManifest()

Answers the Manifest associated with the Jar URL

Returns

java.util.jar.Manifest The JarFile's Manifest

Throws

IOException

protected	boolean	allowUserInteraction
protected	boolean	connected
protected	boolean	doInput
protected	boolean	doOutput
protected	long	ifModifiedSince
protected	URL	url
protected	boolean	useCaches


e.g. "intent" or "activity"

Android - An Open Handset Alliance Project

Documentation

Goodies

java.net.JarURLConnection

Summary

Fields

Fields inherited from class java.net.URLConnection

Protected Constructors

Public Methods

Methods inherited from class java.net.URLConnection

Methods inherited from class java.lang.Object

Details

Fields

protected URLConnection jarFileURLConnection

Protected Constructors

protected JarURLConnection(URL url)

Parameters

Throws

Public Methods

public Attributes getAttributes()

Returns

Throws

public Certificate[] getCertificates()

Returns

Throws

public String getEntryName()

Returns

public JarEntry getJarEntry()

Returns

Throws

public abstract JarFile getJarFile()

Returns

Throws

public URL getJarFileURL()

Returns

public Attributes getMainAttributes()

Returns

Throws

public Manifest getManifest()

Returns

Throws