Agrupamentos de Mensagens

Descrição

Os Standard Java ResourceBundles têm características de espaço bastante ineficazes. Uma vez que o Eclipse em execução tende a conter mensagens exteriorizadas, foi implementado um novo sistema de agrupamento de mensagens para ser utilizado no Eclipse. O mecanismo é bastante simples e completamente genérico, pode ser utilizado em qualquer componente.

Resumo da nova abordagem:

AO criar uma nova mensagem:

Ficheiros de Exemplo:

Código de Cliente

Código Antigo:

public class MyClass {
  public void myMethod() {
    String message;
    ...
    // no args
    message = Messages.getString("key.one"); //$NON-NLS-1$
    ...
    // bind one arg
    message = MessageFormat.format(Messages.getString("key.two"), new Object[] {"example usage"}); //$NON-NLS-1$ //$NON-NLS-2$
    ...
  }
}

Novo Código:

public class MyClass {
  public void myMethod() {
    String message;
    ...
    // no args
    message = Messages.key_one;
    ...
    // bind one arg
    message = NLS.bind(Messages.key_two, "example usage"); //$NON-NLS-1$
    ...
  }
}

Messages.java

Código Antigo:

public class Messages {
  private static final String BUNDLE_NAME = "org.eclipse.core.utils.messages"; //$NON-NLS-1$
  private static final ResourceBundle bundle = ResourceBundle.getBundle(BUNDLE_NAME);
   
  public static String getString(String key) {
  try {
      return bundle.getString(key);
    } catch (MissingResourceException e) {
      return key;
    }
  }
}

Novo Código:

import org.eclipse.osgi.util.NLS;
public class Messages extends NLS {
  private static final String BUNDLE_NAME = "org.eclipse.core.utils.messages"; //$NON-NLS-1$
   
  public static String key_one;
  public static String key_two;
  ...
  static {
    NLS.initializeMessages(BUNDLE_NAME, Messages.class);
  }
}

messages.properties

Código Antigo:

key.one = Hello world.
key.two = This is an {0} of binding with one argument.

Novo Código:

key_one = Hello world.
key_two = This is an {0} of binding with one argument.