L'Altruiste : Le langage Java - La classe <i>URLConnection</i>

La classe abstraite URLConnection est la superclasse de toutes les classes qui représentent une liaison de communication entre l'application et une adresse URL.

Les instances de cette classe peuvent être utilisées pour lire et écrire sur la ressource référencée par l'objet URL.

En général, la création d'une connexion vers un objet URL est un processus à plusieurs étapes.

La méthode openConnection() de la classe URL, permet de créer un objet URLConnexion à partir de l'objet URL, qui concerne la connexion vers la ressource distante.
```
URLConnection oURLConnexion = oURL.openConnection();
```
la méthode connect() permet d'établir la connexion effective vers la ressource distante à partir de l'objet URLConnection précédemment créé.
```
oURLConnexion.connect();
```

Les champs
protected boolean allowUserInteraction
Si le champ est égal à true, l'URL est examinée dans un contexte dans lequel il crée une raison de permettre les interactions utilisateurs.
protected boolean connected
Si le champ est égal à false, l'objet URLConnection n'a pas créé un lien de communication vers l'URL spécifié.
protected boolean doInput
Ce champ indique que l'application à l'intention de lire des données vers l'objet URLConnection s'il est à true.
protected boolean doOutput
Ce champ indique que l'application à l'intention d'écrire des données vers l'objet URLConnection s'il est à true.
protected long ifModifiedSince
Certains protocoles supportent skipping the fetching de l'objet à moins que l'objet ait été modifié plus récemment par rapport à un certain temps.
protected URL url
Ce champ représente l'objet distant sur Internet ou un intranet vers lequel la connexion est ouverte.
protected boolean useCaches
Si le champ est égal à true, le protocole est autorisé à utiliser le cachage tant qu'il le peut.

Les constructeurs
protected URLConnection(URL url)
crée un objet URLConnection vers l'adresse URL spécifiée.

Les méthodes
void addRequestProperty(String key, String value)
ajoute une propriété de requête générale spécifiée par une paire clé-valeur.
abstract void connect()
ouvre un lien de communication vers la ressource référencée par l'objet URL, si une connexion n'a pas déjà été établie.
boolean getAllowUserInteraction()
retourne la valeur du champ allowUserInteraction de l'objet URLConnection.
Object getContent()
récupère le contenu de l'objet URLConnection.
Object getContent(Class[] classes)
récupère le contenu de l'objet URLConnection correspondant aux types spécifiés dans le tableau de classes.
String getContentEncoding()
retourne la valeur du champ d'entête content-encoding.
int getContentLength()
retourne la valeur du champ d'entête content-length.
String getContentType()
retourne la valeur du champ d'entête content-type.
long getDate()
retourne la valeur du champ d'entête date.
static boolean getDefaultAllowUserInteraction()
retourne la valeur par défaut du champ allowUserInteraction.
static String getDefaultRequestProperty(String key)
Dépréciée. Voir getRequestProperty().
boolean getDefaultUseCaches()
retourne la valeur par défaut du champ useCaches de l'objet URLConnection.
boolean getDoInput()
retourne la valeur du champ doInput de l'objet URLConnection.
boolean getDoOutput()
retourne la valeur du champ doOutput de l'objet URLConnection.
long getExpiration()
retourne la valeur du champ d'entête expires.
static FileNameMap getFileNameMap()
charge la description de nom de fichier à partir des données du fichier.
String getHeaderField(int n)
retourne la clé pour le champ d'entête n^th.
String getHeaderField(String name)
retourne la valeur du champ d'entête header.
long getHeaderFieldDate(String name, long Default)
retourne la valeur du champ désigné analysé comme une date.
int getHeaderFieldInt(String name, int Default)
retourne la valeur du champ désigné analysé comme un nombre.
String getHeaderFieldKey(int n)
retourne la clé pour le champ d'entête n^th.
Map getHeaderFields()
retourne une description non-modifiable des champs d'entête.
long getIfModifiedSince()
retourne la valeur du champ ifModifiedSince de l'objet URLConnection.
InputStream getInputStream()
retourne un flux d'entrée qui lit à partir de la connexion ouverte.
long getLastModified()
retourne la valeur du champ d'entête last-modified.
OutputStream getOutputStream()
retourne un flux de sortie qui écrit vers la connexion ouverte.
Permission getPermission()
retourne un objet Permission représentant la permission nécessaire pour créer la connexion représentée par l'objet URLConnection.
Map getRequestProperties()
retourne une description non-modifiable des propriétés de requêtes générales pour l'objet URLConnection.
String getRequestProperty(String key)
retourne la valeur de la propriété de requête générale désignée pour l'objet URLConnection.
URL getURL()
retourne la valeur du champ URL de l'objet URLConnection.
boolean getUseCaches()
retourne la valeur du champ useCaches de l'objet URLConnection.
static String guessContentTypeFromName(String fname)
essaie de déterminer le type de contenu d'un objet, basé sur le composant de fichier spécifié d'une adresse URL.
static String guessContentTypeFromStream(InputStream is)
essaie de déterminer le type d'un flux d'entrée basé sur les caractères au commencement du flux d'entrée.
void setAllowUserInteraction(boolean allowuserinteraction)
fixe la valeur du champ allowUserInteraction de l'objet URLConnection.
static void setContentHandlerFactory(ContentHandlerFactory fac)
fixe l'objet ContentHandlerFactory d'une application.
static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)
fixe la valeur par défaut du champ allowUserInteraction pour les futures objets URLConnection, à la valeur spécifiée.
static void setDefaultRequestProperty(String key, String value)
Dépréciée. Voir setRequestProperty().
void setDefaultUseCaches(boolean defaultusecaches)
fixe la valeur par défaut du champ useCaches à la valeur spécifiée.
void setDoInput(boolean doinput)
fixe la valeur par défaut du champ doInput à la valeur spécifiée.
void setDoOutput(boolean dooutput)
fixe la valeur par défaut du champ doOutput à la valeur spécifiée.
static void setFileNameMap(FileNameMap map)
fixe l'objet FileNameMap pour l'objet URLConnection.
void setIfModifiedSince(long ifmodifiedsince)
fixe la valeur du champ ifModifiedSince de l'objet URLConnection, à la valeur spécifiée.
void setRequestProperty(String key, String value)
fixe la propriété de requête générale.
void setUseCaches(boolean usecaches)
fixe la valeur du champ useCaches de l'objet URLConnection à la valeur spécifiée.
String toString()
retourne une représentation textuelle de l'objet URLConnection.
Les méthodes héritées de la classe racine java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait