Java in a Nutshell

Previous Chapter 28
The java.net Package
Next
 

28.22 java.net.URL (JDK 1.0)

This class represents a URL (a Uniform Resource Locator) and allows the data referred to by the URL to be downloaded. A URL may be specified as a single string or with separate protocol, host, port, and file specifications. Relative URLs may also be specified with a String and the URL object that it is relative to.

getFile(), getHost(), getPort(), getProtocol(), and getRef() return the various portions of the URL specified by a URL object. sameFile() determines whether a URL object refers to the same file as this one.

The data or object referred to by a URL may be downloaded from the Internet in three ways: through a URLConnection created with openConnection(), through an InputStream created by openStream(), or through getContent(), which returns the URL contents directly, if an appropriate ContentHandler can be found.

public final class URL extends Object implements Serializable {
    // Public Constructors
            public URL(String protocol, String host, int port, String file) throws MalformedURLException;
            public URL(String protocol, String host, String file) throws MalformedURLException;
            public URL(String spec) throws MalformedURLException;
            public URL(URL context, String spec) throws MalformedURLException;
    // Class Methods
            public static synchronized void setURLStreamHandlerFactory(URLStreamHandlerFactory fac);
    // Public Instance Methods
            public boolean equals(Object obj);  // Overrides Object
            public final Object getContent() throws IOException;
            public String getFile();
            public String getHost();
            public int getPort();
            public String getProtocol();
            public String getRef();
            public int hashCode();  // Overrides Object
            public URLConnection openConnection() throws IOException;
            public final InputStream openStream() throws IOException;
            public boolean sameFile(URL other);
            public String toExternalForm();
            public String toString();  // Overrides Object
    // Protected Instance Methods
            protected void set(String protocol, String host, int port, String file, String ref);
}

Passed To:

Applet.getAudioClip(), Applet.getImage(), Applet.play(), AppletContext.getAudioClip(), AppletContext.getImage(), AppletContext.showDocument(), HttpURLConnection(), Toolkit.getImage(), URL(), URL.sameFile(), URLConnection(), URLStreamHandler.openConnection(), URLStreamHandler.parseURL(), URLStreamHandler.setURL(), URLStreamHandler.toExternalForm()

Returned By:

Applet.getCodeBase(), Applet.getDocumentBase(), AppletStub.getCodeBase(), AppletStub.getDocumentBase(), Class.getResource(), ClassLoader.getResource(), ClassLoader.getSystemResource(), URLConnection.getURL()

Type Of:

URLConnection.url


Previous Home Next
java.net.UnknownServiceException (JDK 1.0) Book Index java.net.URLConnection (JDK 1.0)

Java in a Nutshell Java Language Reference Java AWT Java Fundamental Classes Exploring Java