Novidades no Juno (JDT)

Em seguida, são descritas algumas das alterações mais interessantes ou significativas introduzidas nas ferramentas de programação de Java da edição Juno (3.8 e 4.2) do Eclipse. Estas descrições estão agrupadas em:

Consulte também Novidades para Java 7 para saber quais as funções adicionadas para suportar a linguagem de Java 7.

Consulte também o documento Novidades da Plataforma Eclipse para saber quais as alterações efectuadas na Plataforma.


Editor Java

CamelCase em Esquema rápido As opções Esquema rápido (Ctrl+O) e Hierarquia rápida (Ctrl+T) no editor Java agora também suportam a correspondência de camelCase no nome do elemento, bastante semelhante à caixa de diálogo Abrir tipo e Assistência a conteúdos.

Esquema rápido de StyledText com padrão 'gCa'

Os caracteres globais * e ? continuam a funcionar, claro.
Assistência a conteúdos para converter ciclo for melhorado Alguma vez encontrou um ciclo for melhorado e precisou de acesso ao Iterador ou ao índice de ciclos? Agora, podemos ajustar a utilização de uma Assistência a conteúdos (Ctrl+1) para converter o ciclo:

Ecrã da Assistência rápida na palavra-chave 'for' de um ciclo 'for' melhorado

  • Converter para ciclo 'for' indexado está disponível para expressões de matriz e tipos baseados em listas.
  • Converter ciclo 'for' baseado em iterador está disponível para expressões do tipo Iterable.
Suporte correspondente de parêntesis rectos melhorado no editor Java O editor Java suporta agora o realce dos parêntesis rectos de delimitação.

Parêntesis rectos delimitadores

Esta opção pode ser configurada na página de preferências Java > Editor.

Preferências para realce de parêntesis rectos

Além disso, a acção Navegar > Ir para > Parêntesis recto correspondente (Ctrl+Shift+P) funciona agora em todo o lado num ficheiro. Se um parêntesis recto não estiver seleccionado antes de invocar a acção, a acção navega para o parêntesis recto final delimitador mais próximo. Ao invocar a acção uma segunda vez, navega para o parêntesis recto inicial correspondente. Na terceira invocação, a selecção original é restaurada.

Até agora, foi encontrado um parêntesis correspondente quando o cursor foi colocado imediatamente após um parêntesis recto. Agora, é encontrado um parêntesis correspondente quando o cursor é colocado imediatamente antes ou imediatamente após um parêntesis recto.

Exemplos de parêntesis rectos correspondentes

Pode passar com o rato por cima de uma chaveta final e ver a origem perto do parêntesis de abertura correspondente numa ajuda flutuante. Esta opção é útil quando pretende ver o código perto do início de um bloco de código longo. A ajuda flutuante também diz o número de linhas no bloco de código.

Ajuda flutuante de parêntesis recto, exemplo 1

A ajuda flutuante também é útil para 'realçar' temporariamente um bloco de código pequeno.

Ajuda flutuante de parêntesis recto, exemplo 2

Ajuda flutuante do Javadoc mostra anotações de parâmetros As ajudas flutuantes de Javadoc representam as anotações em parâmetros de métodos:

org.eclipse.User.User(@NonNull String name, int uid, @Nullable String email)

Tipo de ficheiro '*.class sem origem' O novo tipo de ficheiro *.class sem origem permite associar um editor interno ou externo a ficheiros de classes que não tenham nenhuma origem anexada. Isto permite, por exemplo, abrir o ficheiro de classe num descompilador:

Ecrã da página de preferências 'Associações de ficheiros'

Im­ple­men­ta­ções predefinidas para propostas de correcção O JDT fornece agora as seguintes implementações predefinidas para a correcção de propostas que podem ser utilizadas para contribuir correcções rápidas e assistências rápidas.
  • org.eclipse.jdt.ui.text.java.correction.ChangeCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.CUCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.ASTRewriteCorrectionProposal
Facilita a implementação de correcções/assistências rápidas que operam em ficheiros .java e utilizam um ASTRewrite.
Assistência a conteúdos em package-info.java A Assistência a conteúdos (Ctrl+Espaço) está agora disponível dentro de package-info.java, que é utilizado para declarar anotações e javadocs ao nível dos pacotes.

Assistência a conteúdos emergente para adicionar anotações de nível de pacote em instrução de pacote

Compilador Java

Ignorar selectivamente erros/avisos de pastas de origem Agora pode configurar o JDT para ignorar potenciais erros/avisos a partir de determinadas pastas de origem. Propriedades do projecto > Caminho de construção Java > Compilador > Origem.

Página Caminho de construção Java com a opção 'Ignorar problemas de compilação opcionais' realçada

Com esta opção definida como Sim, o JDT irá agora suprimir os erros/avisos configurados na página Preferências > Java > Compilador > Erros/Avisos. Isso pode ser desejável para pastas de origem que contenham classes ou testes auto-gerados.

Diagnósticos melhorados para detecção de declarações de alteração incompletas A análise de JDT respeitante a declarações incompletas de alteração é agora mais potente e pode ser configurada mais detalhadamente. Consulte aqui para segundo plano.

Agora, o compilador verifica em separado dois critérios para completar uma declaração de alteração:

  • Uma declaração de alteração numa enumeração deve definir uma instrução com combinação de maiúsculas-minúsculas para cada uma das constantes da enumeração
  • Todas as declarações de alteração independentes de tipo devem definir uma instrução com combinação de maiúsculas-minúsculas predefinida.

Por predefinição, o compilador avisa aquando de uma declaração de alteração de enumeração em que ambos os critérios são transgredidos:

Aviso em alteração sobre enumeração com combinação de maiúsculas-minúsculas predefinida em falta

Este aviso é controlado pela opção Preferências > Java > Compilador > Erros/Avisos > Declarações incompletas de "alteração" ("switch") de maiúsculas-minúsculas na enumeração. Esta opção pode ser reforçada seleccionando a nova subopção Assinalar mesmo que exista a declaração de maiúsculas-minúsculas predefinida ("default"), e, nesse caso, o JDT irá sinalizar as declarações de alteração através de um tipo de enumeração que pode ter um valor de enumeração abrangido apenas através de uma declaração predefinida, mas não directamente através de uma declaração de combinação de maiúsculas-minúsculas. Quando são adicionadas novas constantes de enumeração, esta opção irá ajudar a detectar as declarações de alteração que não abrangem o novo valor.

Aviso sobre alteração com declaração de combinação de maiúsculas-minúsculas em falta para valor de enumeração mesmo que a predefinida esteja presente

Página de preferências Erros/avisos do compilador com a nova opção de diagnóstico de alteração realçada

Uma segunda adição na mesma secção das preferências do compilador, Alteração não possui combinação de maiúsculas-minúsculas predefinida ("default"), controla o facto de o JDT sinalizar declarações de alteração com uma combinação de maiúsculas-minúsculas predefinida em falta, porque essa declaração de alteração pode ser completamente ignorada durante a execução caso ocorra um valor inesperado.

Aviso sobre alteração com combinação de maiúsculas-minúsculas predefinida em falta

Tenha em atenção que em casos como o anterior, o aviso também ajuda a compreender outro erro contra a última instrução:
"A variável local printString não pode ser iniciada" é registada porque os clientes podem possivelmente chamar o método print(Color) com um valor de enumeração que não é conhecida no momento da compilação deste método.

Novas opções para detectar fugas de recursos O compilador pode agora detectar uma fuga de recursos, ou seja, variáveis locais do tipo java.lang.AutoCloseable (conformidade >= 1.7) e java.io.Closeable (conformidade <= 1.6). Aceda a aqui para mais informações,

Página Erros/avisos com a opção 'Fugas de recursos' realçada

Quando a opção Fuga de recursos na página de preferências Java > Compilador > Erros/Avisos estiver activada, o compilador irá emitir um erro ou um aviso se o método close() não for invocado localmente num recurso.

Exemplo de fuga de recursos

Quando activar a opção Potencial fuga de recursos na página de preferências Java > Compilador > Erros/Avisos, o compilador irá emitir um erro ou um aviso se o método close() não for invocado localmente num recurso em todos os caminhos de execução.

Exemplo de potencial fuga de recursos

Esta análise é menos agressiva se um recurso for partilhado entre métodos, possivelmente através de um campo, onde qualquer parte que acede ao recurso pode, possivelmente, emitir a chamada pretendida para close(). Nalguns casos (por exemplo, transmissão de um argumento a outro método), o aviso é atenuado para que comunique apenas uma potencial fuga; noutros casos (armazenados num campo), a análise fica em silêncio.

Além disso, a análise reconhece determinados casos como sendo praticamente sem importância. Alguns exemplos onde a ausência de uma chamada close() não activa quaisquer erros/avisos são fornecidos em baixo:

  • Implementadores sem recursos de Closeable, como StringReader.

    nenhuma fuga de recursos registada se o implementador sem recursos de Closeable não estiver fechado

  • A translineação de implementadores de Closeable, como BufferedReader, que simplesmente faz a translineação de um Closeable sem recursos, directa ou indirectamente.

    nenhuma fuga de recursos registada quando um recurso que faz a translineação de um implementador sem recursos de Closeable não está fechado

  • Os recursos translineados onde qualquer recurso na cadeia está (potencialmente) fechado.

    potencial fuga de recursos registada quando qualquer recurso na cadeia de recursos do translineador está fechado ao longo de algum caminho de execução.

Opções de aviso do compilador de novo lote Estão agora disponíveis duas novas opções do compilador de lotes para configurar os avisos de tempo de compilação:
  • -warn:all pode ser utilizado para activar todos os avisos do compilador
  • -warn:resource pode ser utilizado para activar avisos de fuga de recursos
Opção de novo caminho de construção para avisar quando a localização de saída de uma pasta de origem se sobrepõe a outra pasta de origem O JDT mostra agora um erro de caminho de construção quando a localização de saída de uma pasta de origem se sobrepõe a outra pasta de origem. Este erro pode ser configurado na página de preferências Java > Compilador > Construir > Localização de saída sobrepõe localização de origem.

Erro do caminho de construção quando a localização de saída da pasta de origem se sobrepõe a outra pasta de origem

Análise de nulos baseada em anotações O JDT pode agora ser configurado para utilizar anotações designadas como anotações nulas para executar a análise de nulos inter-procedimentos melhorada. Esta funcionalidade pode ser activada em Preferências > Java > Compilador > Erros/Avisos > Análise de nulos:

Página de preferências Erros/Avisos com a opção 'Activar análise de nulos baseada em anotações' realçada

Pode utilizar as anotações predefinidas agrupadas com JDT ou utilizar as suas próprias anotações como anotações nulas. Além de activar a análise de nulos, as anotações têm de estar no caminho de construção Java do seu projecto. As anotações predefinidas podem ser encontradas no JAR org.eclipse.jdt.annotation no directório plugins, que se pode assumir como um lote OSGi ou JAR simples.

Quando a análise de nulos baseada em anotações estiver activada, o JDT emite novos diagnósticos com base na nulidade de uma variável ou um tipo de retorno de método, conforme especificado por uma anotação nula.

	public void foo(@NonNull Object o1) {¶		System.out.println(o1.toString()); // OK: o1 não pode ser nulo¶	}¶	¶	@NonNull Object bar(@Nullable String s1) {¶		foo(null); // não pode transmitir argumento nulo¶		@NonNull String s= null; // não pode atribuir valor nulo ¶		@NonNull String t= s1; // não pode atribuir valor potencialmente nulo ¶		devolver nulo; // não é possível devolver valor nulo¶	}

Também são solicitados diagnósticos semelhantes quando o valor atribuído/devolvido pode potencialmente ser nulo ou tiver uma nullness desconhecida.

Os métodos de substituição também são verificados para ver a sua exactidão:

class Base {¶	@NonNull Object method(@Nullable Object o) {¶		return new Object();¶	}¶}¶¶class Sub extends Base {¶	@Override            // parâmetro de método tem de permitir nulo¶	@Nullable Object method(@NonNull Object o) {¶		return new Object();¶	}¶}

Também pode utilizar a anotação @NonNullByDefault para definir uma predefinição global num elemento (pacote, tipo, método) para todos os métodos delimitados.

@NonNullByDefault¶class MyClass {¶	// anotações @NonNull redundantes:¶	objecto @NonNull público foo(@NonNull Object o) {¶		devolver o;¶	}¶	¶	@NonNullByDefault(false) // cancela a predefinição¶	Object bar(@NonNull Object o) {¶		devolver o;¶	}¶}

Em resultado das assinaturas de métodos de anotação, a análise de nulos intra-procedimentos existente tem ainda mais informações devido às anotações especificadas pelo utilizador e assim fornece melhores resultados. No exemplo em baixo, o compilador não teria sido capaz de avaliar o estado de nulo do parâmetro 'obj' sem a anotação de nulos (a opção Redundant null check tem de ser activada para que surja o aviso).

public void foo(@NonNull Object obj) {¶		if (obj == null) { }¶	}

Os novos diagnósticos são classificados em três categorias:

  • Violação de especificação nula
    Esta opção produz o¶	aviso 'Não correspondência de tipos nulos: necessário '@NonNull String', mas o valor fornecido é especificado como @Nullable'

    Aqui, 'in' não é um valor de retorno legal devido à anotação @Nullable na respectiva instrução.

  • Conflito entre anotações nulas e inferência nula
    Esta opção produz o¶	aviso 'Não correspondência de tipos nulos: necessário @NonNull String mas o valor fornecido é inferido como @Nullable'

    Aqui, 'local' não é um valor de retorno legal, porque a análise de fluxo para a variável não anotada 'local' infere que pode ser nulo em algum caminho.

  • Conversão não seleccionada do tipo não anotado para tipo @NonNull
    Esta opção produz o¶	aviso	'Segurança de tipos nulos: a expressão de tipo String precisa da conversão não verificada para estar em conformidade com @NonNull String'

    Aqui, o valor de retorno de 'getLegacyValue()' pode ou não ser compatível com '@NonNull String'. À semelhança de converter um tipo raw de legacy para um tipo genérico, também aqui estão em falta informações essenciais de tipo uma vez que 'getLegacyValue()' não tem qualquer anotação @NonNull ou @Nullable.

Nota: esta é a primeira versão desta função. Estamos a trabalhar para a tornar mais fácil de realizar em configurações de projectos Java. As funções implementadas são completadas e testadas, mas por exemplo o suporte para anotar campos ou API de bibliotecas de terceiros está em falta. Inclui-se um conjunto inicial de correcções rápidas que serão sujeitas a melhorias adicionais no futuro.

Veja também aqui para mais informações.

Opções do compilador de lotes para utilizar anotações de nulos Agora pode configurar o compilador de lotes para utilizar anotações para a análise de nulos transmitindo o símbolo nullAnnot(nullable|nonnull|nonnullbydefault) para a opção -warn, onde nullable, nonnull e nonnullbydefault são nomes totalmente qualificados de tipos de anotação a utilizar para a análise de nulos. Pode utilizar nullAnnot em separado para utilizar anotações predefinidas de JDT.

Além disso, pode utilizar o símbolo -nonNullByDefault para utilizar globalmente o valor não nulo como a predefinição quando a análise de nulos baseada nas anotações está activada. Isto implica que todos os tipos nas assinaturas de método sem uma anotação de nulos são considerados como não nulos especificados.

Detecção de anotação de nullness predefinida em falta Para que non-null (não nulo) se torne na predefinição para tipos sem anotações em assinaturas de método, pode usar a anotação "@NonNullByDefault" em todos os pacotes. Para garantir cobertura completa de todos os pacotes, pode configurar o JDT para que detecte uma anotação de nullness (nulidade) predefinida em falta. Quando a opção Preferências > Java > Compilador > Erros/Avisos > Análise de nulos > Falta anotação '@NonNullByDefault' no pacote está activada, o JDT irá emitir um erro/aviso nos seguintes casos:
  • Quando um pacote não contém uma anotação '@NonNullByDefault' em package-info.java:

    Falta anotação @NonNullByDefault no aviso de pacote

  • Quando um tipo dentro de um pacote predefinido não contém uma anotação passível de ser nula predefinida.

    Aviso falta anotação @NonNullByDefault no tipo

A análise de nulos trata org.​eclipse.​core.​runtime.​Assert como uma asserção java. Uma vez que org.eclipse.core.runtime.Assert é muitas vezes utilizada como a palavra-chave assert de Java, a análise de nulos de JDT considera que a expressão booleana foi transmitida para a anterior como sendo sempre verdadeira após a referência Assert, uma vez que se a condição afinal fosse falsa o fluxo de controlo nunca irá ultrapassar a referência org.eclipse.core.runtime.Assert.

Fragmento de código que mostra a expressão booleana transmitida para org.eclipse.core.runtime.Assert.isLegal(..) é considerado como verdadeiro após a chamada

Pesquisa mais rápida com índices pré-incorporados Nota: esta função destina-se principalmente para plug-ins que implementam o seu próprio contentor de caminho de classes, não para o utilizador final.

Agora pode indicar à pesquisa de JDT para utilizar índices pré-incorporados em vez de ter o compilador a gerar os índices da primeira vez que um JAR é adicionado ao caminho de classes. Isto impede que a indexação ocorra na máquina do utilizador e permite ao utilizador obter os resultados da primeira pesquisa mais rapidamente.

Pode especificar o ficheiro de índice como um atributo de caminho de classes IClasspathAttribute.INDEX_LOCATION_ATTRIBUTE_NAME da biblioteca.

Consulte Ajuda > Manual de Programador de Plug-ins de JDT > Manual do Programador > Núcleo de JDT > Índices para a pesquisa Java para obter mais detalhes.

Vistas e caixas de diálogo de Java

Codificação para anexos de origem Pode agora especificar a codificação para anexos de origem para bibliotecas, por exemplo, em Caminho de construção > Bibliotecas > expanda a biblioteca > Anexo de origem > Editar...

Caixa de diálogo para especificar a codificação para anexos de origem.

Página de preferências Realce em erros/avisos Na página de preferências Erros/avisos, por vezes, é difícil ver qual o artigo que está seleccionado, especialmente quando abre a caixa de diálogo através do botão "Configurar gravidade do problema".

Botão Configurar gravidade do problema na ajuda flutuante para problemas do Editor de Java

Agora, uma seta realça o artigo seleccionado, e outra seta realça o artigo sob o rato.

Realce nas páginas de preferências

O realce também funciona nas páginas de preferências de Ferramentas de PDE e API.

Editor de ficheiro de propriedades

Assistências rápidas para reorganizar teclas de propriedades Se utilizar cadeias exteriorizadas de estilo Eclipse, as seguintes assistências rápidas tornam mais fácil reorganizar teclas dentro do Editor do ficheiro de propriedades:
  • Mudar o nome no espaço de trabalho - muda o nome da tecla no ficheiro de propriedades e actualiza todas as referências
  • Criar campo em '...' - cria o campo correspondente na classe do assessor de lotes de recursos
  • Remover propriedade - elimina a propriedade do ficheiro de propriedades e o campo da classe de assessor de lotes de recursos
  • Remover propriedades - elimina as propriedades seleccionadas do ficheiro de propriedades e os campos da classe de assessor de lotes de recursos

Depurar

Exportar formatadores de detalhes Os formatadores de detalhes (que são usados, por exemplo, na composição de objectos na vista Variáveis) podem agora ser exportados como preferências em separado. Anteriormente, a única forma de partilhar formatadores de detalhes era exportar todas as definições do espaço de trabalho.

Caixa de diálogo Formatadores de detalhes na exportação

Mostrar supervisores por predefinição A predefinição para apresentar as informações do supervisor na vista Depurar está agora predefinida para On (Ligada). Esta alteração afecta apenas os novos espaços de trabalho e não altera definições existentes.

A opção Mostrar informações do supervisor pode ser ligada ou desligada utilizando a acção da vista Java > Mostrar Supervisores dentro da vista Depuração.

Comutar teclas de modificação de ponto de interrupção Agora existe suporte para as chaves de modificador ao comutar pontos de interrupção no editor Java:
  • Manter a tecla Ctrl premida ao fazer duplo clique (comutar) num ponto de interrupção irá fazer com que a Caixa de diálogo Propriedades para esse ponto de interrupção seja apresentado (no Mac, utilize Command (Comando))

  • Manter a tecla Alt premida ao fazer duplo clique (comutar) um ponto de interrupção irá activar/desactivar esse ponto de interrupção.
Se não existir nenhum ponto de interrupção, ocorre uma comutação de pontos de interrupção normal, mesmo mantendo premida uma tecla do modificador.

JUnit

JUnit 4.10 A versão JUnit 4 enviada com o Eclipse foi actualizada para 4.10.