La classe URL représente un localiseur de ressource uniforme (URL : Uniform Resource Locator), soit un pointeur vers une ressource sur l'internet ou un intranet.
Une ressource peut être un fichier ou un répertoire, ou encore une référence vers un objet complexe telle qu'une requête vers une base de données ou un moteur de recherche.
La syntaxe d'une adresse URL est définie par la RFC 2396 (Request For Comments 2396 : Syntaxe générique pour les URI ou Uniform Resource Identifiers (URI): Generic Syntax), améliorée par la RFC 2732 (Format pour les adresses IPv6 littérales dans les URLou Format for Literal IPv6 Addresses in URL's).
Une adresse URL est décomposable en plusieurs parties :
// Schéma FTP ftp://ftp.site.com/dossier/ressource.pdf // Schéma HTTP http://www.site.org/rep/ssrep/fichier.html // Schéma mailto mailto:boite@email.com
| Les constructeurs |
|---|
| URL(String spec) |
| crée un objet URL à partir d'une chaîne de caractères. |
| URL(String protocol, String host, int port, String file) |
| crée un objet URL à partir d'un protocole, d'un hôte, d'un numéro de port et d'un fichier. |
| URL(String protocol, String host, int port, String file, URLStreamHandler handler) |
| crée un objet URL à partir d'un protocole, d'un hôte, d'un numéro de port, d'un fichier et d'un gestionnaire. |
| URL(String protocol, String host, String file) |
| crée un objet URL à partir d'un protocole, d'un hôte, et d'un fichier. |
| URL(URL context, String spec) |
| crée un objet URL en analysant la chaîne de caractères à l'intérieur d'une adresse URL contextuelle. |
| URL(URL context, String spec, URLStreamHandler handler) |
| crée un objet URL en analysant la chaîne de caractères à l'intérieur d'une adresse URL contextuelle, et en spécifiant un gestionnaire. |
| Les méthodes |
|---|
| boolean equals(Object obj) |
| vérifie l'égalité de l'objet URL par rapport à un autre objet. |
| String getAuthority() |
| obtient la partie autorité de l'URL. |
| Object getContent() |
| obtient le contenu de l'URL. |
| Object getContent(Class[] classes) |
| obtient le contenu de l'URL par rapport à un tableau de classes. |
| int getDefaultPort() |
| obtient le numéro de port du protocole associé à l'objet URL. |
| String getFile() |
| obtient le nom de fichier de l'URL. |
| String getHost() |
| obtient le nom d'hôte de l'URL, si cela est possible. |
| String getPath() |
| obtient la partie chemin de l'URL. |
| int getPort() |
| obtient la partie numéro de port de l'URL. |
| String getProtocol() |
| obient le nom du protocole de l'URL. |
| String getQuery() |
| obtient la partie requête de l'URL. |
| String getRef() |
| obtient l'ancre de l'URL. |
| String getUserInfo() |
| obtient la partie information utilisateur de l'URL. |
| int hashCode() |
| crée une valeur hash-code pour l'objet URL. |
| URLConnection openConnection() |
| retourne un objet URLConnection qui représente une connexion vers un objet distant référencé par l'objet URL. |
| InputStream openStream() |
| ouvre une connexion pour l'objet URL et retourne un objet InputStream pour la lecture à partir de cette connexion. |
| boolean sameFile(URL other) |
| compare deux objets URL en excluant leur composant fragment. |
| protected void set(String protocol, String host, int port, String file, String ref) |
| fixe les champs de l'objet URL. |
| protected void set(String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref) |
| fixe les huit champs de l'objet URL. |
| static void setURLStreamHandlerFactory(URLStreamHandlerFactory fac) |
| fixe un objet URLStreamHandlerFactory d'application. |
| String toExternalForm() |
| retourne une chaîne de caractères représentant l'objet URL. |
| String toString() |
| retourne une chaîne de caractères représentant l'objet URL. |
| Les méthodes héritées de la classe racine java.lang.Object |
| clone, finalize, getClass, notify, notifyAll, wait, wait, wait |