issue FWK-123: Revisar e atualizar documentação do Framework 2.4.0

https://demoiselle.atlassian.net/browse/FWK-123

issue FWK-123: Revisar e atualizar documentação do Framework 2.4.0
https://demoiselle.atlassian.net/browse/FWK-123
Dancovich
1 parent 9c3cb596
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&#39;étudiant {0} a été supprimé avec succès]]&gt;&lt;/programlisti
 			</para>
 		</note>
 	</section>
+	
+	<section>
+		<title>Destino das mensagens</title>
+		
+		<para>
+			O Framework Demoiselle permite configurar o destino das mensagens enviadas. Por padrão, mensagens enviadas em um ambiente SE (Swing por exemplo)
+			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
+			<code>FacesContext</code>. Caso esse comportamento padrão não seja suficiente para você, é possível personalizar o mecanismo de redirecionamento
+			de mensagens, fazendo-o enviar as mensagens para um local de seu interesse.
+		</para>
+		
+		<para>
+			Para isso existe a interface <code>MessageAppender</code>. Para toda mensagem enviada, o Framework Demoiselle vai determinar a implementação
+			mais adequada de <code>MessageAppender</code> a utilizar e vai redirecionar qualquer mensagem para essa implementação.
+		</para>
+		
+		<programlisting role="JAVA">public interface MessageAppender extends Serializable {
+	
+	/**
+	 * Method that must hold message in an appropriate way and in an appropriate local.
+	 * Demoiselle holds a message in a Logger or in a FacesContext, depending on the project.
+	 * 
+	 * @param message
+	 * 			message to be stored.
+	 */
+	void append(Message message);
+}</programlisting>
+
+		<para>
+			Para criar seu próprio <code>MessageAppender</code>, implemente essa interface e anote-a com a anotação <code>@Priority</code> - o Framework
+			Demoiselle irá selecionar a implementação adequada paseada na maior prioridade. Não é necessário configurar mais nada, o Framework Demoiselle
+			selecionará a implementação automaticamente. Cabe-lhe então a tarefa de implementar o método <code>append(Message message)</code> para tratar
+			a mensagem da forma que melhor se adequar a seu projeto.
+		</para>
+	</section>
  
 	<section>
 		<title>Exemplos de implementação</title>
...	...	@@ -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>
...	...