Encodage et décodage d’URL en Java

L’encodage d’URL dépend du contexte. Un segment de chemin, une valeur de requête et des données application/x-www-form-urlencoded ne suivent pas exactement les mêmes règles ; utilisez donc l’API adaptée au composant manipulé.

Démarrage rapide#

L’exemple suivant utilise l’API standard de Java ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

1import java.net.URLEncoder;2import java.net.URLDecoder;3import java.nio.charset.StandardCharsets;45String encoded = URLEncoder.encode("café & tea", StandardCharsets.UTF_8);6String decoded = URLDecoder.decode(encoded, StandardCharsets.UTF_8);7System.out.println(encoded);

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

1URI uri = new URI(2    "https",3    "example.com",4    "/files/report 2026.pdf",5    null6);7System.out.println(uri.toASCIIString());

Points importants#

Encodez le composant approprié plutôt qu’une URL structurée entière. Les chemins, les valeurs de requête et les formulaires n’emploient pas exactement les mêmes règles.

Bonnes pratiques#

1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

• RFC 3986: URI Generic Syntax
• Java API Documentation