2003-05-02 Michael Koch <konqueror@gmx.de>

* java/net/JarURLConnection.java
	(JarURLConnection): Class documentation merged with classpath.
	(getJarFileURL): Moved and documentation merged with classpath.
	(getEntryName): Likewise.
	(JarURLConnection): Documentation merged with classpath.
	(getJarEntry): Likewise.
	(getJarFile): Likewise.
	* java/net/PlainDatagramSocketImpl.java:
	Class documentation moved.
	* java/net/URLConnection.java
	(fileNameMap): Moved and documentation merged with classpath.
	(factory): Likewise.
	(defaultAllowUserInteraction): Likewis.
	(defaultUseCaches): Likewise.
	(allowUserInteraction): Likewise.
	(connected): Likewise.
	(url): Likewise.
	(connect): Documentation merged with classpath.
	(getURL): Likewise.
	(getContentLength): Likewise.
	(getContentType): Likewise.
	(getContentEncoding): Likewise.
	(getExpiration): Likewise.
	(getDate): Likewise.
	(getLastModified): Likewise.
	(getHeaderField): Likewise.
	(getContent): Likewise.
	(getPermission): Likewise.
	(getInputStream): Likewise.
	(getOutputStream): Likewise.
	(toString): Likewise.
	(getDoInput): Likewise.
	(getDoOutput): Likewise.
	(setAllowUserInteraction): Likewise.
	(getAllowUserInteraction): Likewise.
	(setDefaultAllowUserInteraction): Likewise.
	(getDefaultAllowUserInteraction): Likewise.
	(setUseCaches): Likewise.
	(getUseCaches): Likewise.
	(setIfModifiedSince): Likewise.
	(getIfModifiedSince): Likewise.
	(setDefaultRequestProperty): Likewise.
	(getDefaultRequestProperty): Likewise.
	(setContentHandlerFactory): Likewise.
	(setFileNameMap): Likewise.

From-SVN: r66379
This commit is contained in:
Michael Koch 2003-05-02 12:32:40 +00:00 committed by Michael Koch
parent 6060edcbe2
commit e23c953ac1
4 changed files with 277 additions and 70 deletions

View file

@ -54,9 +54,29 @@ import java.util.Hashtable;
import java.security.cert.Certificate;
/**
* This abstract class represents a common superclass for implementations
* of jar URL's. A jar URL is a special type of URL that allows JAR
* files on remote systems to be accessed. It has the form:
* <p>
* jar:<standard URL pointing to jar file>!/file/within/jarfile
* <p> for example:
* <p>
* jar:http://www.urbanophile.com/java/foo.jar!/com/urbanophile/bar.class
* <p>
* That example URL points to the file /com/urbanophile/bar.class in the
* remote JAR file http://www.urbanophile.com/java/foo.jar. The HTTP
* protocol is used only as an example. Any supported remote protocol
* can be used.
* <p>
* This class currently works by retrieving the entire jar file into a
* local cache file, then performing standard jar operations on it.
* (At least this is true for the default protocol implementation).
*
* @author Aaron M. Renn <arenn@urbanophile.com>
* @author Kresten Krab Thorup <krab@gnu.org>
* @since 1.2
* @date Aug 10, 1999.
*
* @since 1.2
*/
public abstract class JarURLConnection extends URLConnection
{
@ -74,18 +94,10 @@ public abstract class JarURLConnection extends URLConnection
// Cached JarURLConnection's
static Hashtable conn_cache = new Hashtable();
public URL getJarFileURL ()
{
return jarFileURL;
}
public String getEntryName ()
{
return element;
}
/**
* Creates a new JarURLConnection
* Creates a JarURLConnection from an URL object
*
* @param URL url The URL object for this connection.
*
* @exception MalformedURLException If url is invalid
*
@ -108,6 +120,29 @@ public abstract class JarURLConnection extends URLConnection
element = (bang+2==spec.length() ? null : spec.substring (bang+2));
}
/**
* This method returns the "real" URL where the JarFile is located.
* //****Is this right?*****
*
* @return The remote URL
*/
public URL getJarFileURL ()
{
return jarFileURL;
}
/**
* Returns the "entry name" portion of the jar URL. This is the portion
* after the "!/" in the jar URL that represents the pathname inside the
* actual jar file.
*
* @return The entry name.
*/
public String getEntryName ()
{
return element;
}
public synchronized void connect() throws IOException
{
// Call is ignored if already connected.
@ -201,6 +236,8 @@ public abstract class JarURLConnection extends URLConnection
/**
* Return the JAR entry object for this connection, if any
*
* @return The jar entry
*
* @exception IOException If an error occurs
*/
public JarEntry getJarEntry () throws IOException
@ -250,10 +287,11 @@ public abstract class JarURLConnection extends URLConnection
/**
* Return the JAR file for this connection
*
* @return The JarFile object
*
* @exception IOException If an error occurs
*/
public abstract JarFile getJarFile() throws IOException;
public abstract JarFile getJarFile () throws IOException;
// Steal and borrow from protocol/file/Connection.java