From 9f4d2bc5770ba7e1f545397ab19daf0f1ac615cd Mon Sep 17 00:00:00 2001 From: Dancovich Date: Thu, 10 Oct 2013 13:01:01 -0300 Subject: [PATCH] IN PROGRESS - issue FWK-123: Revisar e atualizar documentação do Framework 2.4.0 --- documentation/reference/pt-BR/gerenciamento.xml | 33 +++++++++++++++++++++++++-------- 1 file changed, 25 insertions(+), 8 deletions(-) diff --git a/documentation/reference/pt-BR/gerenciamento.xml b/documentation/reference/pt-BR/gerenciamento.xml index f5a9a4b..fbe0a9a 100644 --- a/documentation/reference/pt-BR/gerenciamento.xml +++ b/documentation/reference/pt-BR/gerenciamento.xml @@ -177,11 +177,7 @@ public class MonitorLogin{ É comum que aplicações monitoradas permaneçam em estado de espera - é função do cliente de monitoração acessar a aplicação e obter - as informações necessárias. - - - - No entanto existem casos onde é necessário que a aplicação comunique clientes de eventos ocorridos no sistema. Um exemplo é um monitor + as informações necessárias. No entanto existem casos onde é necessário que a aplicação comunique clientes de eventos ocorridos no sistema. Um exemplo é um monitor de espaço em disco que envia um alerta quando esse espaço for menor que 20% do total. @@ -209,9 +205,30 @@ public class DiskWritter{ }]]> - Nesse exemplo podemos ver como enviar uma notificação em decorrência de um evento gerado pela aplicação. Dessa forma - a aplicação pode comunicar a um agente de monitoração sobre o espaço disponível no disco, ao invés de aguardar que o agente - conecte-se à aplicação para solicitar essa informação explicitamente. + Como é possível ver no exemplo, o utilitário NotificationManager é usado para enviar notificações em decorrência + de eventos ocorridos na sua aplicação. O uso mais comum é notificar avisos ou problemas para que ações sejam tomadas, mas é possível também + usar essa técnica para tomar ações preventivas ou informativas - uma notificação que o backup noturno foi feito com sucesso por exemplo. + + + + A interface Notification é a base das notificações enviadas e possui apenas um método: + Object getMessage(). A API de monitoração não força o tipo específico da mensagem e usualmente essa mensagem + será uma String (como no exemplo acima), mas algumas extensões podem utilizar tipos específicos de mensagem + capazes de carregar mais informações. + + + + O demoiselle-core disponibiliza por padrão o tipo concreto de notificação GenericNotification - uma + implementação direta da interface Notification que permite definir a mensagem a ser retornada por getMessage(). + Além disso o demoiselle-core disponibiliza o tipo especial de mensagem AttributeChangeMessage, que permite + especificar além do texto da mensagem enviada, dados sobre a mudança de valor de um atributo, como o nome do atributo alterado, o valor antigo e o novo. + + + Notificações contendo mensagens do tipo AttributeChangeMessage são automaticamente enviadas por padrão pelo framework quando um + agente de monitoração altera o valor de uma propriedade anotada com @ManagedProperty, mas você também pode enviar mensagens desse tipo + quando propriedades de sua aplicação são alteradas. Extensões e componentes compatíveis com a API de monitoração do Demoiselle Framework + (por exemplo, a extensão demoiselle-jmx) podem fornecer implementações específicas da interface Notification e + tipos especializados de mensagem. Consulte a documentação desses componentes para aprender sobre seus usos. -- libgit2 0.21.2