Depurando Programas Java Remotos

A seguinte documentação explica como depurar programas Java no servidor remoto. Essa função aplica-se a programas que residem em um servidor remoto com sistemas operacionais POWER Linux e AIX instalados. Existem dois métodos que podem ser utilizados para depurar um aplicativo remoto. O primeiro método é um processo simples de uma única etapa que aceita todos os padrões para o aplicativo remoto. O segundo método permite especificar variáveis e parâmetros extras através de uma configuração de ativação customizada.

Para obter uma introdução à depuração e às configurações de ativação, consulte Depuração Remota e Escolhendo o Depurador Correto.

Método 1: Para aceitar os valores padrão para o seu aplicativo:

  1. Na visualização Remote Systems, faça uma pesquisa detalhada nas pastas e arquivos até localizar o arquivo de classe Java executável que deseja depurar.
  2. Clique com o botão direito do mouse no arquivo e selecione Debug > Host Java Application.

Método 2: Para especificar parâmetros e variáveis extras:

  1. Na visualização Remote Systems, faça uma pesquisa detalhada nas pastas e arquivos até localizar o arquivo de classe Java executável que deseja depurar.
  2. Clique com o botão direito do mouse no arquivo e selecione Debug > Host Java Application... para chamar a caixa de diálogo de configuração de ativação para depuração remota.
  3. No campo Name, digite um nome para a nova configuração, como Java Debugging.
  4. Se você tiver um projeto local com os arquivos associados, marque a caixa de opções Has associated Java project. Clique em Browse para navegar para a pasta local que contém todos os arquivos Java.
  5. No campo Main classe, especifique sua classe Java principal, se esse campo não estiver automaticamente concluído.
  6. No campo Remote Working Directory, especifique o diretório no servidor remoto no qual deseja executar a depuração.
  7. Clique na guia Arguments. Digite todos os argumentos do programa necessários ou os argumentos da VM (Virtual Machine) e clique em Apply.
  8. Clique na guia Classpath. Clique em Add para especificar todos os caminhos de classe novos. A seleção múltipla é suportada quando você procura arquivos. Clique em Apply.
  9. Clique na guia Environment. Clique em New para incluir variáveis de ambiente, se elas forem necessárias.
  10. Clique na guia Source. Nela é que você especifica o local de origem remoto para depuração. Por padrão, esse local é o mesmo do diretório de trabalho remoto especificado na guia Main. Clique em Add para especificar outros locais de origem remotos.
    1. A caixa de diálogo Add Source é exibida. Nela é que você pode especificar os tipos de origem remota a depurar. Selecione Remote Folder para arquivos Java ou de classe remotos ou Remote Archive para um archive remoto, como um arquivo Jar. Clique em OK.

    2. Na caixa de diálogo Browse for Folder, navegue pelas conexões exibidas para localizar o local de origem remoto para o código Java. Observe que você pode procurar vários servidores para especificar arquivos de classe em vários locais. Isso será útil se, por algum motivo, os arquivos de classe não estiverem disponíveis durante o tempo de execução e você precisar especificar um local de servidor diferente.
    3. Clique na pasta que contém a origem Java e clique em OK.
    4. Agora, na guia Source, abaixo de Source Lookup Path, você pode ver a inclusão do local do servidor remoto. É assim que você poderá especificar os locais de origem remotos no futuro. Por padrão, a primeira origem localizada é utilizada para depuração. Se desejar procurar todos os locais de origem duplicados, marque a caixa de opções Search for duplicate source files on the path. Durante a sessão de depuração, você será solicitado a selecionar qual origem utilizar a partir de uma lista de origens duplicadas. Clique em Apply.
  11. Clique na guia Advanced. Você pode especificar a porta do host que deseja utilizar para depuração remota do Java. Normalmente, o depurador detecta automaticamente uma porta livre.
  12. Clique na guia Common para definir propriedades adicionais para a configuração:
    1. Utilize os botões de opções para selecionar se deseja que essa configuração seja Local para a instância do workbench ou Shared com sua equipe.
    2. Selecione uma das caixas de opções de botões da barra de ferramentas, na qual deseja que a configuração seja exibida como favorita (um atalho marcado).
    3. Clique em Apply.
  13. Clique em Debug.
A perspectiva Debug abre e mostra automaticamente as visualizações diferentes que você pode utilizar para depurar o programa. Você pode trabalhar com essa perspectiva para diagnosticar erros. Consulte Informações de depuração para obter informações adicionais e links para descrições de tarefas.

Você também pode ativar a caixa de diálogo Debug a partir do menu de workbench Run > Debug ou dos botões da barra de ferramentas Debug .

Observe que a configuração de ativação está salva. Na próxima vez que você chamar o diálogo de configuração de ativação para depuração e para o aplicativo Java Remoto, a configuração de depuração será selecionada automaticamente. Você pode utilizar essa configuração, criar uma nova configuração ou clicar com o botão direito do mouse e duplicar a configuração existente se apenas desejar modificar um ou dois atributos.

Conceitos relacionados
Executando Programas e Comandos
Tarefas relacionadas
Executando Programas Remotamente Utilizando Ferramentas Externas
Trabalhando com Configurações de Ativação de Execução para Programas Java