Commit b48746aa2f3413e1065d335c260f540c7a8eea88

Authored by Dancovich
1 parent 6c692bd5
Exists in master

Atualizada documentação de proprieades e controladores com os recursos

do Management.
documentation/reference/pt-BR/authorgroup.xml
... ... @@ -7,6 +7,10 @@
7 7 <surname>Sacramento</surname>
8 8 </author>
9 9 <author>
  10 + <firstname>Danilo</firstname>
  11 + <surname>Viana</surname>
  12 + </author>
  13 + <author>
10 14 <firstname>Emerson</firstname>
11 15 <surname>Oliveira</surname>
12 16 </author>
... ...
documentation/reference/pt-BR/controlador.xml
... ... @@ -8,12 +8,13 @@
8 8 <para>
9 9 No <emphasis>Demoiselle Framework</emphasis> os controladores ou controllers servem para identificar as camadas da
10 10 arquitetura de sua aplicação. É comum que as aplicações utilizem apenas três camadas: visão, negócio e persistência.
11   - Existem aplicações que utilizam fachadas. Por esse motivo, foram implementados nessa versão do framework quatro controllers:
  11 + Existem aplicações que utilizam fachadas. Por esse motivo, foram implementados nessa versão do framework cinco controllers:
12 12 <itemizedlist>
13 13 <listitem><para><literal>ViewController</literal></para></listitem>
14 14 <listitem><para><literal>FacadeController</literal></para></listitem>
15 15 <listitem><para><literal>BusinessController</literal></para></listitem>
16 16 <listitem><para><literal>PersistenceController</literal></para></listitem>
  17 + <listitem><para><literal>ManagementController</literal></para></listitem>
17 18 </itemizedlist>
18 19 </para>
19 20 <!-- TODO: incluir exemplos de códigos usando os controladores citados acima -->
... ...
documentation/reference/pt-BR/properties.xml
... ... @@ -260,6 +260,50 @@
260 260 </tbody>
261 261 </tgroup>
262 262 </table>
  263 + <table>
  264 + <title>Configurações da extensão JMX</title>
  265 + <tgroup cols="3">
  266 + <colspec align="left"/>
  267 + <colspec align="left"/>
  268 + <colspec align="right"/>
  269 +
  270 + <thead>
  271 + <row valign="top">
  272 + <entry><emphasis role="bold">Propriedade</emphasis></entry>
  273 + <entry><emphasis role="bold">Descrição</emphasis></entry>
  274 + <entry><emphasis role="bold">Valor padrão</emphasis></entry>
  275 + </row>
  276 + </thead>
  277 + <tbody>
  278 + <row valign="top">
  279 + <entry>frameworkdemoiselle.management.jmx.mbean.domain</entry>
  280 + <entry>
  281 + <para>Define o domínio padrão onde classes anotadas com <emphasis>@ManagementController</emphasis> serão registradas no MBeanServer.</para>
  282 + <para>Na especificação JMX, um MBean é registrado no MBeanServer com um nome no formato <emphasis>domain:name=MBeanName</emphasis>
  283 + (ex: <emphasis>br.gov.frameworkdemoiselle.jmx:name=NotificationBroadcaster</emphasis>). Esse parâmetro controla a porção <emphasis>domain</emphasis>
  284 + desse formato.</para>
  285 + </entry>
  286 + <entry>O pacote da classe anotada com <emphasis>@ManagementController</emphasis></entry>
  287 + </row>
  288 + <row valign="top">
  289 + <entry>frameworkdemoiselle.management.jmx.notification.domain</entry>
  290 + <entry>
  291 + <para>O mesmo que <emphasis>frameworkdemoiselle.management.jmx.mbean.domain</emphasis>, mas apenas para o domínio do
  292 + MBean <emphasis role="bold">br.gov.frameworkdemoiselle.jmx.internal.NotificationBroadcaster</emphasis>. Esse MBean é automaticamente
  293 + registrado para receber notificações enviadas usando a classe <emphasis role="bold">br.gov.frameworkdemoiselle.management.NotificationManager</emphasis></para>
  294 + </entry>
  295 + <entry>br.gov.frameworkdemoiselle.jmx</entry>
  296 + </row>
  297 + <row valign="top">
  298 + <entry>frameworkdemoiselle.management.jmx.notification.name</entry>
  299 + <entry>
  300 + <para>O nome usado para registrar a classe <emphasis role="bold">br.gov.frameworkdemoiselle.jmx.internal.NotificationBroadcaster</emphasis> como MBean.</para>
  301 + </entry>
  302 + <entry>NotificationBroadcaster</entry>
  303 + </row>
  304 + </tbody>
  305 + </tgroup>
  306 + </table>
263 307 </para>
264 308  
265 309 <!-- <section>
... ...
impl/extension/jmx/src/main/java/br/gov/frameworkdemoiselle/jmx/configuration/JMXConfig.java
... ... @@ -40,6 +40,7 @@ import javax.management.NotificationBroadcaster;
40 40  
41 41 import br.gov.frameworkdemoiselle.annotation.Name;
42 42 import br.gov.frameworkdemoiselle.configuration.Configuration;
  43 +import br.gov.frameworkdemoiselle.stereotype.ManagementController;
43 44  
44 45 @Configuration(prefix = "frameworkdemoiselle.management.jmx.")
45 46 public class JMXConfig {
... ... @@ -48,13 +49,13 @@ public class JMXConfig {
48 49 private String mbeanDomain;
49 50  
50 51 @Name("notification.domain")
51   - private String notificationDomain;
  52 + private String notificationDomain = "br.gov.frameworkdemoiselle.jmx";
52 53  
53 54 @Name("notification.name")
54 55 private String notificationMBeanName = "NotificationBroadcaster";
55 56  
56 57 /**
57   - * </p>The domain to register all {@link Managed} classes found during boot.</p>
  58 + * </p>The domain to register all {@link ManagementController} classes found during boot.</p>
58 59 *
59 60 * <p>The full name of a MBean has the format of <code>domain:name=MBeanName</code> (ex: <code>br.gov.frameworkdemoiselle.jmx:name=NotificationBroadcaster</code>), this
60 61 * parameter is the "domain" portion of the full name.</p>
... ...