Commit 229d566286f9f0745fdeeaa968376e993c387f05
1 parent
abae922b
Exists in
master
IN PROGRESS - issue FWK-80: MessageContextImpl anotado com @RequestScope
https://demoiselle.atlassian.net/browse/FWK-80
Showing
1 changed file
with
6 additions
and
32 deletions
Show diff stats
documentation/reference/pt-BR/mensagem.xml
| @@ -145,41 +145,15 @@ private MessageContext messageContext;]]></programlisting> | @@ -145,41 +145,15 @@ private MessageContext messageContext;]]></programlisting> | ||
| 145 | <programlisting role="JAVA"><![CDATA[Message message = new DefaultMessage("Ocorreu um erro ao excluir o aluno!", SeverityType.ERROR); | 145 | <programlisting role="JAVA"><![CDATA[Message message = new DefaultMessage("Ocorreu um erro ao excluir o aluno!", SeverityType.ERROR); |
| 146 | messageContext.add(message);]]></programlisting> | 146 | messageContext.add(message);]]></programlisting> |
| 147 | <para> | 147 | <para> |
| 148 | - Uma vez inseridas no contexto em determinada camada da aplicação, as mensagens podem ser posteriormente | ||
| 149 | - recuperadas. Para tal, é preciso invocar o método <function>getMessages()</function> da interface | ||
| 150 | - <literal>MessageContext</literal>, o qual retornará uma coleção de objetos do tipo <literal>Message</literal>. | 148 | + A extensão para <emphasis>demoiselle-jsf</emphasis> |
| 149 | + transfere automaticamente as mensagens incluídas no <literal>MessageContext</literal> | ||
| 150 | + para o <literal>FacesContext</literal>. | ||
| 151 | </para> | 151 | </para> |
| 152 | - <note> | ||
| 153 | - <para> | ||
| 154 | - A extensão para <emphasis>JavaServer Faces</emphasis> no <emphasis>Demoiselle Framework</emphasis> | ||
| 155 | - transfere automaticamente as mensagens incluídas no <literal>MessageContext</literal> para a apresentação | ||
| 156 | - durante a renderização da página pelo <emphasis>JSF</emphasis>. | ||
| 157 | - </para> | ||
| 158 | - </note> | ||
| 159 | - <para> | ||
| 160 | - Para remover todas as mensagens existentes no contexto, basta invocar o método <function>clear()</function> da | ||
| 161 | - interface <literal>MessageContext</literal>. | ||
| 162 | - </para> | ||
| 163 | - <note> | ||
| 164 | - <para> | ||
| 165 | - Especificamente para aplicações Java Web, o contexto de mensagens é automaticamente reinicializado a cada | ||
| 166 | - requisição HTTP. Ou seja, as mensagens incluídas no contexto por uma determinada sessão de usuário não | ||
| 167 | - interferem nas demais sessões existentes no servidor de aplicações. Além disso, ao final da requisição as | ||
| 168 | - mensagens existentes são automaticamente excluídas do contexto. | ||
| 169 | - </para> | ||
| 170 | - </note> | ||
| 171 | <para> | 152 | <para> |
| 172 | - O contexto de mensagens <literal>MessageContext</literal> tem o seu ciclo de vida gerenciado pelo CDI e pertence | ||
| 173 | - ao escopo de sessão (i.e., <literal>@SessionScoped</literal>). Ou seja, mensagens incluídas na requisição de um | ||
| 174 | - determinado usuário não serão exibidas para um outro usuário, pois cada um possuirá a sua sessão. | 153 | + O contexto de mensagens, representado pela interface <literal>MessageContext</literal>, é capaz de |
| 154 | + armazenar diversas mensagens em uma mesma requisição. Ele não é restrito a aplicações do tipo Web, | ||
| 155 | + isto é, pode ser usado também para aplicações do tipo desktop (i.e., Swing). | ||
| 175 | </para> | 156 | </para> |
| 176 | - <note> | ||
| 177 | - <para> | ||
| 178 | - O contexto de mensagens, representado pela interface <literal>MessageContext</literal>, é capaz de | ||
| 179 | - armazenar diversas mensagens em uma mesma requisição. Ele não é restrito a aplicações do tipo Web, | ||
| 180 | - isto é, pode ser usado também para aplicações do tipo desktop (i.e., Swing). | ||
| 181 | - </para> | ||
| 182 | - </note> | ||
| 183 | </section> | 157 | </section> |
| 184 | 158 | ||
| 185 | <section> | 159 | <section> |