java.lang.Object
   |
   +--java.net.URL

Deklaration

Beschreibung

Konstruktoren
public	URL(String spec)
public	URL(URL context, String spec)
public	URL(URL context, String spec, URLStreamHandler handler)
public	URL(String protocol, String host, String file)
public	URL(String protocol, String host, int port, String file)
public	URL(String protocol, String host, int port, String file, URLStreamHandler handler)

Methoden
public boolean	equals(Object obj)
public String	getAuthority()
public final Object	getContent()
public final Object	getContent(Class[] classes)
public int	getDefaultPort()
public String	getFile()
public String	getHost()
public String	getPath()
public int	getPort()
public String	getProtocol()
public String	getQuery()
public String	getRef()
public String	getUserInfo()
public int	hashCode()
public URLConnection	openConnection()
public final InputStream	openStream()
public boolean	sameFile(URL other)
protected void	set(String protocol, String host, int port, String file, String ref)
protected void	set(String protocol, String host, int port, String authority, String userinfo, String path, String query, String ref)
public static synchronized void	setURLStreamHandlerFactory(URLStreamHandlerFactory fac)
public String	toExternalForm()
public String	toString()

Konstruktoren im Detail

public URL(String spec)

Eröffnet eine URL zu dem in spec eingetragenen Objekt.

Exception: MalformedURLException

• Wenn der übergebene String keine gültige URL oder ein unbekanntes Protokoll darstellt.

public URL(URL context, String spec)

Eröffnet eine URL relativ zu context zu dem in spec eingetragenen Objekt.

Exception: MalformedURLException

• Wenn der übergebene String keine gültige URL oder ein unbekanntes Protokoll darstellt.

public URL(URL context, String spec, URLStreamHandler handler)

Eröffnet eine URL relativ zu context zu dem in spec eingetragenen Objekt. Mit handler kann ein Objekt zum Auslesen der URL-Daten angegeben werden. Ist dieser Parameter null, wird das standardmäßige Handler-Objekt verwendet. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob die Verwendung eines eigenen Handler-Objekts zulässig ist.

Exception: MalformedURLException

• Wenn der übergebene String keine gültige URL oder ein unbekanntes Protokoll darstellt.

Exception: SecurityException

• Falls keine Berechtigung zur Verwendung eigener Handler-Objekte besteht.

public URL(String protocol, String host, String file)

Eröffnet eine URL mit dem Protokoll protocol zum Host host für die Datei file.

Exception: MalformedURLException

• Wenn der übergebene String keine gültige URL oder ein unbekanntes Protokoll darstellt.

public URL(String protocol, String host, int port, String file)

Eröffnet eine URL mit dem Protokoll protocol zu einem bestimmten port des Hosts host für die Datei file.

Exception: MalformedURLException

• Wenn der übergebene String keine gültige URL oder ein unbekanntes Protokoll darstellt.

public URL(String protocol, String host, int port, String file, URLStreamHandler handler)     

Eröffnet eine URL mit dem Protokoll protocol zu einem bestimmten port des Hosts host für die Datei file. Mit handler kann ein Objekt zum Auslesen der URL-Daten angegeben werden. Ist dieser Parameter null, wird das standardmäßige Handler-Objekt verwendet. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob die Verwendung eines eigenen Handler-Objekts zulässig ist.

Exception: MalformedURLException

• Wenn der übergebene String keine gültige URL oder ein unbekanntes Protokoll darstellt.

Exception: SecurityException

• Falls keine Berechtigung zur Verwendung eigener Handler-Objekte besteht.

Methoden im Detail

public boolean equals(Object obj)

Liefert genau dann true, wenn obj ein Exemplar der Klasse URL ist, das denselben Wert besitzt wie dieses Objekt, sonst false.

public String getAuthority()     

Liefert den Authority-Teil der URL zurück.

public final Object getContent()

Liefert ein Objekt, das den Inhalt repräsentiert. Standardmäßig werden Exemplare folgender Klassen zurückgegeben:

• Image für Bilder
• AudioClip für Audiosequenzen
• InputStream für alle anderen Daten

Exception: IOException

• Falls beim Schließen Laden des Inhalts ein Fehler aufgetreten ist.

public final Object getContent(Class[] classes)     

Liefert den Inhalt zurück. Das zurückgelieferte Objekt gehört zu einer der übergebenen Klassen.

Exception: IOException

• Falls beim Schließen Laden des Inhalts ein Fehler aufgetreten ist.

public int getDefaultPort()     

Liefert den Standard-Port des Protokolls dieser URL zurück.

public String getFile()

Liefert den Namen der Datei.

public String getHost()

Liefert den Namen des Hosts.

public String getPath()     

Liefert den Pfadanteil der URL zurück.

public int getPort()

Liefert die Nummer des Ports. Beim Rückgabewert -1 wurde kein Port eingestellt.

public String getProtocol()

Liefert den Namen des verwendeten Protokolls.

public String getQuery()     

Liefert den Query-Anteil der URL zurück.

public String getRef()

Liefert den Namen der Marke, an die im Dokument gesprungen werden soll.

public String getUserInfo()     

Liefert die Benutzerinformationen der URL zurück.

public int hashCode()

Liefert einen Hashcode für das URL-Objekt.

public URLConnection openConnection()

Liefert ein URLConnection-Objekt für die URL, mit dem bidirektionaler Datenaustausch mit der URL möglich ist.

Exception: IOException

• Falls beim Öffen der Verbindung ein Fehler aufgetreten ist.

public final InputStream openStream()

Eröffnet einen InputStream für das URL-Objekt, mit dem die URL-Daten gelesen werden können.

Exception: IOException

• Falls beim Öffen des Streams ein Fehler aufgetreten ist.

public boolean sameFile(URL other)

Liefert true, wenn other effektiv dieselbe Datei bezeichnet wie dieses URL-Objekt.

protected void set(String protocol, String host, int port, String file, String ref)

Kann in einer Unterklasse oder von einem URLStreamHandler benutzt werden, um die Elemente zu setzen.

protected void set(String protocol, String host, int port, String authority, String userinfo, String path, String query, String ref)

Kann in einer Unterklasse oder von einem URLStreamHandler benutzt werden, um die Elemente zu setzen.

public static synchronized void setURLStreamHandlerFactory(URLStreamHandlerFactory fac)

Stellt ein neues Factory-Objekt ein, das Objekte zum Umgang für bestimmte Protokolle liefert.

Exception: Error

• Falls das Factory-Objekt bereits gesetzt war.

public String toExternalForm()

Liefert über einen Aufruf der entsprechenden Methode des Handler-Objekts den URL-Verweis im Klartext zurück. toString() benutzt das Ergebnis dieser Methode zur Rückgabe einer String-Darstellung dieser Klasse.

public String toString()

Liefert einen String, der das verwendete Protokoll, den Host-Namen und den Namen der bezeichneten Datei enthält.