Visualiser les chronologies de projet aide les équipes à rester alignées et à respecter les délais. Conholdate.Total for Java fournit un SDK robuste qui facilite la création d’un diagramme de Gantt en Java avec seulement quelques lignes de code. Dans ce guide, vous verrez comment configurer la bibliothèque, définir les tâches, personnaliser l’apparence et exporter le diagramme en PDF.

Configuration de Conholdate.Total pour Java

Avant de commencer à coder, assurez‑vous d’avoir Java 17 ou une version ultérieure ainsi qu’un IDE compatible Maven. Ajoutez le référentiel Maven de Conholdate et la dépendance SDK à votre pom.xml :

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>
<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Vous pouvez également télécharger les derniers JAR directement depuis la page de téléchargement. Une fois le SDK ajouté à votre classpath, vous êtes prêt à commencer à créer le graphique.

Construction étape par étape : créer un diagramme de Gantt en Java

Étape 1 : Configurer les options du graphique

Tout d’abord, créez une instance de GanttChartOptions et définissez les propriétés visuelles dont vous avez besoin. Cet objet contrôle le titre, l’échelle de la chronologie, les couleurs des barres, et plus encore.

GanttChartOptions options = new GanttChartOptions();
options.setTitle("Project Development Schedule");
options.setScale(GanttScale.DAYS);
options.setBarColor(GanttBarColor.BLUE);
options.setBarPattern(GanttBarPattern.SOLID);
options.setBarStyle(GanttBarStyle.RECTANGLE);
options.setEnableCaching(true);

Pour des descriptions détaillées des propriétés, consultez l’GanttChartOptions API.

Étape 2 : Créez l’instance GanttChart

Passez les options configurées au constructeur GanttChart.

GanttChart chart = new GanttChart(options);

L’objet graphique contient désormais le moteur de mise en page prêt à recevoir des tâches.

Étape 3 : Ajouter des tâches pour construire la chronologie

Utilisez chart.addTask pour insérer chaque phase du projet. Ajouter des tâches est le cœur de la création d’un diagramme de Gantt en Java, car chaque tâche définit une date de début et de fin.

chart.addTask("Requirement Analysis", toDate(2023, 10, 1), toDate(2023, 10, 5));
chart.addTask("Design", toDate(2023, 10, 6), toDate(2023, 10, 12));
chart.addTask("Implementation", toDate(2023, 10, 13), toDate(2023, 11, 5));
chart.addTask("Testing", toDate(2023, 11, 6), toDate(2023, 11, 20));
chart.addTask("Deployment", toDate(2023, 11, 21), toDate(2023, 11, 22));

La méthode d’assistance toDate convertit un triplet année/mois/jour en un objet java.util.Date.

Étape 4 : Exporter le graphique

Enfin, enregistrez le graphique dans un fichier. Le SDK prend en charge PDF, PNG, JPEG et d’autres formats.

chart.save("output/gantt_chart.pdf", SaveFormat.PDF);

Vous pouvez changer SaveFormat.PDF en SaveFormat.PNG ou SaveFormat.JPEG si vous avez besoin d’une sortie différente.

Étape 5 : Nettoyer les ressources

Libérez les ressources natives une fois que vous avez terminé.

chart.dispose();

Exemple complet de code : Exemple de diagramme de Gantt Java

L’exemple suivant montre comment créer un diagramme de Gantt en Java du début à la fin.

import com.groupdocs.chart.GanttChart;
import com.groupdocs.chart.options.GanttChartOptions;
import com.groupdocs.chart.enums.GanttScale;
import com.groupdocs.chart.enums.GanttBarColor;
import com.groupdocs.chart.enums.GanttBarPattern;
import com.groupdocs.chart.enums.GanttBarStyle;
import com.groupdocs.chart.enums.SaveFormat;
import java.time.LocalDate;
import java.time.ZoneId;
import java.util.Date;

public class GanttChartDemo {
    public static void main(String[] args) {
        // Configure chart appearance and timeline scale
        GanttChartOptions options = new GanttChartOptions();
        options.setTitle("Project Development Schedule");
        options.setScale(GanttScale.DAYS);               // timeline scale
        options.setBarColor(GanttBarColor.BLUE);         // default bar color
        options.setBarPattern(GanttBarPattern.SOLID);    // bar fill pattern
        options.setBarStyle(GanttBarStyle.RECTANGLE);    // bar shape
        options.setEnableCaching(true);                  // performance for large charts

// Create the Gantt chart with the defined options
        GanttChart chart = new GanttChart(options);

// Populate chart with tasks (dynamic data source can be used similarly)
        chart.addTask("Requirement Analysis", toDate(2023, 10, 1), toDate(2023, 10, 5));
        chart.addTask("Design", toDate(2023, 10, 6), toDate(2023, 10, 12));
        chart.addTask("Implementation", toDate(2023, 10, 13), toDate(2023, 11, 5));
        chart.addTask("Testing", toDate(2023, 11, 6), toDate(2023, 11, 20));
        chart.addTask("Deployment", toDate(2023, 11, 21), toDate(2023, 11, 22));

// Export the Gantt chart to PDF (other formats like PNG, JPEG are also supported)
        chart.save("output/gantt_chart.pdf", SaveFormat.PDF);

// Release resources
        chart.dispose();
    }

// Helper method to convert year/month/day to java.util.Date
    private static Date toDate(int year, int month, int day) {
        return Date.from(
                LocalDate.of(year, month, day)
                        .atStartOfDay(ZoneId.systemDefault())
                        .toInstant()
        );
    }
}

Note: Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées, et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Conclusion

Créer un diagramme de Gantt en Java devient simple avec Conholdate.Total for Java. En configurant GanttChartOptions, en ajoutant des tâches et en exportant le résultat, vous pouvez générer des chronologies d’aspect professionnel en quelques secondes. La fonction de mise en cache du SDK et les options flexibles de SaveFormat vous aident à gérer efficacement de grands projets. N’oubliez pas qu’une licence commerciale est requise pour les déploiements en production ; vous pouvez obtenir une licence temporaire depuis la page de licence temporaire ou consulter les détails des tarifs sur la page de tarification. Commencez à intégrer des diagrammes de Gantt dans vos applications dès aujourd’hui et tenez vos parties prenantes informées grâce à des plannings visuels clairs.

FAQs

Comment créer un diagramme de Gantt en Java avec Conholdate.Total ?
Utilisez les classes GanttChart et GanttChartOptions, ajoutez vos tâches avec addTask et appelez save pour exporter. Le fragment de code complet est fourni dans cet article.

Puis-je exporter le diagramme de Gantt vers des formats autres que PDF ?
Oui. La méthode chart.save accepte SaveFormat.PNG, SaveFormat.JPEG et d’autres valeurs définies dans l’énumération SaveFormat. Consultez la documentation officielle pour la liste complète.

Quelle licence est requise pour une utilisation en production ?
Une licence commerciale est obligatoire. Vous pouvez demander une licence temporaire depuis la page de licence temporaire et consulter les tarifs sur la page de tarification.

Comment puis‑je améliorer les performances pour les grands diagrammes de Gantt ?
Activez la mise en cache avec options.setEnableCaching(true) et gardez le nombre de tâches raisonnable. Le SDK est optimisé pour les grands ensembles de données, et la mise en cache réduit considérablement le temps de rendu.

En savoir plus