Come Aggiungere un JAR a un Progetto Java in Eclipse

Quando un programma creato in Java ha la necessità di utilizzare delle librerie JAR (dall'inglese "Java ARchive") per funzionare, occorre configurare il progetto affinché includa correttamente anche tutte le librerie di cui ha bisogno in fase di compilazione. Fortunatamente, l'editor Eclipse rende questo processo estremamente semplice e facile da mettere in pratica. La versione del programma utilizzata in questo articolo è la seguente: Eclipse Java - Ganymede 3.4.0.

Parte 1

Parte 1 di 6:

Aggiungere un File JAR Interno

Scarica PDF

L'acronimo fa riferimento alla parola "libraries", cioè librerie, ed è il punto in cui andranno memorizzati tutti i file JAR che verranno richiamati all'interno del codice del progetto.
Seleziona tutti gli archivi JAR, quindi clicca su uno dei file con il tasto destro del mouse. A questo punto, clicca sulla voce "Copia" nel menu apparso, quindi incolla i file all'interno della cartella "lib" accedendo al menu File e scegliendo l'opzione Incolla. In alternativa, puoi usare la combinazione di tasti "Ctrl+V" o "Command+V".
Clicca sul nome del progetto con il tasto destro del mouse e scegli l'opzione Refresh dal menu che apparirà. La cartella lib sarà visibile all'interno dell'interfaccia di Eclipse e conterrà tutti i file JAR che hai selezionato.
Pubblicità

Parte 2

Parte 2 di 6:

Configurare il Build Path

Scarica PDF

Clicca sulla piccola icona a forma di freccia, collocata sulla sinistra della cartella "lib", per visualizzare l'elenco dei file che contiene.
Tieni premuto il tasto Ctrl, quindi clicca sui file JAR che vuoi includere nella selezione.
Verrà visualizzato un menu contestuale sulla destra dei file in oggetto.
Posiziona il puntatore del mouse sulla voce "Build Path" del menu per avere accesso al relativo menu secondario.
Tutti i file JAR indicati verranno rimossi dalla cartella lib di Eclipse e trasferiti nella scheda Referenced Libraries.
Pubblicità

Parte 3

Parte 3 di 6:

Configurare il Build Path (Metodo Alternativo)

Scarica PDF

Verrà visualizzato un menu contestuale relativo al progetto.
È una delle opzioni elencate nel menu contestuale apparso quando hai cliccato sul nome del progetto con il tasto destro del mouse. Verrà mostrato un nuovo menu secondario sulla destra del primo.
Verrà visualizzata la finestra relativa alle proprietà del progetto in cui sarà possibile configurare i percorsi dove reperire tutti i file necessari per la build del progetto.
È collocata nella parte superiore della finestra di dialogo apparsa.
È collocato sulla destra della finestra relativa alle proprietà del progetto.
I file JAR appariranno nella lista delle librerie che verranno usate per creare la build del progetto.
I file JAR selezionati saranno visibili nella sezione Referenced Libraries, anziché nella cartella lib del progetto.
Pubblicità

Parte 4

Parte 4 di 6:

Aggiungere un File JAR Esterno

Scarica PDF

1
Clicca sul nome del progetto con il tasto destro del mouse. Verrà visualizzato un menu contestuale relativo al progetto.
- Nota: è sempre meglio utilizzare file JAR che sono presenti all'interno del progetto o di un altro progetto in modo da poter tenere sotto controllo tutte le dipendenze del tuo programma direttamente da Eclipse.
Verrà visualizzato un nuovo menu secondario sulla destra del primo.
Verrà visualizzata la finestra relativa alle proprietà del progetto in cui sarà possibile configurare i percorsi dove reperire tutti i file necessari per la build del progetto.
È collocato sulla destra della finestra relativa alle proprietà del progetto.
È collocato nella parte inferiore destra della finestra di dialogo "New Variables".
È visualizzato nella parte inferiore della nuova finestra di dialogo apparsa.
Per esempio, se i file JAR fanno riferimento al server web Tomcat, potrebbe essere utile scegliere di usare il nome "TOMCAT_JAR".
8
Accedi alla directory che contiene il file JAR. Clicca sul pulsante Folder, quindi seleziona la cartella in cui è memorizzato il file JAR da usare nel progetto.
- In alternativa, puoi cliccare sul pulsante File e selezionare un singolo file JAR da assegnare alla variabile.
In questo modo, la variabile verrà creata in base alle informazioni fornite.
Così chiuderai la finestra "Preferences".
Clicca sul nome corrispondente per selezionarla.
È visualizzato nella parte inferiore destra dell'elenco delle variabili del progetto.
Clicca sul nome dei file. Tieni premuto il tasto ⇧ Shift o Ctrl se vuoi selezionare file JAR multipli.
La finestra di dialogo verrà chiusa.
16
Clicca sul pulsante OK. Verrà chiusa la finestra di dialogo relativa alla configurazione del "build path" del progetto.
- Se stai lavorando su un progetto in condivisione con altre persone, anche loro dovranno definire la medesima variabile che hai appena creato. Gli utenti con cui condividi il progetto dovranno accedere al menu Window di Eclipse, scegliere la voce Preferences, cliccare sulla scheda Java, selezionare la voce Build Path e infine cliccare sulla scheda Classpath Variables.
Pubblicità

Parte 5

Parte 5 di 6:

Aggiungere un File JAR Esterno (Primo Metodo Alternativo)

Scarica PDF

1
Clicca sul nome del progetto con il tasto destro del mouse. Verrà visualizzato un menu contestuale relativo al progetto.
- Nota: usando questo metodo, il file JAR esterno dovrà essere collocato nello stesso punto del disco rigido di tutti i computer degli utenti che useranno questo progetto. Per questo motivo, condividere questo progetto con altre persone potrebbe risultare più complicato.
Verrà visualizzato un nuovo menu secondario sulla destra del primo.
È una delle voci del menu secondario che è apparso quando hai scelto l'opzione "Build Path".
Tutti gli archivi JAR selezionati verranno aggiunti al progetto e saranno elencati nella sezione Referenced Libraries.
Pubblicità

Parte 6

Parte 6 di 6:

Aggiungere un File JAR Esterno (Secondo Metodo Alternativo)

Scarica PDF

1
Clicca sul nome del progetto con il tasto destro del mouse. Verrà visualizzato un menu contestuale relativo al progetto.
- Nota: usando questo metodo, il file JAR esterno dovrà essere collocato nello stesso punto del disco rigido di tutti i computer degli utenti che useranno questo progetto. Per questo motivo, condividere questo progetto con altre persone potrebbe risultare più complicato.
Verrà visualizzato un nuovo menu secondario sulla destra del primo.
Verrà visualizzata la finestra relativa alle proprietà del progetto in cui sarà possibile configurare i percorsi dove reperire tutti i file necessari per la build del progetto.
È elencata nella parte superiore della finestra relativa alle proprietà del progetto.
È collocato sulla destra della finestra relativa alle proprietà del progetto.
Tutti gli archivi JAR selezionati appariranno nella lista delle librerie relative al "Build Path" del progetto.
A questo punto, tutti i file JAR che hai aggiunto al progetto saranno elencati nella sezione Referenced Libraries.
Pubblicità

Consigli

Quando si aggiunge un nuovo file o una nuova cartella a un progetto di Eclipse senza utilizzare direttamente l'editor, occorre eseguire il refresh di tutti i progetti interessati, in modo che Eclipse possa rilevare i nuovi contenuti. In caso contrario, verranno generati degli errori durante la compilazione e la creazione del file eseguibile del progetto.
Anche se il file JAR interno di un progetto dovesse sparire dalla cartella lib, sarà comunque presente all'interno del file system del computer. Si tratta semplicemente del modo di Eclipse di fare capire all'utente che i file indicati sono effettivamente stati aggiunti al progetto.
Per essere preciso, potresti creare una cartella in cui memorizzare la documentazione relativa al progetto. Segui queste istruzioni:
- Clicca sul file JAR visualizzato nella scheda "Reference Libraries" del pannello "Package Explorer";
- Seleziona la scheda "Javadoc" e inserisci la cartella (o l'URL) dove è memorizzata la documentazione del progetto (attenzione: Eclipse genererà un errore durante la validazione di questa modifica, ma non preoccuparti perché tutto funzionerà ugualmente);
- Seleziona la voce "Java Source Attachment", quindi trova la cartella o il file JAR che contiene i file sorgenti.