GsonFormatPlus est un plugin IntelliJ IDEA conçu pour générer des classes Java à partir de données JSON. Basé sur la bibliothèque Gson de Google, il accélère le développement en éliminant la rédaction manuelle de modèles de données, supportant à la fois IntelliJ IDEA et Android Studio.
Installation du plugin
Pour installer GsonFormatPlus :
- Ouvrez IntelliJ IDEA ou Android Studio.
- Accédez aux paramètres via
File -> Settings(ouAndroid Studio -> Preferencessur macOS). - Dans la secsion
Plugins, recherchez "GsonFormatPlus" et installez-le. Si indisponible, téléchargez-le manuellement depuis le dépôt officiel.
Utilisation basique
Dans un fichier Java, utilisez le raccourci Ctrl + Alt + G (configurable) pour ouvrir l'interface du plugin. Collez une chaîne JSON valide, puis confirmez pour générer la classe correspondante.
Exemple de conversion simple
JSON d'entrée :
{
"nom": "Alice",
"age": 28,
"localisation": "Lyon"
}
Classe Java générée (avec champs personnalisés) :
public class Utilisateur {
private String nom;
private int age;
private String localisation;
public String getNom() { return nom; }
public void setNom(String nom) { this.nom = nom; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
public String getLocalisation() { return localisation; }
public void setLocalisation(String localisation) { this.localisation = localisation; }
}
Cas d'utilisation avancé
Prenons un JSON imbriqué provenant d'une API REST :
{
"identifiant": 42,
"pseudo": "dev_fr",
"coordonnees": {
"rue": "123 Avenue des Champs",
"codePostal": "75008"
}
}
Le plugin génère une structure avec classe interne :
public class Profil {
private int identifiant;
private String pseudo;
private Coordonnees coordonnees;
public static class Coordonnees {
private String rue;
private String codePostal;
// Getters et Setters
}
// Getters et Setters
}
Optimisations et bonnes pratiques
- Intégration Lombok : Activez le support Lombok dans les paramètres du plugin pour réduire le boilerplate (générer automatiquement les annotations comme
@Data). - Personnalisation des champs : Modifiez les noms et types de champs générés selon les conventions de votre projet (ex. : préfixes, sérialisation spécifique).
- Formatage du code : Appliquez un formateur de code après génération pour aligner le style avec votre base de code existante.
Écosystème et intégrations
GsonFormatPlus s'appuie sur des technologies complémentaires pour un flux complet de traitemetn JSON :
- Gson : Bibliothèque principale pour la sérialisation/désérialisation JSON.
- Retrofit : Client HTTP typé, souvent utilisé avec Gson pour les appels API.
- Moshi : Alternative à Gson par Square, offrant des fonctionnalités similaires avec une API différente.
Ces outils permettent de construire des pipelines robustes, de la récupération des données à leur mapping en objets Java.