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> | ... | ... |