Commit 97ef5ef019ff3c9c83980a03b2b3f5d99499b75e

Authored by Luciano Borges
1 parent 8d4eb858
Exists in master

Revisão e ajuste na documentação do módulo de gerenciamento.

Showing 1 changed file with 28 additions and 9 deletions   Show diff stats
documentation/reference/pt-BR/gerenciamento.xml
@@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@
11 <para>Ao implantar um sistema para produção, muitas vezes é necessário monitorar aspectos sobre o funcionamento desse sistema. Quanta memória 11 <para>Ao implantar um sistema para produção, muitas vezes é necessário monitorar aspectos sobre o funcionamento desse sistema. Quanta memória
12 ele está utilizando? Qual o pico de MIPS utilizados? Quantas sessões estão autenticadas no momento?</para> 12 ele está utilizando? Qual o pico de MIPS utilizados? Quantas sessões estão autenticadas no momento?</para>
13 13
14 - <para>Além de monitorar um sistema, as vezes é necessário gerencia-lo alterando aspectos de seu comportamento. Se o sistema está implantado em um 14 + <para>Além de monitorar um sistema, as vezes é necessário gerenciá-lo alterando aspectos de seu comportamento. Se o sistema está implantado em um
15 servidor alugado, talvez seja necessário ajustar o uso de MIPS para reduzir custos ou talvez deseje-se solicitar que o sistema limpe dados de sessão 15 servidor alugado, talvez seja necessário ajustar o uso de MIPS para reduzir custos ou talvez deseje-se solicitar que o sistema limpe dados de sessão
16 de autenticação abandonados por usuários que desligaram suas estações sem efetuar "logoff".</para> 16 de autenticação abandonados por usuários que desligaram suas estações sem efetuar "logoff".</para>
17 17
@@ -20,8 +20,9 @@ @@ -20,8 +20,9 @@
20 <emphasis>Java Management Extension</emphasis> (JMX).</para> 20 <emphasis>Java Management Extension</emphasis> (JMX).</para>
21 21
22 <para>O <emphasis>Demoiselle Framework</emphasis> dispõe de uma série de ferramentas para nivelar 22 <para>O <emphasis>Demoiselle Framework</emphasis> dispõe de uma série de ferramentas para nivelar
23 - o conhecimento do desenvolvedor e facilitar o uso e integraçao de várias tecnologias de gerenciamento e monitoração. Através de seu  
24 - uso o desenvolvedor pode se despreocupar com detalhes de implementação de cada tecnologia individual e facilmente integrar tais tecnologias.</para> 23 + o conhecimento do desenvolvedor e facilitar o uso e integraçao de várias tecnologias de gerenciamento e
  24 + monitoração. Através de seu uso o desenvolvedor pode facilmente integrar tais tecnologias, despreocupando-se
  25 + com detalhes de implementação de cada uma delas.</para>
25 </section> 26 </section>
26 27
27 <section> 28 <section>
@@ -35,7 +36,7 @@ @@ -35,7 +36,7 @@
35 @ManagementController 36 @ManagementController
36 public class GerenciadorUsuarios]]></programlisting> 37 public class GerenciadorUsuarios]]></programlisting>
37 38
38 - <para>Essa anotação é suficiente para o mecanismo de gerenciamento descobrir sua classe e disponibiliza-la para ser monitorada e gerenciada.</para> 39 + <para>Essa anotação é suficiente para o mecanismo de gerenciamento descobrir sua classe e disponibilizá-la para ser monitorada e gerenciada.</para>
39 40
40 <para>Contudo, a simples anotação acima não informa ao mecanismo quais aspectos da classe serão expostos. Por padrão, um <emphasis>Management Controller</emphasis> 41 <para>Contudo, a simples anotação acima não informa ao mecanismo quais aspectos da classe serão expostos. Por padrão, um <emphasis>Management Controller</emphasis>
41 não expõe nenhum aspecto seu. Para selecionar quais aspectos serão expostos usamos as anotações 42 não expõe nenhum aspecto seu. Para selecionar quais aspectos serão expostos usamos as anotações
@@ -43,7 +44,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt; @@ -43,7 +44,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
43 de classes anotadas com <code>@ManagementController</code>.</para> 44 de classes anotadas com <code>@ManagementController</code>.</para>
44 45
45 <informaltable> 46 <informaltable>
46 - <tgroup cols="3"> 47 + <tgroup cols="3" rowsep="1" colsep="1">
47 <thead> 48 <thead>
48 <row> 49 <row>
49 <entry>Anotação</entry> 50 <entry>Anotação</entry>
@@ -53,7 +54,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt; @@ -53,7 +54,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
53 </thead> 54 </thead>
54 55
55 <tbody> 56 <tbody>
56 - <row> 57 + <row valign="top">
57 <entry> 58 <entry>
58 <emphasis role="BOLD">@ManagedProperty</emphasis> 59 <emphasis role="BOLD">@ManagedProperty</emphasis>
59 </entry> 60 </entry>
@@ -76,7 +77,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt; @@ -76,7 +77,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
76 </entry> 77 </entry>
77 </row> 78 </row>
78 79
79 - <row> 80 + <row valign="top">
80 <entry> 81 <entry>
81 <emphasis role="BOLD">@ManagedOperation</emphasis> 82 <emphasis role="BOLD">@ManagedOperation</emphasis>
82 </entry> 83 </entry>
@@ -98,7 +99,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt; @@ -98,7 +99,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
98 </entry> 99 </entry>
99 </row> 100 </row>
100 101
101 - <row> 102 + <row valign="top">
102 <entry> 103 <entry>
103 <emphasis role="BOLD">@OperationParameter</emphasis> 104 <emphasis role="BOLD">@OperationParameter</emphasis>
104 </entry> 105 </entry>
@@ -148,6 +149,24 @@ public class ControleAcesso{ @@ -148,6 +149,24 @@ public class ControleAcesso{
148 monitorLogin.setContadorLogin( monitorLogin.getContadorLogin() + 1 ); 149 monitorLogin.setContadorLogin( monitorLogin.getContadorLogin() + 1 );
149 } 150 }
150 }]]></programlisting> 151 }]]></programlisting>
  152 +
  153 + <programlisting role="JAVA"><![CDATA[
  154 +@ManagementController
  155 +public class MonitorLogin{
  156 +
  157 + @ManagedProperty
  158 + private int contadorLogin;
  159 +
  160 + @ManagedOperation
  161 + public void setContadorLogin(int qtdUsuarioLogados){
  162 + contadorLogin = qtdUsuarioLogados;
  163 + }
  164 +
  165 + @ManagedOperation
  166 + public int getContatorLogin(){
  167 + return contadorLogin;
  168 + }
  169 +}]]></programlisting>
151 170
152 <para>Como é possível ver, classes anotadas com <emphasis>@ManagementController</emphasis> podem ser injetadas em qualquer ponto do código. Valores definidos 171 <para>Como é possível ver, classes anotadas com <emphasis>@ManagementController</emphasis> podem ser injetadas em qualquer ponto do código. Valores definidos
153 para seus atributos retêm seu estado, então um cliente que acesse remotamente o sistema e monitore o valor do atributo <emphasis>contadorLogin</emphasis> verá 172 para seus atributos retêm seu estado, então um cliente que acesse remotamente o sistema e monitore o valor do atributo <emphasis>contadorLogin</emphasis> verá
@@ -181,7 +200,7 @@ public class ControleAcesso{ @@ -181,7 +200,7 @@ public class ControleAcesso{
181 individualmente, as classes monitoradas serão então expostas para todas as extensões escolhidas.</para> 200 individualmente, as classes monitoradas serão então expostas para todas as extensões escolhidas.</para>
182 </tip> 201 </tip>
183 202
184 - <para>A figura <xref linkend="exemplo_jconsole"/> mostra como uma classe monitorada na aplicação <emphasis>Bookmark</emphasis> é exibida no <emphasis>JConsole</emphasis>.</para> 203 + <para>A figura <xref linkend="exemplo_jconsole" /> mostra como uma classe monitorada na aplicação <emphasis>Bookmark</emphasis> é exibida no <emphasis>JConsole</emphasis>.</para>
185 204
186 <programlisting role="JAVA"><![CDATA[ 205 <programlisting role="JAVA"><![CDATA[
187 @ManagementController 206 @ManagementController