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,6 +277,41 @@ ALUNO_EXCLUIR_OK=L'étudiant {0} a été supprimé avec succès]]></programlisti | ||
| 277 | </para> | 277 | </para> |
| 278 | </note> | 278 | </note> |
| 279 | </section> | 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 | <section> | 316 | <section> |
| 282 | <title>Exemplos de implementação</title> | 317 | <title>Exemplos de implementação</title> |