Commit 229d566286f9f0745fdeeaa968376e993c387f05

Authored by Cleverson Sacramento
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>
... ...