Commit 97ef5ef019ff3c9c83980a03b2b3f5d99499b75e
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]]></programlisting> | @@ -43,7 +44,7 @@ public class GerenciadorUsuarios]]></programlisting> | ||
| 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]]></programlisting> | @@ -53,7 +54,7 @@ public class GerenciadorUsuarios]]></programlisting> | ||
| 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]]></programlisting> | @@ -76,7 +77,7 @@ public class GerenciadorUsuarios]]></programlisting> | ||
| 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]]></programlisting> | @@ -98,7 +99,7 @@ public class GerenciadorUsuarios]]></programlisting> | ||
| 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 |