Commit 1edb12a044bf66d8ff2754015842594edc497a8a
1 parent
9c3cb596
Exists in
master
issue FWK-123: Revisar e atualizar documentação do Framework 2.4.0
https://demoiselle.atlassian.net/browse/FWK-123
Showing
1 changed file
with
35 additions
and
0 deletions
Show diff stats
documentation/reference/pt-BR/mensagem.xml
... | ... | @@ -277,6 +277,41 @@ ALUNO_EXCLUIR_OK=L'étudiant {0} a été supprimé avec succès]]></programlisti |
277 | 277 | </para> |
278 | 278 | </note> |
279 | 279 | </section> |
280 | + | |
281 | + <section> | |
282 | + <title>Destino das mensagens</title> | |
283 | + | |
284 | + <para> | |
285 | + O Framework Demoiselle permite configurar o destino das mensagens enviadas. Por padrão, mensagens enviadas em um ambiente SE (Swing por exemplo) | |
286 | + são exibidas como registros de log no console, já mensagens enviadas em um ambiente WEB usando JSF 2.0 são redirecionadas para a classe | |
287 | + <code>FacesContext</code>. Caso esse comportamento padrão não seja suficiente para você, é possível personalizar o mecanismo de redirecionamento | |
288 | + de mensagens, fazendo-o enviar as mensagens para um local de seu interesse. | |
289 | + </para> | |
290 | + | |
291 | + <para> | |
292 | + Para isso existe a interface <code>MessageAppender</code>. Para toda mensagem enviada, o Framework Demoiselle vai determinar a implementação | |
293 | + mais adequada de <code>MessageAppender</code> a utilizar e vai redirecionar qualquer mensagem para essa implementação. | |
294 | + </para> | |
295 | + | |
296 | + <programlisting role="JAVA">public interface MessageAppender extends Serializable { | |
297 | + | |
298 | + /** | |
299 | + * Method that must hold message in an appropriate way and in an appropriate local. | |
300 | + * Demoiselle holds a message in a Logger or in a FacesContext, depending on the project. | |
301 | + * | |
302 | + * @param message | |
303 | + * message to be stored. | |
304 | + */ | |
305 | + void append(Message message); | |
306 | +}</programlisting> | |
307 | + | |
308 | + <para> | |
309 | + Para criar seu próprio <code>MessageAppender</code>, implemente essa interface e anote-a com a anotação <code>@Priority</code> - o Framework | |
310 | + Demoiselle irá selecionar a implementação adequada paseada na maior prioridade. Não é necessário configurar mais nada, o Framework Demoiselle | |
311 | + selecionará a implementação automaticamente. Cabe-lhe então a tarefa de implementar o método <code>append(Message message)</code> para tratar | |
312 | + a mensagem da forma que melhor se adequar a seu projeto. | |
313 | + </para> | |
314 | + </section> | |
280 | 315 | |
281 | 316 | <section> |
282 | 317 | <title>Exemplos de implementação</title> | ... | ... |