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 | 145 | <programlisting role="JAVA"><![CDATA[Message message = new DefaultMessage("Ocorreu um erro ao excluir o aluno!", SeverityType.ERROR); |
| 146 | 146 | messageContext.add(message);]]></programlisting> |
| 147 | 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 | 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 | 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 | 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 | 157 | </section> |
| 184 | 158 | |
| 185 | 159 | <section> | ... | ... |