Visualizzare le tempistiche dei progetti aiuta i team a rimanere allineati e a rispettare le scadenze. Conholdate.Total for Java fornisce un SDK robusto che rende facile creare un diagramma di Gantt in Java con poche righe di codice. In questa guida vedrai come configurare la libreria, definire le attività, personalizzare l’aspetto e esportare il diagramma in PDF.

Configurazione di Conholdate.Total per Java

Prima di iniziare a scrivere codice, assicurati di avere Java 17 o versioni successive e un IDE compatibile con Maven. Aggiungi il repository Maven di Conholdate e la dipendenza SDK al tuo 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>

Puoi anche scaricare i JAR più recenti direttamente dalla pagina di download. Una volta che l’SDK è nel tuo classpath, sei pronto per iniziare a creare il grafico.

Costruirlo passo dopo passo: creare un diagramma di Gantt in Java

Passo 1: Configura le opzioni del grafico

Per prima cosa, crea un’istanza di GanttChartOptions e imposta le proprietà visive di cui hai bisogno. Questo oggetto controlla il titolo, la scala della timeline, i colori delle barre e altro.

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);

Per descrizioni dettagliate delle proprietà, fare riferimento all’GanttChartOptions API.

Passo 2: Crea l’istanza GanttChart

Passa le opzioni configurate al costruttore GanttChart.

GanttChart chart = new GanttChart(options);

L’oggetto chart ora contiene il motore di layout pronto a ricevere attività.

Passo 3: Aggiungi attività per costruire la timeline

Usa chart.addTask per inserire ogni fase del progetto. L’aggiunta di attività è il fulcro di come si crea un diagramma di Gantt in Java, poiché ogni attività definisce una data di inizio e di fine.

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));

Il metodo di supporto toDate converte una tripla anno/mese/giorno in un oggetto java.util.Date.

Passo 4: Esporta il grafico

Infine, salva il grafico in un file. L’SDK supporta PDF, PNG, JPEG e altri formati.

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

Puoi cambiare SaveFormat.PDF in SaveFormat.PNG o SaveFormat.JPEG se hai bisogno di un output diverso.

Passo 5: Pulizia delle risorse

Rilascia le risorse native una volta terminato.

chart.dispose();

Esempio di Codice Completo: Esempio di Gantt Chart Java

Il seguente esempio dimostra come creare un diagramma di Gantt in Java dall’inizio alla fine.

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()
        );
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conclusione

Creare un diagramma di Gantt in Java diventa semplice con Conholdate.Total per Java. Configurando GanttChartOptions, aggiungendo attività e esportando il risultato, è possibile generare timeline dall’aspetto professionale in pochi secondi. La funzione di caching dell’SDK e le opzioni flessibili di SaveFormat ti aiutano a gestire progetti di grandi dimensioni in modo efficiente. Ricorda che è necessaria una licenza commerciale per le distribuzioni in produzione; puoi ottenere una licenza temporanea dalla pagina della licenza temporanea o esplorare i dettagli dei prezzi nella pagina dei prezzi. Inizia a integrare i diagrammi di Gantt nelle tue applicazioni oggi e tieni informati gli stakeholder con chiari programmi visivi.

FAQs

Come creo un diagramma di Gantt in Java usando Conholdate.Total?
Utilizza le classi GanttChart e GanttChartOptions, aggiungi le tue attività con addTask e chiama save per esportare. Il frammento di codice completo è fornito in questo articolo.

Posso esportare il diagramma di Gantt in formati diversi da PDF?
Sì. Il metodo chart.save accetta SaveFormat.PNG, SaveFormat.JPEG e altri valori definiti nell’enumerazione SaveFormat. Consulta la documentazione ufficiale per l’elenco completo.

Qual è la licenza richiesta per l’uso in produzione?
È obbligatoria una licenza commerciale. È possibile richiedere una licenza temporanea dalla pagina della licenza temporanea e consultare i prezzi nella pagina dei prezzi.

Come posso migliorare le prestazioni per grandi diagrammi di Gantt?
Abilita la cache con options.setEnableCaching(true) e mantieni un numero ragionevole di attività. L’SDK è ottimizzato per grandi set di dati e la cache riduce significativamente i tempi di rendering.

Leggi di più