Eclipse RCP: aggiungere voci di menu dinamiche

Eclipse mette a disposizione un semplice meccanismo che permette di aggiungere in maniera dinamica delle voci ad un menu contestuale.

Per creare un menu è necessario dichiarare nel plugin.xml un estension point org.eclipse.ui.menus.
Supponiamo di voler aggiungere un nuovo menu alla toolbar dell'applicazione.
Aggiungiamo all'extension poin org.eclipse.ui.menus un menuContribution con

locationURI="menu:org.eclipse.ui.main.menu?after=additions"

Lo schema menu indica che il nuovo menu deve apparire sulla toolbar, mentre after=additions indica che deve apparire dopo i menu standard.

Al menuContribution aggiungiamo ora un menu, indicando id e label.

      point="org.eclipse.ui.menus">
            locationURI="menu:org.eclipse.ui.main.menu?after=additions">
                 id="it.sinossi.menu.toolbarMenu"
            label="Menu Dinamico">
      
   

Aggiungiamo ora al menu un nodo di tipo dynamic e specifichiamo gli attributi id e class

      point="org.eclipse.ui.menus">
            locationURI="menu:org.eclipse.ui.main.menu?after=additions">
                 id="it.sinossi.menu.toolbarMenu"
            label="Menu Dinamico">
                                  id="it.sinossi.menu.sinossiCompoundContributionItem"
                   class="it.sinossi.menu.SinossiCompoundContributionItem">
            
      
   

La classe it.sinossi.menu.sinossiCompoundContributionItem deve estendere la classe astratta org.eclipse.ui.actions.CompoundContributionItem e implementare il metodo getContributionItems

import org.eclipse.jface.action.IContributionItem;
import org.eclipse.swt.SWT;
import org.eclipse.ui.PlatformUI;
import org.eclipse.ui.actions.CompoundContributionItem;
import org.eclipse.ui.menus.CommandContributionItem;
import org.eclipse.ui.menus.CommandContributionItemParameter;


public class SinossiCompoundContributionItem extends CompoundContributionItem
{
    private static int counter = 0;

    @Override
    protected IContributionItem[] getContributionItems()
    {
        final CommandContributionItemParameter contributionParameter = 
               new CommandContributionItemParameter(
                   PlatformUI.getWorkbench().getActiveWorkbenchWindow(),
                   "it.sinossi.menu.sinossiCompoundContributionItem", 
                   "it.sinossi.command.dynamicCommand",
                   SWT.NONE);
        contributionParameter.label = "Dynamic Menu Item " + counter++;
               items[i] = new CommandContributionItem(contributionParameter);
        }
        return new IContributionItem[] { new CommandContributionItem(contributionParameter) };
    }
}

Il metodo restituisce un array di IContributionItem. Ogni elemento dell'array è un oggetto di classe org.eclipse.ui.menus.CommandContributionItem, e rappresenta una voce da aggiungere al menu. Ogni CommandContributionItem è costruito a partire da un org.eclipse.ui.menus.CommandContributionItemParameter, che contiene le caratteristiche della voce stessa.
Nel suo costruttore infatti devono essere specificati l'id dell'elemento dynamic a cui associare il CommandContributionItem e l'id del command che dovra essere eseguito quando la voce viene selezionata.
Si noti che il metodo getContributionItems viene eseguito ogni volta che viene aperto il menu, perciò la variabile counter verrà incrementata ogni volta e questo fa si che la label della voce di menu sia aggiornata dinamicamente.

Nel plugin.xml aggiungiamo l'estension point org.eclipse.ui.commands per definire il command e l'handler di default che saranno attivati alla selezione della voce

      point="org.eclipse.ui.commands">
            id="it.sinossi.command.dynamicCommand"
         defaultHandler="it.sinossi.command.DynamicCommand"
         name="Dynamic Command">
   

Concaterare liste con Spring

E' possibile concatenare liste di oggetti in Spring.
Con Spring 2.5 esistono due possibilità:

1) utilizzando la gerarchia di bean

  
    
      Foo
    
  


  
    
      Bar
    
  


  
    
      Ernie
      Bert
    
  

In questo modo listTree conterrà [Foo, Bar, Ernie, Bert].
Se non si vuole introdurre una gerarchia di bean, bisogna seguire un'altra strada.

2) creando una classe apposita che esegue la concatenazione

package com.company.utils.spring;
import java.util.*;
import org.springframework.beans.factory.config.ListFactoryBean;

public class ListMergerFactory extends ListFactoryBean 
{
 private final List listOfLists;

 public ListMergerFactory(List listOfLists) throws Exception 
 {
  this.listOfLists = listOfLists;
  setSourceList(new ArrayList());
 }

 protected Object createInstance() 
 {
  List listOrigin = (List) super.createInstance();
  for (Iterator iter = listOfLists.iterator(); iter.hasNext();) 
  {
   List element = (List) iter.next();
   listOrigin.addAll(element);
  }
 return listOrigin;
 }
}

E utilizzandola per creare la lista finale:

  
    
      
        Foo
      
    
  
  
    
      
        Bar
      
    
  
  
    
      
         
         
      
    
  
  
    
    
      
      Ernie
      Bert
      
    
  

Anche in questo modo listTree conterrà [Foo, Bar, Ernie, Bert].

Securely delete files in Linux

Shred is a command line utility which can be used to securely delete files or entire file-systems.
It overwrites the file repeatedly (on my system default is 3 times, but can be specified) in order to make harder to recover the data with professional tools.
As usual for Unix's utility you can tune the program specifying parameters such as the number of overwrites.

Examples

Delete a single file:

shred -f -u -v /home/marco/file_with_secrets.txt

• -f change permissions to allow writing if necessary
• -u truncate and remove file after overwriting
• -v show progress

Wipe an entire disk partition:

shred -n 10 -z -v  /dev/sdb3

• -n # Overwrite # times instead of the default
• -z add a final overwrite with zeros to hide shredding

Note: shred could be not so effective overwriting files in journaled file-systems (like ext3, ext4 ReiserFS, XFS, JFS) or RAID based file-systems.

Links:

shred invocation
shred - Linux man page

How to mirror a remote subversion repository

When dealing with a remote repository the svnadmin command doesn't work, because it can only be used on the machine that holds the repository. But Subversion meets our need with the svnsycn command.

Svnsync works by essentially asking the Subversion server to “replay” revisions, one at a time. Neither the source nor the target repository needs to be locally accessible to machine on which svnsync is running, all the requirements are read access to the source repository and read/write access to the target/mirror repository.

Svnsync stores its bookkeeping information in special revision properties on revision 0 of the destination repository, but in order to make changes to revision properties you'll need to explicitly implement the pre-revprop-change hook, and your script must allow svnsync to set and change its special properties.

Let's see a script for local mirroring a remote svn repository:

TARGET_REPO_PATH=/tmp/svn/mirror_repo
SOURCE_REPO_PATH=https://xyz.svn.sourceforge.net/svnroot/xyz
SOURCE_REPO_USER=anonymous

svnadmin create $TARGET_REPO_PATH
echo '#!/bin/sh' > $TARGET_REPO_PATH/hooks/pre-revprop-change
chmod +x $TARGET_REPO_PATH/hooks/pre-revprop-change
svnsync init file://$TARGET_REPO_PATH $SOURCE_REPO_PATH --source-username $SOURCE_REPO_USER
svnsync sync file://$TARGET_REPO_PATH --source-username $SOURCE_REPO_USER

In line 5 we create the local target repository

In lines 6 and 7 we create the pre-revprop-change hook and make it executable

In line 8  we register in our target repository the fact that it will be a mirror of the source repository. We do this using the svnsync initialize subcommand. Our target repository will now remember that it is a mirror of the public Subversion source code repository (in Subversion 1.5, you can use svnsync to mirror only some subtree of the repository)

In line 9  with a single subcommand, we can tell svnsync to copy all the as-yet-unmirrored revisions from the source repository to the target. Svnsync performs careful bookkeeping that allows it to be safely interrupted and restarted without ruining the integrity of the mirrored data.
Do not modify a mirror repository in such a way as to cause its version history to deviate from that of the repository it mirrors. The only commits and revision property modifications that ever occur on that mirror repository should be those performed by the svnsync tool.

Whenever we want to update the mirror applying the changes from the remote source repository we just have to call the svnsync sync command as in line 9 of the example script.


Copyright note: most of this post comes from Version Control with Subversion.

See also:

Version Control with Subversion - Repository Administration - Repository Replication
Version Control with Subversion - Repository Administration - Implementing Repository Hooks
Version Control with Subversion - Repository Hooks - pre-revprop-change

Come abilitare lo shortcut di Eclipse "Search Occurrences in File" nell'ambiente Gnome

Come abilitare lo shortcut di Eclipse "Search Occurrences in File" nell'ambiente Gnome

Durante l'analisi del codice i comandi più utili messi a siposizione da Eclipse sono probabilemnte quelli di ricerca (sotto la voce di menù Search). Tra questi uno di quelli che uso più spesso è Search > Occurrences in File, che, come dice il nome, cerca le occorrenze dell'elemento selezionato all'interno del file aperto. La particolarità di questo comando è che, a differenza di altri comandi di ricerca come ad esempio Search > References, nella vista dei risultati della ricerca mostra proprio il contenuto delle righe in cui è presente il riferimento, permettendo di individuare in maniera molto semplice l'uso che viene fatto.

Esempio di Search References per la variabile "t":

Esempio di Search Occurrences in File per la variabile "t":

Il problema nell'usare questo comando nasce negli ambienti Gnome, in cui quello che è lo shortcut predefinito (SHIFT + CTRL + U) è associato all'inserimento dei caratteri unicode e quindi non funziona all'interno di Eclipse.
Per modificare la combinazione di tasti predefinita:

• Aprire Window > Preferences
• Selezionare General > Keys
• Inserire nel filtro di ricerca la stringa occurrences
• Selezionare la voce Shows the Occurrences in File quick menu in corrispondenza della quale la colonna "When" indica "In Windows"
• Modificare il campo Binding inserendo la combinazione tasti desiderata
• Cliccare su "OK" per uscere

La combinazione tasti che ho scelto nella mia configurazione è SHIFT + CTRL + Z, in quanto era libera ed è semplice da usare anche con una sola mano.

Vedi anche:

Eclipse Help - Searching the workbench
Eclipse Help - Java Search
Eclipse Help - Search Actions
Ubuntu Documentation > Community Documentation > ComposeKey > Unicode composition
Sinossi's Blog - Come inserire caratteri speciali in Linux

Merge tracking con Subversion 1.5

Una delle novità introdotte nella versione 1.5 di Subversion è la capacità di tenere traccia dei merge, ovvero include quelle funzionalità che prima venivano garantite da tool esterni come lo script python svnmerge.py.

La storia dei merge effettuati viene mantenuta tramite la proprietà svn:mergeinfo.

Supponiamo di avere nel trunk il ramo di sviluppo principale e di avere su un branch chiamato feature_dev gli sviluppi relativi ad una nuova funzionalità. Alla fine dello sviluppo il branch feature_dev dovrà essere riportato sul trunk.

I percorsi svn coinvolti sono:

• https://svn.sinossi.it/svn/myproject/trunk
• https://svn.sinossi.it/svn/myproject/branches/feature_dev

I comandi messi a disposizione da SVN per gestire il merge sono:

• svn merge
• svn mergeinfo

Il primo serve per effettuare il merge vero e proprio, il secondo mostra delle informazioni relative ai merge.

Poichè la destinazione del merge è il trunk usiamo questo come working copy. Vediamo lo stato attuale del merge

> svn co https://svn.sinossi.it/svn/myproject/trunk
> cd trunk
trunk> svn mergeinfo https://svn.sinossi.it/svn/myproject/branches/feature_dev
[nessun output]
trunk> svn mergeinfo --show-revs eligible https://svn.sinossi.it/svn/myproject/branches/feature_dev
r195
r196
r197
r198
r220
r221

Poichè ci interessa modificare il trunk usiamo quello come working copy, e come indirizzo di confronto quello del branch feature_dev, che è quello di rispetto a cui vogliamo conoscere lo stato dei merge fatti e/o da fare.
Il primo comando mostra l'elenco dei commit che sono stati riportati da feature_dev verso trunk (non essendo stato ancora effettuato nessun merge non è indicata nessuna revisione); il comando mergeinfo con l'opzione --show-revs eligible mostra i commit che sono stati effettuati su feature_dev e non sono ancora stati portati sul trunk.

Tramite il comando

> svn log https://svn.sinossi.it/svn/myproject/branches/feature_dev

siamo in grado di capire quali commit debbano essere riportati sul trunk e quali no.

Supponiamo di voler riportare il commit 198, il comando sarà

trunk> svn merge -c 198 https://svn.sinossi.it/svn/myproject/branches/feature_dev
trunk> svn commit -m "rientro del branch feature_dev"

Questo applicherà sul trunk le mofiche relative al commit 198 effettuato sul branch feature_dev.
Le modifiche effettuate da svn merge sono locali, quindi per renderle effettive sarà necessario committare.

Se prima di committare si lancia il comando svn status si noterà che molte cartelle sono state modificate, più di quelle coinvolte nel commit 198, questo perchè è stata aggiunta la proprietà svn:mergeinfo che tiene appunto memeoria dei merge effettuati.

Se ora riproviamo ad esaminare lo stato dei merge avremo

trunk> svn mergeinfo https://svn.sinossi.it/svn/myproject/branches/feature_dev
r198
trunk> svn mergeinfo --show-revs eligible https://svn.sinossi.it/svn/myproject/branches/feature_dev
r195
r196
r197
r220
r221

Quindi il commit 198 risulta riportato sul trunk, gli altri sono ancora disponibili.
Supponiamo di sapere che i commit 195,196,197 non debbano essere portati, svn merge permette di considerare i commit come integrati anche senza riportare realmente sul trunk le modifiche, questo può essere fatto tramite l'opzione --record-only

trunk> svn merge --record-only -c 195,196,197 https://svn.sinossi.it/svn/myproject/branches/feature_dev
trunk> svn commit -m "rientro del branch feature_dev"

Il commit è necessario per aggiornare nel repository lo stato della proprietà svn:mergeinfo, ma con l'opzione --read-only non viene apportata nessuna modifica ai nostri file.
A questo punto lo stato è:

trunk> svn mergeinfo https://svn.sinossi.it/svn/myproject/branches/feature_dev
r195
r196
r197
r198
trunk> svn mergeinfo --show-revs eligible https://svn.sinossi.it/svn/myproject/branches/feature_dev
r220
r221

Ora le commit 195, 196 e 197 risultano integrate.


Come ulteriore esempio vediamo il caso in cui si voglia aggiornare un tag riportando un commit effettuato sul trunk.
I rami coinvolti sono

• https://svn.sinossi.it/svn/myproject/trunk
• https://svn.sinossi.it/svn/myproject/tags/1.0.3

Poichè la destinazione del merge è il tag usiamo questo come working copy un checkout del tag 1.0.3.

> svn co https://svn.sinossi.it/svn/myproject/tags/1.0.3
> cd 1.0.3
1.0.3> svn mergeinfo https://svn.sinossi.it/svn/myproject/trunk
[nessun output]
1.0.3> svn mergeinfo --show-revs eligible https://svn.sinossi.it/svn/myproject/trunk
r234
r237
r238

Il commit che si vuole riportare è il 238:

trunk> svn merge -c 238 https://svn.sinossi.it/svn/myproject/trunk
trunk> svn commit -m "aggiornamento del tag 1.0.3"

Lo stato del merge ora sarà:

1.0.3> svn mergeinfo https://svn.sinossi.it/svn/myproject/trunk
r238
1.0.3> svn mergeinfo --show-revs eligible https://svn.sinossi.it/svn/myproject/trunk
r234
r237

Per sfruttare al meglio le funzionalità introdotte con il tracking dei merge è stata aggiunta l'opzione -g (oppure --use-merge-history) ai comandi svn log e svn blame, ciò permette di utilizzare le informazioni relative ai merge nell'output di questi comandi.
Come ultima indicazione, per chi ha utilizzato lo script svnmerge.py per tracciare i merge, è disponibile lo script svnmerge-migrate-history.py che consente di migrare alla modalità di merge di Subversion 1.5 senza perdere lo storico delle informazioni di merge accumulate.


Per maggiorni informazioni vedere anche:

Subversion 1.5 release notes
svn merge
svn mergeinfo
svnmerge.py

Top Level Class e Nested Class in Java

La Top Level Class è una classe la cui dichiarazione non risiede all'interno di un'altra classe o di un'interfaccia. Tutti i tipi che vengono dichiarati all'interno di una Top Level Class possono essere indicati con il termine nested.

Vi sono svariati modi in cui i tipi nested possono essere dichiarati all'interno di una Top Level Class. Ad esempio, tutti i tipi nested non static sono membri della classe contenitore. I tipi dichiarati static invece, non possono essere essere considerati membri della classe contenitore. La differenza fondamentale sta nel fatto che i membri sono instanziati al momento in cui viene istanziata la classe contenitore e sono fortemente accoppiati con essa. I tipi statici invece presentano un livello di accoppiamento più debole e non dipendono direttamente da un'istanza della classe contenitore, ma solo da un suo riferimento.

Fra i tipi permessi, vi è anche il tipo class. Infatti Java permette di dichiarare una classe all'interno di una Top Level Class. La classe dichiarata internamente è detta Nested Class. La Nested Class segue le regole di tutti gli altri tipi, infatti può essere dichiarata public, private, protected o package private e può essere static.

Una Static Nested Class può essere definita nel seguente modo:

public class OuterWithStaticNested {

  private String outerField;

  private static String OUTER_STATIC_FIELD = "Outer Static Field";

  public OuterWithStaticNested(String outerField) {
   this.outerField = outerField;
  }

  public String getOuterField() {
   return outerField;
  }

  static class StaticInnerClass {

   void print() {
    System.out.println(OUTER_STATIC_FIELD);
    System.out.println(new OuterWithStaticNested("Outer Field")
      .getOuterField());
   }

  }

}

Dal punto di vista comportamentamentale la Static Nested Class è molto simile ad una Top Level Class. Non ha, infatti, accesso diretto a membri e metodi privati della classe che la contiene, e per utilizzarli, deve appoggiarsi ad un'istanza concreta della classe contenitore. Ha invece accesso diretto ai tipi statici, anche se privati. Questo implica un basso livello di accoppiamento fra la Top Level Class e la Static Nested Class, la quale può essere istanziata in maniera diretta, senza che ci sia bisogno di un'istanza della Top Level Class.

StaticNestedClass staticNestedClass = new OuterWithStaticNested.StaticNestedClass();

Le Inner Classes sono invece fortemente accoppiate con l Top Level Class in cui sono dichiarate. Hanno infatti accesso a tutti i membri e metodi privati della classe contenitore e possono essere a loro volta considerate come un membro di essa.

public class OuterWithInner {

private String outerField;

private static String OUTER_STATIC_FIELD = "Outer Static Field";

public OuterWithInner(String outerField) {
 this.outerField = outerField;
}

class InnerClass {

 void print() {
  System.out.println(outerField);
  System.out.println(OUTER_STATIC_FIELD);
 }

}

}

A testimonianza di questo forte accoppiamento, la Inner Class può essere inizializzata esternamente alla Top Level Class solo a partire da una sua istanza concreta.

OuterWithInner outerClass = new OuterWithInner("Outer Field");
InnerClass innerClass = outerClass.new InnerClass();

Per questi motivi, una Inner Class non può contenere metodi o membri statici.

Fra le Nested Classes troviamo anche le Anonymous Inner Class, cioè classi che vengono dichiarate e istanziate nel punto in cui devono essere usate. Non hanno nome e non possono essere considerate come un membro della classe in cui sono dichiarate. Sono permesse in qualunque punto in cui è ammessa una espressione.

Possono essere dichiarate sia in un contesto statico che non statico, ma non possono avere membri statici.

Uso comune delle Anonymous è la creazione di oggetti funzionali (cioè istanze di classi senza stato, i cui metodi operano solo sugli oggetti passati nella signature) “on the fly”. Un tipico esempio è l'utilizzo del metodo

java.util.Collections.sort(List, Comparator)

dove spesso si implementa un Comparator "al volo" per indicare la logica di ordinamento degli elementi.

public class OuterWithAnonymous {

private List outerFields;

public OuterWithAnonymous(List outerFields) {
 this.outerFields = outerFields;
}

public void sortOuterFieldsByFieldLenghtAsc() {
 Collections.sort(outerFields, new Comparator() {

  @Override
  public int compare(String field1, String field2) {
   if (field1.length() > field2.length()) {
    return 1;
   } else if (field1.length() == field2.length()) {
    return 0;
   } else {
    return -1;
   }
  }

 });
}
}

Altro caso d'uso frequente è per la creazione di oggetti process come Runnable, Thread o TimerTask.

Infine, il tipo meno comune di Nested Class è la Local Class. Le Local Classes sono dichiarate all'interno di un metodo, allo stesso modo di una variabile locale, e obbediscono alla stessa politica di scope.

public class OuterWithLocal {

private List outerFields;

public OuterWithLocal(List outerFields) {
 this.outerFields = outerFields;
}

public void sortOuterFieldsByFieldLenghtAsc() {
 Comparator stringComparator = new Comparator() {

  @Override
  public int compare(String field1, String field2) {
   if (field1.length() > field2.length()) {
    return 1;
   } else if (field1.length() == field2.length()) {
    return 0;
   } else {
    return -1;
   }
  }

 };
 Collections.sort(outerFields, stringComparator);
}
}

Come le Inner Classes, hanno nome e possono essere utilizzate più volte.Come le Anonimous Inner Classes, non possono avere membri statici e hanno un riferimento alla classe contenitore solo se sono dichiarate in un contesto non statico.

Le quattro tipoligie di Nested Classes hanno tutte caratteristiche diverse, che possono tradursi in svantaggi se non sfruttate al meglio. Se la Nested Class non deve avere accesso diretto a metodi e membri della classe contenitore, allora è preferibile che sia dichiarata statica, in modo da evitare che ogni istanza della Nested Class necessiti di un'istanza concreta della Top Level Class.

Le Anonimous Inner Classes e le Local classes devono essere brevi e molto semplici, in modo da non diminuire troppo la leggibilità del codice. Le Anonimous sono da preferire alle Local quando devono essere istanziate una sola volta, nel punto in cui devono essere eseguite. Le Local sono da preferire alle Inner se devono essere usate più volte in un unico metodo.