Trabalhar com o exemplo do JSR-047 Logging

Este exemplo demonstra o suporte TPTP para o registo de Eventos Base Comum utilizando APIs de registo JSR-047 implementadas em JDK 1.4.0 ou superior (i.e. java.util.logging). Os utilizadores efectuam registos de Eventos Base Comuns na consola e num Agente de Registo.

Crie o exemplo através de Ficheiro > Novo > Exemplo... > JSR-047 Logging Sample, caso ainda não o tenha feito.

O conteúdo do exemplo inclui o código de origem Java e as dependências (excluindo as classes java.util.logging) e o ficheiro de configuração necessários para registar Eventos Base Comuns num registador JSR-047 implementado no JDK 1.4.0 ou superior (ou seja, java.util.logging).

É necessário JRE 1.4.0 ou superior (ou seja, java.util.logging) para compilar e executar este exemplo.

Pressupostos

  1. Ao lançar esta aplicação a partir da Perspectiva Perfilar e Registar da área de trabalho, a aplicação ou serviço Controlador de Agentes está configurado para utilizar JRE 1.4.0 ou superior.
  2. A variável de ambiente 'java.util.logging.config.file' é definida para o caminho absoluto e nome do ficheiro de configuração (HyadesLoggingJava14Sample.properties) de registo JSR-047 (isto é, java.util.logging). Por exemplo, <workspace>/LoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties.

Lançamento

Para executar este exemplo e anexar automaticamente ao Agente de Registo, siga estes passos:
  1. Se o JRE predefinido da área de trabalho não for 1.4.0 ou superior, modifique o projecto Java criado recentemente (i.e. LoggingJava14Project) para compilar e executar utilizando JRE 1.4.0 ou superior (Projecto > Propriedades > Caminho de Construção Java > Bibliotecas > JRE_LIB > Remover > Adicionar Biblioteca... > Biblioteca do Sistema JRE > Seguinte > JRE alternativo > JREs instalados... > Adicionar... > Directório Principal do JRE > Procurar... > [JRE 1.4.0 ou superior] > OK > OK > OK > Terminar > OK).
  2. Confirmar que todos os erros de compilação foram corrigidos.
  3. Se estiver a utilizar uma instalação autónoma do Controlador de Agentes (AC - Agent Controler), certifique-se que foi iniciada (não é necessário). Em alternativa, pode utilizar uma ligação directa que consiste num número limitado de serviços do AC incluídos na área de trabalho.
  4. Abrir a perspectiva Perfilar e Registar (Janela > Abrir Perspectiva > Outra... > Perfilar e Registar).
  5. Execute a classe exemplo a partir da Perspectiva Perfilar e Registar (Executar > Perfil... > Criar uma nova configuração de tipo de Aplicação Java > Definir o nome do projecto para o nome do projecto de exemplo > Definir a classe Principal para 'HyadesLoggingJava14Sample' > Mude para o separador Argumentos e especifique a seguinte propriedade JVM: -Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" >Mude para o separador Supervisor > Desmarcar " Perfilamento de Java " e seleccione "Descobridor de Agentes " > Perfil).
  6. Após alguns segundos, o agente de registo deverá ser detectado e anexado automaticamente. Seleccione o agente de registo identificado e abra a vista Registo na Perspectiva Perfilar e Registar para visualizar as entradas de registo de Evento Base Comum registadas (Janela > Mostrar Vista > Outra... > Perfilar e Registar > Vista Registo > OK).
  7. Actualizar a vista Registo na perspectiva Perfilar e Registar (Fazer clique com o botão direito do rato em 'HyadesLoggingJava14Sample' Agente de Registo > Actualizar).

Em alternativa, para executar este exemplo e anexar manualmente ao Agente de Registo, siga estes passos:

  1. Se o JRE predefinido da área de trabalho não for 1.4.0 ou superior, modifique o projecto Java criado recentemente (i.e. LoggingJava14Project) para compilar e executar utilizando JRE 1.4.0 ou superior (Projecto > Propriedades > Caminho de Construção Java > Bibliotecas > JRE_LIB > Remover > Adicionar Biblioteca... > Biblioteca do Sistema JRE > Seguinte > JRE alternativo > JREs instalados... > Adicionar... > Directório Principal do JRE > Procurar... > [JRE 1.4.0 ou superior] > OK > OK > OK > Terminar > OK).
  2. Confirmar que todos os erros de compilação foram corrigidos.
  3. Se estiver a utilizar uma instalação autónoma do Controlador de Agentes (AC - Agent Controler), certifique-se que foi iniciada (não é necessário). Em alternativa, pode utilizar uma ligação directa que consiste num número limitado de serviços do AC incluídos na área de trabalho.
  4. Execute a classe exemplo a partir da Perspectiva de Java (Executar > Executar... > Criar uma nova configuração de tipo de Aplicação Java > Classe Principal > Pesquisar... > HyadesLoggingJava14Sample > OK > Mude para o separador Argumentos e especifique a seguinte propriedade JVM: -Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" >Executar).
  5. Abrir a perspectiva Perfilar e Registar (Janela > Abrir Perspectiva > Outra... > Perfilar e Registar).
  6. Anexar ao Agente de Registo 'HyadesLoggingJava14Sample' na Perspectiva Perfilar e Registar (Executar > Perfil... > Anexar - Processo Java > Novo > Separador Sistemas Centrais > Utilize 'Ligação Directa Local' se não estiver a utilizar a instalação autónoma do Controlador de Agentes. Caso contrário, utilize um nome do sistema central válido e uma porta. > Separador Agentes > Faça duplo clique no agente HyadesLoggingJava14Sample > Seleccione o separador Destino > Projecto de Perfilamento > Procurar... > 'HyadesLoggingJava14Sample' > OK > Perfil).
  7. Iniciar supervisão do Agente de Registo 'HyadesLoggingJava14Sample' <Fazer clique com o botão direito do rato sobre o Agente de Registo 'HyadesLoggingJava14Sample'> > Iniciar Supervisão).
  8. Abrir a vista Registo na perspectiva Perfilar e Registar para visualizar as entradas de registo de Evento Base Comum registados (Janela > Mostrar Vista > Outra... > Perfilar e Registar > Vista Registo > OK).
  9. Actualizar a vista Registo na perspectiva Perfilar e Registar (<Fazer clique com o botão direito do rato sobre o Agente de Registo 'HyadesLoggingJava14Sample'> > Actualizar).