Appunti su Eclipse - Emmegi Passions

In questo piccolo manuale parlerò di Eclipse: famosa comunità open source i cui progetti sono focalizzati sulla costruzione di una piattaforma di sviluppo aperta ed estensibile che permetta l'implementazione e la gestione di tutto il ciclo di vita del software.

Tra le altre cose vedremo come impostare nel file eclipse.ini il path della JavaVM.

Breve indice del manuale:

- Settare Eclipse per l'UTF-8
- Pulire (cleaning) la configurazione di Eclipse
- Eclipse Faster: come rendere Eclipse più veloce più una serie di utili consigli
- Applicazioni Java Faster: come far andare più veloci gli applicativi Java
- Utilizzare il BIRT Viewer sotto Tomcat 5.5.X: come lanciare/utilizzare i report BIRT con - Tomcat 5.5.x
- Eclipse 3.3 e Il Visual Editor: Eclipse 3.3 e i problemi con il Visul Editor Java
- Utili PlugIn per Eclipse: raccolta e indirizzi di utli plugin
- Eclipse NSIS e i file di LOG: come abilitare i file di log in NSIS e Eclipse
- Riferimenti: Link utili

NB: in grassetto e sottolineate ci sono le sezioni nuove/modificate del manuale rispetto alla precedente versione.

Settare Eclipse per l'UTF-8

Vediamo come settare Eclipse per fare in modo di utilizzare e scrivere file in UTF-8.
Andare nel menu Window di Eclipse e scegliere la voce Preferences.
In alto a sinistra c'è la possibilità di effettuare delle ricerche.
Fare la ricerca per encod.
Eclipse mostrerà una serie di voci nelle quali si deve impostare la codifica a UTF-8.
Solo così i file che verranno scritti da Eclipse saranno conformi all'UTF-8.
Un'altra cosa da fare è l'installazione del plug-in EncodingValidator_1.0.1.zip per Eclipse che vi dice se un dato file utilizza o meno caratteri in UTF-8.

Pulire la configurazione di Eclipse

Per fare questo è sufficiente far partire Eclipse con l'opzione -clean. Questa opzione serve a fare il flush della cache del registro dei plug-in e ripulisce/ricrea i metadati del workspace di Eclipse. Da non usare sempre, ovvero come opzione di avvio sempre impostata, perché impiega un bel po' di risorse e di tempo.

Eclipse Faster

Vediamo come rendere Eclipse un po' più veloce e reattivo.

Leggete il mio aritcolo qui.

Applicazioni Java Faster

Sopra nel manuale abbiamo visto come velocizzare Eclipse, vediamo ora come, in generale, si possa aumentare la velocità delle applicazioni java utilizzando i seguenti parametri:

java -Xms64m -Xmx512m
(valori di default 32 e 128 rispettivamente)

Parametri per Tomcat:

Da mettere nelle java options:
-XX:PermSize=64M
-XX:MaxPermSize=128m

e
Initial Memory pool: 128MB
Maximum Memory pool: 400MB

Utilizzare il BIRT Viewer sotto Tomcat 5.5.X

In Eclipse, per lanciare un report usando il plugin BIRT, bisogna usare uno dei due seguenti comandi/URL:

http://localhost:8080/birt-viewer/run?__report=Report\SalesInvoice.rptdesign

utilizzando il comando "run" di BIRT per lanciare il report non verranno visualizzati i frame del viewer (sono i frame per la paginazione, per la stampa, per l'esportazione e per mostrare la TOC del report stesso)

http://localhost:8080/birt-viewer/frameset?__report=Report\SalesInvoice.rptdesign

utilizzando il comando "frameset" di BIRT verrà mostrata l'intera struttura di frame del report viewer (sono i frame per la paginazione, per la stampa, per l'esportazione e per mostrare la TOC del report stesso)

Eclipse 3.3 e il Visual Editor

Problema: in Eclipse 3.3.x.x non è possibile installare il Visual Editor.

Soluzione: Ancora nessuna soluzione. In rete si dice di tutto e di più ma il fatto è che il progetto del Visual Editor, Visual Editor Project, in data 03/03/2009 richiede ancora Eclipse 3.2 (Callisto Edition) ed il porting verso la versione 3.3.x di Eclipse è ancora in alto mare. Quindi l'unica soluzione è USARE IL VECCHIO ECLIPSE!!!

Il progetto Visual Editor di Eclipse permette la creazione grafica di Applet e programmi java mediante componenti AWT e SWING.

Cito dal sito:

"The Eclipse Visual Editor project is a vendor-neutral, open development platform supplying frameworks for creating GUI builders, and exemplary, extensible tool implementations for Swing/JFC and SWT/RCP. These tools are exemplary in that they verify the utility of the Eclipse Visual Editor frameworks, illustrate the appropriate use of those frameworks, and support the development and maintenance of the Eclipse Visual Editor Platform itself.

The purpose of the Eclipse Visual Editor Project is to advance the creation, evolution, promotion of the Eclipse Visual Editor platform, and to cultivate both an open source community and an ecosystem of complementary products, capabilities, and services. In particular, the Visual Editor Project intends to be useful for creating GUI builders for other languages such as C/C++ and alternate widget sets, including those that are not supported under Java."

Utili PlugIn per Eclipse

Questa è la lista dei plug-in per Eclipse che uso io o che considero i più utili.

Accanto al nome indico l'indirizzo che si può mettere in Eclipse alla voce Help->Software Updates (new remote site) per fare l'update/installazione automatica dei plugin.

- Codifica UTF-8: EncodingValidator_1.0.1.zip ottimo plugin per verificare che i file di un progetto siano compatibili UTF-8. Per la pagina del plugin cliccate qui. Per installare il plgin il repository da aggiungere ad Eclipse è: http://validator.ztt.fh-worms.de

- ahmadsoft: http://www.ahmadsoft.org/update

Processore FOP per file XML

- EclipseXSLT: http://eclipsexslt.sourceforge.net/update-site

Support XSLT per Eclipse

- J2ME: http://www.eclipseme.org/updates/
- NSIS: http://eclipsensis.sf.net/update

Software per la creazione di pacchetti di installazione

- PHP: http://download.eclipse.org/tools/php/updates/
- Velocity-Veloeclipse: http://propsorter.sourceforge.net/veloeclipse

Plugin per il supporto al linguaggio velocity

- JBoss: http://download.jboss.org/jbosside/updates/stable
- Plugin per Tomcat: http://www.eclipsetotale.com/tomcatPlugin.html#A3 (questo è l'indirizzo internet dal quale scaricare il plugin che va installato a mano)
- SVN per Eclipse: http://subclipse.tigris.org/update_1.2.x
- Maven - http://m2eclipse.sonatype.org/update/

Eclipse, NSIS e i file di LOG

Supponiamo di voler abilitare i file di log in fase di installazione di un determinato software e supponiamo di usare il programma NSIS ed Eclipse.
NSIS è un utile programma/plugin per la costruzione dei famosi file EXE per l'installazione di un determinato software.
Come prima cosa, bisogna aprire il file di script di NSIS che si vuole modificare.
Ci sarà una sezione principale più o meno come la seguente:

# Installer sections
Section -Main SEC0000
SetOutPath $INSTDIR\src
SetOverwrite on
File /r miaDirSorgente\*
WriteRegStr HKLM "${REGKEY}\Components" Main 1
SectionEnd

In quessta sezione si devono inserire le istruzione per abilitare la scrittura del
file di log:

LogSet on --> ABILITA LA SCRITTURA DEL FILE DI LOG
LogText "start log file" --> SCRIVE SU FILE DI LOG

Quindi la sezione diventerà:

# Installer sections
Section -Main SEC0000
SetOutPath $INSTDIR\src
SetOverwrite on
LogSet on
LogText "start log file"
File /r miaDirSorgente\*
WriteRegStr HKLM "${REGKEY}\Components" Main 1
SectionEnd

Facendo solo questo si avrà l'errore in fase di compilazione:
"Error: LogSet specified, NSIS_CONFIG_LOG not defined."

Per risolvere questo problema bisogna installare una Special Builds di NSIS.
Questa special build non fa altro che modificare alcuni file di NSIS per abilitare
la scrittura dei file di log.
La Special Build che si deve scaricare è la "Advanced logging".
E' un file zip che va scompattato nella cartella di installazione di NSIS.

Fare riferimento alla sezione "Riferimenti" per i necessari link.

CONVERTIRE IL TESTO DA MAIUSCOLO A MINUSCOLO E VICEVERSA

Per fare questo è sufficiente selezionare il testo e premere la combinazione di tasti seguente:

tutto il testo in caratteri minuscoli: CTRL+SHIFT+Y
tutto il testo in caratteri maiuscoli: CTRL+SHIFT+X

Impostare il path per la JavaVM

Se volete far partire il vostro Eclipse con una versione di Java che non è quella ufficiale installata sul PC allora bisogna agire a livello di file Eclipse.ini.

Questo è il file di configurazione che stabilisce la modalità con la quale far partire Eclipse.

Vi faccio un esempio con in grassetto l'opzione da mettere per specificare un determinato path per la JavaVM:

-startup
plugins/org.eclipse.equinox.launcher_1.4.0.v20161219-1356.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.550.v20170928-1359
-product
org.eclipse.epp.package.cpp.product
-showsplash
org.eclipse.epp.package.common
--launcher.defaultAction
openFile
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vm
D:\Portable\jdk1.8.0_20\bin\javaw.exe
-vmargs
-Dosgi.requiredJavaVersion=1.8
-Dosgi.instance.area.default=@user.home/eclipse-workspace
-XX:+UseG1GC
-XX:+UseStringDeduplication
--add-modules=ALL-SYSTEM
-Dosgi.requiredJavaVersion=1.8
-Xms256m
-Xmx1024m
--add-modules=ALL-SYSTEM

RIFERIMENTI

Ecco alcuni utili riferimenti che ho utilizzato in questo manuale.

- eclipse.org: Home Page di Eclipse

- Visual Editor Project: Home page del progetto Visual Editor

- NSIS home page : home page del software NSIS
- NSIS SPECIAL BUILDS : home page per le special builds di NSIS