Merge branch '2.4.0' of git@github.com:demoiselle/framework.git into 2.4.0

Ednara Oliveira
2 parents 82767e57 6b429231
Showing 30 changed files with 486 additions and 272 deletions Show diff stats
documentation/reference/pom.xml
documentation/reference/pt-BR/gerenciamento.xml
documentation/reference/pt-BR/images/jmx-jconsole-example.png
documentation/reference/pt-BR/master.xml
documentation/reference/pt-BR/security.xml
impl/core/src/main/java/br/gov/frameworkdemoiselle/annotation/OperationType.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/bootstrap/ManagementBootstrap.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/context/AbstractCustomContext.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/implementation/NotificationManagerImpl.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/management/ManagedType.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/management/ManagementNotificationEvent.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/management/ManagementNotificationEventImpl.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/management/qualifier/AttributeChange.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/management/qualifier/Generic.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/AttributeChangeNotification.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/GenericNotification.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/ManagementNotificationEvent.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/Notification.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/NotificationManager.java
impl/core/src/test/java/management/NotificationTestCase.java
@@ -45,7 +45,7 @@
 	<parent>
 		<groupId>br.gov.frameworkdemoiselle</groupId>
 		<artifactId>demoiselle-documentation-parent</artifactId>
-		<version>8</version>
+		<version>9-SNAPSHOT</version>
 		<relativePath>../../../internal/parent/documentation</relativePath>
 	</parent>
 <?xml version='1.0' encoding="utf-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>
-<chapter id="mensagem">
+<chapter id="gerenciamento">
 	<title>Monitoração e Gerenciamento de Recursos</title>
@@ -32,31 +32,179 @@
 		anotada com o estereótipo <code>@ManagementController</code>.</para>
 		<programlisting role="JAVA"><![CDATA[
-		@ManagementController
-		public class GerenciadorUsuarios]]></programlisting>
+@ManagementController
+public class GerenciadorUsuarios]]></programlisting>
 		<para>Essa anotação é suficiente para o mecanismo de gerenciamento descobrir sua classe e disponibiliza-la para ser monitorada e gerenciada.</para>
 		<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>
-		não expõe nenhum aspecto seu. Para selecionais quais aspectos serão expostos usamos as anotações <code>@ManagedProperty</code> e <code>@ManagedOperation</code>.</para>
-		
-		<table>
-			<tbody>
-				<row>
-					<entry>
-						<emphasis role="BOLD">@ManagedProperty</emphasis>
-					</entry>
-				</row>
-				
-				<row>
-					<entry>
-						<para>Marca um atributo na classe como uma propriedade gerenciada, significando que clientes externos podem ler e/ou escrever valores nesses atributos.</para>
-						<para>Um</para>
-					</entry>
-				</row>
-			</tbody>
-		</table>
+		não expõe nenhum aspecto seu. Para selecionar quais aspectos serão expostos usamos as anotações
+		<emphasis>@ManagedProperty</emphasis> e <emphasis>@ManagedOperation</emphasis>. Além disso outras anotações podem ser usadas para personalizar o funcionamento
+		de classes anotadas com <code>@ManagementController</code>.</para>
+		<informaltable>
+			<tgroup cols="3">
+				<thead>
+					<row>
+						<entry>Anotação</entry>
+						<entry>Descrição</entry>
+						<entry>Atributos</entry>
+					</row>
+				</thead>
+			
+				<tbody>
+					<row>
+						<entry>
+							<emphasis role="BOLD">@ManagedProperty</emphasis>
+						</entry>
+						
+						<entry>
+							<para>Marca um atributo na classe como uma propriedade gerenciada, significando que clientes externos podem ler e/ou escrever valores nesses atributos.</para>
+							<para>Um atributo marcado pode estar disponível para leitura e/ou escrita. Por padrão, o que determina a visibilidade de um atributo
+							marcado é a presença dos métodos <emphasis>getAtributo</emphasis> e <emphasis>setAtributo</emphasis>, respectivamente disponibilizando o atributo
+							para leitura e escrita.</para>
+							<para>Para sobrescrever esse comportamento existe na anotação <emphasis role="BOLD">@ManagedProperty</emphasis> o atributo <emphasis>accessLevel</emphasis>.
+							Com ele é possível criar um atributo apenas para leitura, mas que contenha um método <emphasis>set</emphasis>. O contrário também é possível.</para>
+						</entry>
+						
+						<entry>
+							<itemizedlist>
+								<listitem><emphasis role="BOLD">description</emphasis>: Um texto descritivo documentando o propósito da propriedade.</listitem>
+								<listitem><emphasis role="BOLD">accessLevel</emphasis>: Sobrescreve o nível padrão de acesso de uma propriedade. Os valores possíveis são
+								READ_ONLY, WRITE_ONLY e DEFAULT, que significa que a presença de métodos <emphasis>get</emphasis> e <emphasis>set</emphasis> vai determinar o nível de acesso.</listitem>
+							</itemizedlist>
+						</entry>
+					</row>
+					
+					<row>
+						<entry>
+							<emphasis role="BOLD">@ManagedOperation</emphasis>
+						</entry>
+						
+						<entry>
+							<para>Marca um método da classe gerenciada como uma operação, o que significa que clientes externos podem invocar esse método remotamente.</para>
+							<para>Operações gerenciadas normalmente são criadas para executar intervenções em um sistema já em execução. Por exemplo, é possível criar uma
+							operação que, ao ser invocada, destrua todas as seções abertas no servidor e não utilizadas nos últimos 30 minutos.</para>
+						</entry>
+						
+						<entry>
+							<itemizedlist>
+								<listitem><emphasis role="BOLD">description</emphasis>: Um texto descritivo documentando o propósito da operação.</listitem>
+								<listitem><emphasis role="BOLD">type</emphasis>: Documenta o propósito da operação. <emphasis>ACTION</emphasis> informa que a operação modificará
+								o sistema de alguma forma. <emphasis>INFO</emphasis> diz que a operação coletará e retornará informações sobre o sistema. <emphasis>ACTION_INFO</emphasis> 
+								informa que a operação modificará o sistema de alguma forma e retornará informações sobre o resultado. <emphasis>UNKNOWN</emphasis> é o padrão
+								e significa que o resultado da execução da operação é desconhecido.</listitem>
+							</itemizedlist>
+						</entry>
+					</row>
+					
+					<row>
+						<entry>
+							<emphasis role="BOLD">@OperationParameter</emphasis>
+						</entry>
+						
+						<entry>
+							<para>Esta anotação opcional pode ser usada para cada parâmetro de um método anotado com <emphasis role="BOLD">@ManagedOperation</emphasis>.</para>
+							
+							<para>Ele permite detalhar melhor parâmetros em uma operação gerenciada. O efeito desta anotação é dependente da
+							tecnologia utilizada para comunicação entre cliente e servidor. Na maioria das tecnologias, essa anotação meramente permite ao cliente
+							exibir informações sobre cada parâmetro: nome, tipo e descrição.</para>
+						</entry>
+						
+						<entry>
+							<itemizedlist>
+								<listitem><emphasis role="BOLD">name</emphasis>: O nome do parâmetro quando exibido para clientes.</listitem>
+								<listitem><emphasis role="BOLD">description</emphasis>: Um texto descritivo documentando o propósito do parâmetro.</listitem>
+							</itemizedlist>
+						</entry>
+					</row>
+				</tbody>
+			</tgroup>
+		</informaltable>
+		
+	</section>
+	
+	
+	
+	<section>
+		<title>Expondo aspectos de sua aplicação para monitoração</title>
+		
+		<para>Uma vez que uma classe esteja anotada com <emphasis>@ManagementController</emphasis> e seus atributos e operações estejam expostos, a classe está pronta para
+		ser monitorada.</para>
+		
+		<para>Suponha que a aplicação deseje expor o número de usuários que efetuaram login. A operação de <emphasis>login</emphasis> será processada em
+		uma classe de negócio <emphasis>ControleAcesso</emphasis>. Vamos supor também que existe uma classe chamada <emphasis>MonitorLogin</emphasis> responsável
+		por expor o número de usuários que efetuaram login no sistema.</para>
+		
+		<programlisting role="JAVA"><![CDATA[
+@BusinessController
+public class ControleAcesso{
+
+  @Inject
+  private MonitorLogin monitorLogin;
+
+  public boolean efetuarLogin(String usuario , String senha){
+    // código de login
+    monitorLogin.setContadorLogin( monitorLogin.getContadorLogin() + 1 );
+  }
+}]]></programlisting>
+		
+		<para>Como é possível ver, classes anotadas com <emphasis>@ManagementController</emphasis> podem ser injetadas em qualquer ponto do código. Valores definidos
+		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á
+		a quantidade de logins efetuados no momento da consulta.</para>
 	</section>
+	
+	<section>
+		<title>Conectando um cliente de monitoração</title>
+		
+		<para>O <emphasis>demoiselle-core</emphasis> contém as funcionalidades necessárias para marcar aspectos monitoráveis de sua aplicação,
+		mas não conta com nenhum mecanismo para estabelecer uma conexão com um cliente de monitoração. Para isso utiliza-se extensões do framework.</para>
+		
+		<para>A extensão padrão do framework <emphasis>Demoiselle</emphasis> responsável pela tecnologia de monitoração é a <emphasis>demoiselle-jmx</emphasis>.
+		Essa extensão utiliza a especificação JMX (JSR 3) e permite registrar as classes marcadas para monitoração como <emphasis>MBeans</emphasis>.
+		Uma vez que as classes sejam registradas como <emphasis>MBeans</emphasis>, seus atributos e operações expostos para monitoração podem ser
+		acessados via JMX por um cliente adequado, como o <emphasis>JConsole</emphasis> que acompanha por padrão o JDK da Oracle.</para>
+		
+		<tip>
+			<para>Para acrescentar a extensão <emphasis>demoiselle-jmx</emphasis> em um projeto Maven, adicione a dependência abaixo no arquivo <emphasis>pom.xml</emphasis>.</para>
+			
+			<programlisting role="XML"><![CDATA[
+<dependency>
+  <groupId>br.gov.frameworkdemoiselle</groupId>
+  <artifactId>demoiselle-jmx</artifactId>
+  <scope>compile</scope>
+</dependency>]]></programlisting>
+		</tip>
+		
+		<tip>
+			<para>A API de monitoração é compatível com o uso de múltiplas extensões simultãneas. Adicione em seu projeto a dependência às extensões desejadas e configure-as
+			individualmente, as classes monitoradas serão então expostas para todas as extensões escolhidas.</para>
+		</tip>
+		
+		<para>A figura <xref linkend="exemplo_jconsole"/> mostra como uma classe monitorada na aplicação <emphasis>Bookmark</emphasis> é exibida no <emphasis>JConsole</emphasis>.</para>
+		
+		<programlisting role="JAVA"><![CDATA[
+@ManagementController
+public class BookmarkMonitor {
+
+  @Inject
+  private BookmarkDAO bookmarkDAO;
+
+  @ManagedOperation(type=OperationType.INFO , description="Informa quantos bookmarks estão salvos no sistema")
+  public int countSavedBookmarks(){
+      return bookmarkDAO.findAll().size();
+  }
+}]]></programlisting>
+		
+		<figure id="exemplo_jconsole"><title>JConsole acessando a aplicação <emphasis>Bookmark</emphasis></title>
+			<mediaobject>
+				<imageobject>
+					<imagedata fileref="images/jmx-jconsole-example.png" width="90%" />
+				</imageobject>
+				<textobject><phrase>JConsole acessando a aplicação <emphasis>Bookmark</emphasis></phrase></textobject>
+			</mediaobject>
+		</figure>
+	</section>
+		
 </chapter>
 \ No newline at end of file
@@ -39,6 +39,7 @@
 	<xi:include href="templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="security.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="paginacao.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="gerenciamento.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="properties.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<!-- parte 1 -->
@@ -214,8 +214,13 @@ public class Credential {
 			frameworkdemoiselle.security.authorizer.class=projeto.MeuAuthorizer 
 		</programlisting> -->
 		<para>
-			Pronto! Sua aplicação já possui uma implementação de segurança definida. Caso sua ela não implemente essas interfaces, no momento em que
-			forem chamadas, o framework lançará uma exceção informando que a aplicação precisa implementá-las.	
+			Pronto! Sua aplicação já possui uma implementação de segurança definida.
+		</para>
+			
+		<para>
+			Caso sua aplicação detecte o uso das anotações @RequiredRole e @RequiredPermission mas nenhuma classe
+			implemente essas interfaces, no momento em que os recursos anotados forem acessados, o framework lançará uma exceção informando que a
+			aplicação precisa implementá-las.	
 		</para>
 		<para>
 			Se você tem mais de uma implementação de <literal>Authenticator</literal> e/ou <literal>Authorizer</literal> (o que pode acontecer, por exemplo, quando
@@ -36,7 +36,6 @@
  */
 package br.gov.frameworkdemoiselle.annotation;
-import javax.management.MBeanOperationInfo;
 /**
  * <p>
@@ -56,32 +55,24 @@ public enum OperationType {
 	 * ManagedOperation is write-only, it causes the application to change some of it's behaviour but doesn't return any
 	 * kind of information
 	 */
-	ACTION(MBeanOperationInfo.ACTION),
+	ACTION,
+
 	/**
 	 * ManagedOperation is read-only, it will operate over data provided by the application and return some information,
 	 * but will not change the application in any way.
 	 */
-	INFO(MBeanOperationInfo.INFO),
+	INFO,
+	
 	/**
 	 * ManagedOperation is read-write, it will both change the way the application work and return some information
 	 * regarding the result of the operation.
 	 */
-	ACTION_INFO(MBeanOperationInfo.ACTION_INFO),
+	ACTION_INFO,
+
 	/**
 	 * The effect of calling this operation is unknown. This is the default type and if this type is assigned to an
 	 * operation, the user must rely on the {@link ManagedOperation#description()} attribute to learn about how the
 	 * operation works.
 	 */
-	UNKNOWN(MBeanOperationInfo.UNKNOWN);
-
-	private int operationTypeValue;
-
-	private OperationType(int type) {
-		this.operationTypeValue = type;
-	}
-
-	public int getValue() {
-		return operationTypeValue;
-	}
-
+	UNKNOWN
 }
@@ -13,7 +13,6 @@ import javax.enterprise.inject.spi.AfterDeploymentValidation;
 import javax.enterprise.inject.spi.AnnotatedType;
 import javax.enterprise.inject.spi.Bean;
 import javax.enterprise.inject.spi.BeanManager;
-import javax.enterprise.inject.spi.BeforeShutdown;
 import javax.enterprise.inject.spi.Extension;
 import javax.enterprise.inject.spi.ProcessAnnotatedType;
@@ -23,6 +22,7 @@ import br.gov.frameworkdemoiselle.internal.context.ManagedContext;
 import br.gov.frameworkdemoiselle.internal.management.ManagedType;
 import br.gov.frameworkdemoiselle.internal.management.Management;
 import br.gov.frameworkdemoiselle.internal.producer.ResourceBundleProducer;
+import br.gov.frameworkdemoiselle.lifecycle.AfterShutdownProccess;
 import br.gov.frameworkdemoiselle.lifecycle.ManagementExtension;
 import br.gov.frameworkdemoiselle.stereotype.ManagementController;
 import br.gov.frameworkdemoiselle.util.Beans;
@@ -72,7 +72,7 @@ public class ManagementBootstrap implements Extension {
 		monitoringManager.initialize(managementExtensionCache);
 	}
-	public void unregisterAvailableManagedTypes(@Observes final BeforeShutdown event) {
+	public void unregisterAvailableManagedTypes(@Observes final AfterShutdownProccess event) {
 		Management manager = Beans.getReference(Management.class);
 		manager.shutdown(managementExtensionCache);
@@ -65,7 +65,6 @@ public abstract class AbstractCustomContext implements CustomContext {
 	}
 	@Override
-	@SuppressWarnings("unchecked")
 	public <T> T get(final Contextual<T> contextual, final CreationalContext<T> creationalContext) {
 		T instance = null;
@@ -0,0 +1,64 @@
+package br.gov.frameworkdemoiselle.internal.implementation;
+
+import java.io.Serializable;
+
+import javax.enterprise.event.Event;
+import javax.enterprise.util.AnnotationLiteral;
+import javax.inject.Inject;
+
+import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEventImpl;
+import br.gov.frameworkdemoiselle.internal.management.qualifier.AttributeChange;
+import br.gov.frameworkdemoiselle.internal.management.qualifier.Generic;
+import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;
+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
+import br.gov.frameworkdemoiselle.management.GenericNotification;
+import br.gov.frameworkdemoiselle.management.NotificationManager;
+import br.gov.frameworkdemoiselle.util.Beans;
+
+
+@SuppressWarnings("serial")
+public class NotificationManagerImpl implements NotificationManager,Serializable {
+	
+	@Inject
+	@Generic
+	private Event<ManagementNotificationEvent> genericNotificationEvent;
+	
+	@Inject
+	@AttributeChange
+	private Event<ManagementNotificationEvent> attributeChangeNotificationEvent;
+	
+	/**
+	 * Sends a generic notification to all management clients.
+	 * 
+	 * @param notification The notification to send
+	 */
+	public void sendNotification(GenericNotification notification) {
+		if (! AttributeChangeNotification.class.isInstance(notification) ){
+			getGenericNotificationEvent().fire(new ManagementNotificationEventImpl(notification));
+		}
+		else{
+			getAttributeChangeNotificationEvent().fire(new ManagementNotificationEventImpl(notification));
+		}
+	}
+
+	@SuppressWarnings("unchecked")
+	private Event<ManagementNotificationEvent> getGenericNotificationEvent() {
+		if (genericNotificationEvent==null){
+			genericNotificationEvent = Beans.getReference(Event.class , new AnnotationLiteral<Generic>() {});
+		}
+		
+		return genericNotificationEvent;
+	}
+	
+	@SuppressWarnings("unchecked")
+	private Event<ManagementNotificationEvent> getAttributeChangeNotificationEvent() {
+		if (attributeChangeNotificationEvent==null){
+			attributeChangeNotificationEvent = Beans.getReference(Event.class , new AnnotationLiteral<AttributeChange>() {});
+		}
+		
+		return attributeChangeNotificationEvent;
+	}
+	
+	
+	
+}
@@ -47,6 +47,7 @@ import javax.inject.Qualifier;
 import br.gov.frameworkdemoiselle.DemoiselleException;
 import br.gov.frameworkdemoiselle.annotation.ManagedOperation;
 import br.gov.frameworkdemoiselle.annotation.ManagedProperty;
+import br.gov.frameworkdemoiselle.annotation.OperationType;
 import br.gov.frameworkdemoiselle.annotation.ManagedProperty.ManagedPropertyAccess;
 import br.gov.frameworkdemoiselle.annotation.OperationParameter;
 import br.gov.frameworkdemoiselle.internal.producer.ResourceBundleProducer;
@@ -163,6 +164,7 @@ public class ManagedType {
 					Class<?>[] parameterTypes = method.getParameterTypes();
 					Annotation[][] parameterAnnotations = method.getParameterAnnotations();
 					ParameterDetail[] parameterDetails = new ParameterDetail[parameterTypes.length];
+					OperationType operationType = opAnnotation.type();
 					for (int i = 0; i < parameterTypes.length; i++) {
 						OperationParameter paramAnnotation = null;
@@ -181,7 +183,7 @@ public class ManagedType {
 					// Com todas as informações, criamos nossa instância de MethodDetail e
 					// acrescentamos na lista de todas as operações.
-					MethodDetail detail = new MethodDetail(method, opAnnotation.description(), parameterDetails);
+					MethodDetail detail = new MethodDetail(method, opAnnotation.description(), operationType, parameterDetails);
 					operationMethods.put(method.getName(), detail);
 				}
 			}
@@ -326,12 +328,15 @@ public class ManagedType {
 		private final ParameterDetail[] parameterTypers;
-		private String description;
+		private final String description;
+		
+		private final OperationType type;
-		public MethodDetail(Method method, String description, ParameterDetail[] parameterTypers) {
+		public MethodDetail(Method method, String description, OperationType type,ParameterDetail[] parameterTypers) {
 			super();
 			this.method = method;
 			this.description = description;
+			this.type = type;
 			this.parameterTypers = parameterTypers;
 		}
@@ -347,6 +352,10 @@ public class ManagedType {
 			return description;
 		}
+		public OperationType getType() {
+			return type;
+		}
+		
 	}
 	public final class ParameterDetail {
@@ -1,65 +0,0 @@
-/*
- * Demoiselle Framework
- * Copyright (C) 2010 SERPRO
- * ----------------------------------------------------------------------------
- * This file is part of Demoiselle Framework.
- * 
- * Demoiselle Framework is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public License version 3
- * as published by the Free Software Foundation.
- * 
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- * 
- * You should have received a copy of the GNU Lesser General Public License version 3
- * along with this program; if not,  see <http://www.gnu.org/licenses/>
- * or write to the Free Software Foundation, Inc., 51 Franklin Street,
- * Fifth Floor, Boston, MA  02110-1301, USA.
- * ----------------------------------------------------------------------------
- * Este arquivo é parte do Framework Demoiselle.
- * 
- * O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou
- * modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação
- * do Software Livre (FSF).
- * 
- * Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA
- * GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou
- * APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português
- * para maiores detalhes.
- * 
- * Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título
- * "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>
- * ou escreva para a Fundação do Software Livre (FSF) Inc.,
- * 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
- */
-package br.gov.frameworkdemoiselle.internal.management;
-
-import br.gov.frameworkdemoiselle.management.Notification;
-import br.gov.frameworkdemoiselle.management.NotificationManager;
-
-/**
- * Event fired when a notification is sent by {@link NotificationManager}.
- * Implementators can capture this event and be notified when the {@link NotificationManager}
- * sends notifications, so they can pass the notification to the underlying technology.
- * 
- * @author serpro
- *
- */
-public class ManagementNotificationEvent {
-	
-	private Notification notification;
-	
-	public ManagementNotificationEvent(Notification notification){
-		this.notification = notification;
-	}
-
-	public Notification getNotification() {
-		return notification;
-	}
-
-	public void setNotification(Notification notification) {
-		this.notification = notification;
-	}
-}
@@ -0,0 +1,65 @@
+/*
+ * Demoiselle Framework
+ * Copyright (C) 2010 SERPRO
+ * ----------------------------------------------------------------------------
+ * This file is part of Demoiselle Framework.
+ * 
+ * Demoiselle Framework is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public License version 3
+ * as published by the Free Software Foundation.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public License version 3
+ * along with this program; if not,  see <http://www.gnu.org/licenses/>
+ * or write to the Free Software Foundation, Inc., 51 Franklin Street,
+ * Fifth Floor, Boston, MA  02110-1301, USA.
+ * ----------------------------------------------------------------------------
+ * Este arquivo é parte do Framework Demoiselle.
+ * 
+ * O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou
+ * modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação
+ * do Software Livre (FSF).
+ * 
+ * Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA
+ * GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou
+ * APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português
+ * para maiores detalhes.
+ * 
+ * Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título
+ * "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>
+ * ou escreva para a Fundação do Software Livre (FSF) Inc.,
+ * 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
+ */
+package br.gov.frameworkdemoiselle.internal.management;
+
+import br.gov.frameworkdemoiselle.management.GenericNotification;
+import br.gov.frameworkdemoiselle.management.NotificationManager;
+
+/**
+ * Event fired when a notification is sent by {@link NotificationManager}.
+ * Implementators can capture this event and be notified when the {@link NotificationManager}
+ * sends notifications, so they can pass the notification to the underlying technology.
+ * 
+ * @author serpro
+ *
+ */
+public class ManagementNotificationEventImpl implements br.gov.frameworkdemoiselle.management.ManagementNotificationEvent {
+	
+	private GenericNotification notification;
+	
+	public ManagementNotificationEventImpl(GenericNotification notification){
+		this.notification = notification;
+	}
+
+	public GenericNotification getNotification() {
+		return notification;
+	}
+
+	public void setNotification(GenericNotification notification) {
+		this.notification = notification;
+	}
+}
@@ -43,8 +43,8 @@ import java.lang.annotation.Target;
 import javax.inject.Qualifier;
-import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;
+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
 /**
  * 
@@ -43,13 +43,13 @@ import java.lang.annotation.Target;
 import javax.inject.Qualifier;
-import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEvent;
-import br.gov.frameworkdemoiselle.management.Notification;
+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
+import br.gov.frameworkdemoiselle.management.GenericNotification;
 /**
  * 
  * Enables {@link ManagementNotificationEvent} observers to trigger only with notifications
- * of the base type {@link Notification}.
+ * of the base type {@link GenericNotification}.
  * 
  * @author serpro
  *
@@ -39,12 +39,12 @@ package br.gov.frameworkdemoiselle.management;
 /**
  * Special notification to denote an attribute has changed values.
  * 
- * @see Notification
+ * @see GenericNotification
  * 
  * @author serpro
  *
  */
-public class AttributeChangeNotification extends Notification {
+public class AttributeChangeNotification extends GenericNotification {
 	private String attributeName;
@@ -0,0 +1,77 @@
+/*
+ * Demoiselle Framework
+ * Copyright (C) 2010 SERPRO
+ * ----------------------------------------------------------------------------
+ * This file is part of Demoiselle Framework.
+ * 
+ * Demoiselle Framework is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public License version 3
+ * as published by the Free Software Foundation.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public License version 3
+ * along with this program; if not,  see <http://www.gnu.org/licenses/>
+ * or write to the Free Software Foundation, Inc., 51 Franklin Street,
+ * Fifth Floor, Boston, MA  02110-1301, USA.
+ * ----------------------------------------------------------------------------
+ * Este arquivo é parte do Framework Demoiselle.
+ * 
+ * O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou
+ * modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação
+ * do Software Livre (FSF).
+ * 
+ * Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA
+ * GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou
+ * APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português
+ * para maiores detalhes.
+ * 
+ * Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título
+ * "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>
+ * ou escreva para a Fundação do Software Livre (FSF) Inc.,
+ * 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
+ */
+package br.gov.frameworkdemoiselle.management;
+
+/**
+ * 
+ * Notification that can be sent by the {@link NotificationManager}.
+ * 
+ * @author serpro
+ *
+ */
+public class GenericNotification {
+	
+	private Object message;
+	
+	public GenericNotification(){
+	}
+	
+	public GenericNotification(Object message) {
+		super();
+		this.message = message;
+	}
+
+
+	public Object getMessage() {
+		return message;
+	}
+
+	
+	public void setMessage(Object message) {
+		this.message = message;
+	}
+
+	
+	public Class<? extends Object> getType() {
+		if (message!=null){
+			return message.getClass();
+		}
+		
+		return null;
+	}
+
+}
@@ -0,0 +1,15 @@
+package br.gov.frameworkdemoiselle.management;
+
+/**
+ * Event fired when a notification is sent by {@link NotificationManager}.
+ * Implementators can capture this event and be notified when the {@link NotificationManager}
+ * sends notifications, so they can pass the notification to the underlying technology.
+ * 
+ * @author serpro
+ *
+ */
+public interface ManagementNotificationEvent {
+	
+	public GenericNotification getNotification();
+
+}
@@ -1,77 +0,0 @@
-/*
- * Demoiselle Framework
- * Copyright (C) 2010 SERPRO
- * ----------------------------------------------------------------------------
- * This file is part of Demoiselle Framework.
- * 
- * Demoiselle Framework is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public License version 3
- * as published by the Free Software Foundation.
- * 
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- * 
- * You should have received a copy of the GNU Lesser General Public License version 3
- * along with this program; if not,  see <http://www.gnu.org/licenses/>
- * or write to the Free Software Foundation, Inc., 51 Franklin Street,
- * Fifth Floor, Boston, MA  02110-1301, USA.
- * ----------------------------------------------------------------------------
- * Este arquivo é parte do Framework Demoiselle.
- * 
- * O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou
- * modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação
- * do Software Livre (FSF).
- * 
- * Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA
- * GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou
- * APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português
- * para maiores detalhes.
- * 
- * Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título
- * "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>
- * ou escreva para a Fundação do Software Livre (FSF) Inc.,
- * 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
- */
-package br.gov.frameworkdemoiselle.management;
-
-/**
- * 
- * Notification that can be sent by the {@link NotificationManager}.
- * 
- * @author serpro
- *
- */
-public class Notification {
-	
-	private Object message;
-	
-	public Notification(){
-	}
-	
-	public Notification(Object message) {
-		super();
-		this.message = message;
-	}
-
-
-	public Object getMessage() {
-		return message;
-	}
-
-	
-	public void setMessage(Object message) {
-		this.message = message;
-	}
-
-	
-	public Class<? extends Object> getType() {
-		if (message!=null){
-			return message.getClass();
-		}
-		
-		return null;
-	}
-
-}
@@ -36,23 +36,18 @@
  */
 package br.gov.frameworkdemoiselle.management;
-import java.io.Serializable;
-
 import javax.enterprise.context.ApplicationScoped;
-import javax.enterprise.event.Event;
 import javax.enterprise.event.Observes;
-import javax.enterprise.util.AnnotationLiteral;
 import javax.inject.Inject;
-import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.internal.management.qualifier.AttributeChange;
 import br.gov.frameworkdemoiselle.internal.management.qualifier.Generic;
 import br.gov.frameworkdemoiselle.util.Beans;
 /**
  * 
- * <p>Central class to manage sending notifications to management clients.
- * This class allows applications to send management notifications without
+ * <p>Central type to manage sending notifications to management clients.
+ * This interface allows applications to send management notifications without
  * knowledge of the technology used to send those notifications.</p>
  * 
  * <p>To obtain an instance of the {@link NotificationManager} simply inject it in
@@ -68,49 +63,13 @@ import br.gov.frameworkdemoiselle.util.Beans;
  *
  */
 @ApplicationScoped
-@SuppressWarnings("serial")
-public class NotificationManager implements Serializable{
-	
-	@Inject
-	@Generic
-	private Event<ManagementNotificationEvent> genericNotificationEvent;
-	
-	@Inject
-	@AttributeChange
-	private Event<ManagementNotificationEvent> attributeChangeNotificationEvent;
+public interface NotificationManager {
 	/**
-	 * Sends a generic notification to all management clients.
+	 * Sends a notification to all management clients.
 	 * 
 	 * @param notification The notification to send
 	 */
-	public void sendNotification(Notification notification) {
-		if (! AttributeChangeNotification.class.isInstance(notification) ){
-			getGenericNotificationEvent().fire(new ManagementNotificationEvent(notification));
-		}
-		else{
-			getAttributeChangeNotificationEvent().fire(new ManagementNotificationEvent(notification));
-		}
-	}
+	public void sendNotification(GenericNotification notification);
-	@SuppressWarnings("unchecked")
-	private Event<ManagementNotificationEvent> getGenericNotificationEvent() {
-		if (genericNotificationEvent==null){
-			genericNotificationEvent = Beans.getReference(Event.class , new AnnotationLiteral<Generic>() {});
-		}
-		
-		return genericNotificationEvent;
-	}
-	
-	@SuppressWarnings("unchecked")
-	private Event<ManagementNotificationEvent> getAttributeChangeNotificationEvent() {
-		if (attributeChangeNotificationEvent==null){
-			attributeChangeNotificationEvent = Beans.getReference(Event.class , new AnnotationLiteral<AttributeChange>() {});
-		}
-		
-		return attributeChangeNotificationEvent;
-	}
-	
-	
-	
 }
@@ -57,7 +57,7 @@ import br.gov.frameworkdemoiselle.annotation.Name;
 import br.gov.frameworkdemoiselle.internal.management.ManagedType;
 import br.gov.frameworkdemoiselle.internal.management.Management;
 import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;
-import br.gov.frameworkdemoiselle.management.Notification;
+import br.gov.frameworkdemoiselle.management.GenericNotification;
 import br.gov.frameworkdemoiselle.management.NotificationManager;
 import br.gov.frameworkdemoiselle.util.Beans;
 import br.gov.frameworkdemoiselle.util.ResourceBundle;
@@ -98,7 +98,7 @@ public class NotificationTestCase {
 	 */
 	@Test
 	public void testSendGenericNotification(){
-		manager.sendNotification(new Notification("Test Message"));
+		manager.sendNotification(new GenericNotification("Test Message"));
 		DummyNotificationListener listener = Beans.getReference(DummyNotificationListener.class);
 		Assert.assertEquals("Test Message", listener.getMessage());
 	}
@@ -39,10 +39,10 @@ package management.testclasses;
 import javax.enterprise.context.ApplicationScoped;
 import javax.enterprise.event.Observes;
-import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.internal.management.qualifier.AttributeChange;
 import br.gov.frameworkdemoiselle.internal.management.qualifier.Generic;
 import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;
+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.management.NotificationManager;
 /**
@@ -212,9 +212,27 @@ public class DynamicMBeanProxy implements DynamicMBean {
 			// Com todas as informações, criamos nossa instância de MBeanOperationInfo e
 			// acrescentamos na lista de todas as operações.
+			int operationType = 0;
+			switch(methodDetail.getType()){
+				case ACTION:
+					operationType = MBeanOperationInfo.ACTION;
+					break;
+					
+				case INFO:
+					operationType = MBeanOperationInfo.INFO;
+					break;
+					
+				case ACTION_INFO:
+					operationType = MBeanOperationInfo.ACTION_INFO;
+					break;
+					
+				default:
+					operationType = MBeanOperationInfo.UNKNOWN;
+			}
+			
 			MBeanOperationInfo operation = new MBeanOperationInfo(methodDetail.getMethod().getName(),
 					methodDetail.getDescription(), parameters, methodDetail.getMethod().getReturnType().getName(),
-					MBeanOperationInfo.ACTION_INFO);
+					operationType);
 			operations.add(operation);
@@ -39,10 +39,10 @@ package br.gov.frameworkdemoiselle.jmx.internal;
 import java.util.Collection;
 import java.util.HashMap;
-import javax.inject.Singleton;
+import javax.enterprise.context.ApplicationScoped;
 import javax.management.ObjectInstance;
-@Singleton
+@ApplicationScoped
 public class MBeanManager {
 	private HashMap<String,ObjectInstance> registeredMBeans = new HashMap<String,ObjectInstance>();
@@ -42,8 +42,8 @@ import javax.management.AttributeChangeNotification;
 import javax.management.Notification;
 import javax.management.NotificationBroadcasterSupport;
-import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.jmx.configuration.JMXConfig;
+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.management.NotificationManager;
 /**
@@ -67,7 +67,7 @@ final class NotificationBroadcaster extends NotificationBroadcasterSupport imple
 	private static final String NOTIFICATION_TYPE_GENERIC = "jmx.message";
 	protected void sendNotification( ManagementNotificationEvent event , JMXConfig config ) {
-		br.gov.frameworkdemoiselle.management.Notification demoiselleNotification = event.getNotification();
+		br.gov.frameworkdemoiselle.management.GenericNotification demoiselleNotification = event.getNotification();
 		Notification n = new Notification(NOTIFICATION_TYPE_GENERIC, config.getNotificationMBeanName(), sequenceNumber++, System.currentTimeMillis(), demoiselleNotification.getMessage().toString());
 		sendNotification(n);
 	}
@@ -41,10 +41,10 @@ import java.io.Serializable;
 import javax.enterprise.context.ApplicationScoped;
 import javax.enterprise.event.Observes;
-import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.internal.management.qualifier.AttributeChange;
 import br.gov.frameworkdemoiselle.internal.management.qualifier.Generic;
 import br.gov.frameworkdemoiselle.jmx.configuration.JMXConfig;
+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
 import br.gov.frameworkdemoiselle.management.NotificationManager;
 /**
@@ -61,7 +61,7 @@ import org.junit.runner.RunWith;
 import br.gov.frameworkdemoiselle.jmx.configuration.JMXConfig;
 import br.gov.frameworkdemoiselle.jmx.internal.MBeanManager;
 import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;
-import br.gov.frameworkdemoiselle.management.Notification;
+import br.gov.frameworkdemoiselle.management.GenericNotification;
 import br.gov.frameworkdemoiselle.management.NotificationManager;
 import br.gov.frameworkdemoiselle.util.Beans;
@@ -122,7 +122,7 @@ public class NotificationBroadcasterTestCase {
 		}
 		//Manda a notificação pelo Demoiselle
-		Notification n = new Notification("Notification test successful");
+		GenericNotification n = new GenericNotification("Notification test successful");
 		notificationManager.sendNotification(n);
 		//Se o componente funcionou, o Demoiselle propagou a notificação para o servidor MBean e o listener preencheu
@@ -48,6 +48,7 @@ import javax.servlet.http.HttpSession;
 import org.slf4j.Logger;
+import br.gov.frameworkdemoiselle.annotation.Name;
 import br.gov.frameworkdemoiselle.configuration.ConfigurationException;
 import br.gov.frameworkdemoiselle.internal.configuration.JsfSecurityConfig;
 import br.gov.frameworkdemoiselle.security.AfterLoginSuccessful;
@@ -55,6 +56,7 @@ import br.gov.frameworkdemoiselle.security.AfterLogoutSuccessful;
 import br.gov.frameworkdemoiselle.util.Beans;
 import br.gov.frameworkdemoiselle.util.PageNotFoundException;
 import br.gov.frameworkdemoiselle.util.Redirector;
+import br.gov.frameworkdemoiselle.util.ResourceBundle;
 @SessionScoped
 public class SecurityObserver implements Serializable {
@@ -69,6 +71,10 @@ public class SecurityObserver implements Serializable {
 	@Inject
 	private Logger logger;
+	
+	@Inject
+	@Name("demoiselle-jsf-bundle")
+	private ResourceBundle bundle;
 	public SecurityObserver() {
 		clear();
@@ -107,12 +113,7 @@ public class SecurityObserver implements Serializable {
 			Redirector.redirect(getConfig().getLoginPage());
 		} catch (PageNotFoundException cause) {
-			// TODO Colocar a mensagem no bundle
-			throw new ConfigurationException(
-					"A tela de login \""
-							+ cause.getViewId()
-							+ "\" não foi encontrada. Caso o seu projeto possua outra, defina no arquivo de configuração a chave \""
-							+ "frameworkdemoiselle.security.login.page" + "\"", cause);
+			throw new ConfigurationException( bundle.getString("login-page-not-found",cause.getViewId()) , cause);
 		}
 	}
@@ -130,12 +131,7 @@ public class SecurityObserver implements Serializable {
 		} catch (PageNotFoundException cause) {
 			if (redirectedFromConfig) {
-				// TODO Colocar a mensagem no bundle
-				throw new ConfigurationException(
-						"A tela \""
-								+ cause.getViewId()
-								+ "\" que é invocada após o logon não foi encontrada. Caso o seu projeto possua outra, defina no arquivo de configuração a chave \""
-								+ "frameworkdemoiselle.security.redirect.after.login" + "\"", cause);
+				throw new ConfigurationException( bundle.getString("after-login-page-not-found",cause.getViewId()) , cause);
 			} else {
 				throw cause;
 			}
@@ -152,12 +148,7 @@ public class SecurityObserver implements Serializable {
 			}
 		} catch (PageNotFoundException cause) {
-			// TODO Colocar a mensagem no bundle
-			throw new ConfigurationException(
-					"A tela \""
-							+ cause.getViewId()
-							+ "\" que é invocada após o logout não foi encontrada. Caso o seu projeto possua outra, defina no arquivo de configuração a chave \""
-							+ "frameworkdemoiselle.security.redirect.after.logout" + "\"", cause);
+			throw new ConfigurationException( bundle.getString("after-logout-page-not-found",cause.getViewId()) , cause);
 		} finally {
 			try {
@@ -33,4 +33,7 @@
 # ou escreva para a Fundação do Software Livre (FSF) Inc.,
 # 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
-id-converter-not-found=Voc\u00EA precisa criar um FacesConverter para a classe "{0}".
 \ No newline at end of file
+id-converter-not-found=Voc\u00EA precisa criar um FacesConverter para a classe "{0}".
+login-page-not-found=A tela de login "{0}" n\u00E3o foi encontrada. Caso essa n\u00E3o seja a p\u00E1gina correta, defina a p\u00E1gina no arquivo de configura\u00E7\u00E3o usando a chave "frameworkdemoiselle.security.login.page"
+after-login-page-not-found=A tela "{0}" acessada ap\u00F3s o login n\u00E3o foi encontrada. Caso essa n\u00E3o seja a p\u00E1gina correta, defina a p\u00E1gina no arquivo de configura\u00E7\u00E3o usando a chave "frameworkdemoiselle.security.redirect.after.login"
+after-logout-page-not-found=A tela "{0}" acessada ap\u00F3s o logout n\u00E3o foi encontrada. Caso essa n\u00E3o seja a p\u00E1gina correta, defina a p\u00E1gina no arquivo de configura\u00E7\u00E3o usando a chave "frameworkdemoiselle.security.redirect.after.logout"
 \ No newline at end of file
@@ -58,8 +58,9 @@ public class ServletAuthenticator implements Authenticator {
 	@Override
 	public void authenticate() throws AuthenticationException {
 		try {
-			getRequest().login(getCredentials().getUsername(), getCredentials().getPassword());
-
+			if (this.getUser()==null){
+				getRequest().login(getCredentials().getUsername(), getCredentials().getPassword());
+			}
 		} catch (ServletException cause) {
 			throw new AuthenticationException(getBundle().getString("authentication-failed"), cause);
 		}
@@ -68,6 +69,11 @@ public class ServletAuthenticator implements Authenticator {
 	@Override
 	public void unAuthenticate() {
 		getCredentials().clear();
+		try {
+			getRequest().logout();
+		} catch (ServletException e) {
+			//Logout já havia sido efetuado
+		}
 		getRequest().getSession().invalidate();
 	}
@@ -105,6 +105,11 @@
 				<artifactId>demoiselle-se</artifactId>
 				<version>2.4.0-BETA2-SNAPSHOT</version>
 			</dependency>
+			<dependency>
+				<groupId>br.gov.frameworkdemoiselle</groupId>
+				<artifactId>demoiselle-jmx</artifactId>
+				<version>2.4.0-BETA2-SNAPSHOT</version>
+			</dependency>
 <!--
 			<dependency>
 				<groupId>br.gov.frameworkdemoiselle</groupId>
	@@ -45,7 +45,7 @@		@@ -45,7 +45,7 @@
45	<parent>	45	<parent>
46	<groupId>br.gov.frameworkdemoiselle</groupId>	46	<groupId>br.gov.frameworkdemoiselle</groupId>
47	<artifactId>demoiselle-documentation-parent</artifactId>	47	<artifactId>demoiselle-documentation-parent</artifactId>
48	- <version>8</version>	48	+ <version>9-SNAPSHOT</version>
49	<relativePath>../../../internal/parent/documentation</relativePath>	49	<relativePath>../../../internal/parent/documentation</relativePath>
50	</parent>	50	</parent>
51		51
1	<?xml version='1.0' encoding="utf-8"?>	1	<?xml version='1.0' encoding="utf-8"?>
2	<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"	2	<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3	"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>	3	"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>
4	-<chapter id="mensagem">	4	+<chapter id="gerenciamento">
5		5
6	<title>Monitoração e Gerenciamento de Recursos</title>	6	<title>Monitoração e Gerenciamento de Recursos</title>
7		7
	@@ -32,31 +32,179 @@		@@ -32,31 +32,179 @@
32	anotada com o estereótipo <code>@ManagementController</code>.</para>	32	anotada com o estereótipo <code>@ManagementController</code>.</para>
33		33
34	<programlisting role="JAVA"><![CDATA[	34	<programlisting role="JAVA"><![CDATA[
35	- @ManagementController
36	- public class GerenciadorUsuarios]]></programlisting>	35	+@ManagementController
		36	+public class GerenciadorUsuarios]]></programlisting>
37		37
38	<para>Essa anotação é suficiente para o mecanismo de gerenciamento descobrir sua classe e disponibiliza-la para ser monitorada e gerenciada.</para>	38	<para>Essa anotação é suficiente para o mecanismo de gerenciamento descobrir sua classe e disponibiliza-la para ser monitorada e gerenciada.</para>
39		39
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>	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	- não expõe nenhum aspecto seu. Para selecionais quais aspectos serão expostos usamos as anotações <code>@ManagedProperty</code> e <code>@ManagedOperation</code>.</para>
42	-
43	- <table>
44	- <tbody>
45	- <row>
46	- <entry>
47	- <emphasis role="BOLD">@ManagedProperty</emphasis>
48	- </entry>
49	- </row>
50	-
51	- <row>
52	- <entry>
53	- <para>Marca um atributo na classe como uma propriedade gerenciada, significando que clientes externos podem ler e/ou escrever valores nesses atributos.</para>
54	- <para>Um</para>
55	- </entry>
56	- </row>
57	- </tbody>
58	- </table>	41	+ não expõe nenhum aspecto seu. Para selecionar quais aspectos serão expostos usamos as anotações
		42	+ <emphasis>@ManagedProperty</emphasis> e <emphasis>@ManagedOperation</emphasis>. Além disso outras anotações podem ser usadas para personalizar o funcionamento
		43	+ de classes anotadas com <code>@ManagementController</code>.</para>
59		44
		45	+ <informaltable>
		46	+ <tgroup cols="3">
		47	+ <thead>
		48	+ <row>
		49	+ <entry>Anotação</entry>
		50	+ <entry>Descrição</entry>
		51	+ <entry>Atributos</entry>
		52	+ </row>
		53	+ </thead>
		54	+
		55	+ <tbody>
		56	+ <row>
		57	+ <entry>
		58	+ <emphasis role="BOLD">@ManagedProperty</emphasis>
		59	+ </entry>
		60	+
		61	+ <entry>
		62	+ <para>Marca um atributo na classe como uma propriedade gerenciada, significando que clientes externos podem ler e/ou escrever valores nesses atributos.</para>
		63	+ <para>Um atributo marcado pode estar disponível para leitura e/ou escrita. Por padrão, o que determina a visibilidade de um atributo
		64	+ marcado é a presença dos métodos <emphasis>getAtributo</emphasis> e <emphasis>setAtributo</emphasis>, respectivamente disponibilizando o atributo
		65	+ para leitura e escrita.</para>
		66	+ <para>Para sobrescrever esse comportamento existe na anotação <emphasis role="BOLD">@ManagedProperty</emphasis> o atributo <emphasis>accessLevel</emphasis>.
		67	+ Com ele é possível criar um atributo apenas para leitura, mas que contenha um método <emphasis>set</emphasis>. O contrário também é possível.</para>
		68	+ </entry>
		69	+
		70	+ <entry>
		71	+ <itemizedlist>
		72	+ <listitem><emphasis role="BOLD">description</emphasis>: Um texto descritivo documentando o propósito da propriedade.</listitem>
		73	+ <listitem><emphasis role="BOLD">accessLevel</emphasis>: Sobrescreve o nível padrão de acesso de uma propriedade. Os valores possíveis são
		74	+ READ_ONLY, WRITE_ONLY e DEFAULT, que significa que a presença de métodos <emphasis>get</emphasis> e <emphasis>set</emphasis> vai determinar o nível de acesso.</listitem>
		75	+ </itemizedlist>
		76	+ </entry>
		77	+ </row>
		78	+
		79	+ <row>
		80	+ <entry>
		81	+ <emphasis role="BOLD">@ManagedOperation</emphasis>
		82	+ </entry>
		83	+
		84	+ <entry>
		85	+ <para>Marca um método da classe gerenciada como uma operação, o que significa que clientes externos podem invocar esse método remotamente.</para>
		86	+ <para>Operações gerenciadas normalmente são criadas para executar intervenções em um sistema já em execução. Por exemplo, é possível criar uma
		87	+ operação que, ao ser invocada, destrua todas as seções abertas no servidor e não utilizadas nos últimos 30 minutos.</para>
		88	+ </entry>
		89	+
		90	+ <entry>
		91	+ <itemizedlist>
		92	+ <listitem><emphasis role="BOLD">description</emphasis>: Um texto descritivo documentando o propósito da operação.</listitem>
		93	+ <listitem><emphasis role="BOLD">type</emphasis>: Documenta o propósito da operação. <emphasis>ACTION</emphasis> informa que a operação modificará
		94	+ o sistema de alguma forma. <emphasis>INFO</emphasis> diz que a operação coletará e retornará informações sobre o sistema. <emphasis>ACTION_INFO</emphasis>
		95	+ informa que a operação modificará o sistema de alguma forma e retornará informações sobre o resultado. <emphasis>UNKNOWN</emphasis> é o padrão
		96	+ e significa que o resultado da execução da operação é desconhecido.</listitem>
		97	+ </itemizedlist>
		98	+ </entry>
		99	+ </row>
		100	+
		101	+ <row>
		102	+ <entry>
		103	+ <emphasis role="BOLD">@OperationParameter</emphasis>
		104	+ </entry>
		105	+
		106	+ <entry>
		107	+ <para>Esta anotação opcional pode ser usada para cada parâmetro de um método anotado com <emphasis role="BOLD">@ManagedOperation</emphasis>.</para>
		108	+
		109	+ <para>Ele permite detalhar melhor parâmetros em uma operação gerenciada. O efeito desta anotação é dependente da
		110	+ tecnologia utilizada para comunicação entre cliente e servidor. Na maioria das tecnologias, essa anotação meramente permite ao cliente
		111	+ exibir informações sobre cada parâmetro: nome, tipo e descrição.</para>
		112	+ </entry>
		113	+
		114	+ <entry>
		115	+ <itemizedlist>
		116	+ <listitem><emphasis role="BOLD">name</emphasis>: O nome do parâmetro quando exibido para clientes.</listitem>
		117	+ <listitem><emphasis role="BOLD">description</emphasis>: Um texto descritivo documentando o propósito do parâmetro.</listitem>
		118	+ </itemizedlist>
		119	+ </entry>
		120	+ </row>
		121	+ </tbody>
		122	+ </tgroup>
		123	+ </informaltable>
		124	+
		125	+ </section>
		126	+
		127	+
		128	+
		129	+ <section>
		130	+ <title>Expondo aspectos de sua aplicação para monitoração</title>
		131	+
		132	+ <para>Uma vez que uma classe esteja anotada com <emphasis>@ManagementController</emphasis> e seus atributos e operações estejam expostos, a classe está pronta para
		133	+ ser monitorada.</para>
		134	+
		135	+ <para>Suponha que a aplicação deseje expor o número de usuários que efetuaram login. A operação de <emphasis>login</emphasis> será processada em
		136	+ uma classe de negócio <emphasis>ControleAcesso</emphasis>. Vamos supor também que existe uma classe chamada <emphasis>MonitorLogin</emphasis> responsável
		137	+ por expor o número de usuários que efetuaram login no sistema.</para>
		138	+
		139	+ <programlisting role="JAVA"><![CDATA[
		140	+@BusinessController
		141	+public class ControleAcesso{
		142	+
		143	+ @Inject
		144	+ private MonitorLogin monitorLogin;
		145	+
		146	+ public boolean efetuarLogin(String usuario , String senha){
		147	+ // código de login
		148	+ monitorLogin.setContadorLogin( monitorLogin.getContadorLogin() + 1 );
		149	+ }
		150	+}]]></programlisting>
		151	+
		152	+ <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á
		154	+ a quantidade de logins efetuados no momento da consulta.</para>
60	</section>	155	</section>
		156	+
		157	+ <section>
		158	+ <title>Conectando um cliente de monitoração</title>
		159	+
		160	+ <para>O <emphasis>demoiselle-core</emphasis> contém as funcionalidades necessárias para marcar aspectos monitoráveis de sua aplicação,
		161	+ mas não conta com nenhum mecanismo para estabelecer uma conexão com um cliente de monitoração. Para isso utiliza-se extensões do framework.</para>
		162	+
		163	+ <para>A extensão padrão do framework <emphasis>Demoiselle</emphasis> responsável pela tecnologia de monitoração é a <emphasis>demoiselle-jmx</emphasis>.
		164	+ Essa extensão utiliza a especificação JMX (JSR 3) e permite registrar as classes marcadas para monitoração como <emphasis>MBeans</emphasis>.
		165	+ Uma vez que as classes sejam registradas como <emphasis>MBeans</emphasis>, seus atributos e operações expostos para monitoração podem ser
		166	+ acessados via JMX por um cliente adequado, como o <emphasis>JConsole</emphasis> que acompanha por padrão o JDK da Oracle.</para>
		167	+
		168	+ <tip>
		169	+ <para>Para acrescentar a extensão <emphasis>demoiselle-jmx</emphasis> em um projeto Maven, adicione a dependência abaixo no arquivo <emphasis>pom.xml</emphasis>.</para>
		170	+
		171	+ <programlisting role="XML"><![CDATA[
		172	+<dependency>
		173	+ <groupId>br.gov.frameworkdemoiselle</groupId>
		174	+ <artifactId>demoiselle-jmx</artifactId>
		175	+ <scope>compile</scope>
		176	+</dependency>]]></programlisting>
		177	+ </tip>
		178	+
		179	+ <tip>
		180	+ <para>A API de monitoração é compatível com o uso de múltiplas extensões simultãneas. Adicione em seu projeto a dependência às extensões desejadas e configure-as
		181	+ individualmente, as classes monitoradas serão então expostas para todas as extensões escolhidas.</para>
		182	+ </tip>
		183	+
		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>
		185	+
		186	+ <programlisting role="JAVA"><![CDATA[
		187	+@ManagementController
		188	+public class BookmarkMonitor {
		189	+
		190	+ @Inject
		191	+ private BookmarkDAO bookmarkDAO;
		192	+
		193	+ @ManagedOperation(type=OperationType.INFO , description="Informa quantos bookmarks estão salvos no sistema")
		194	+ public int countSavedBookmarks(){
		195	+ return bookmarkDAO.findAll().size();
		196	+ }
		197	+}]]></programlisting>
		198	+
		199	+ <figure id="exemplo_jconsole"><title>JConsole acessando a aplicação <emphasis>Bookmark</emphasis></title>
		200	+ <mediaobject>
		201	+ <imageobject>
		202	+ <imagedata fileref="images/jmx-jconsole-example.png" width="90%" />
		203	+ </imageobject>
		204	+ <textobject><phrase>JConsole acessando a aplicação <emphasis>Bookmark</emphasis></phrase></textobject>
		205	+ </mediaobject>
		206	+ </figure>
		207	+ </section>
		208	+
61		209
62	</chapter>	210	</chapter>
63	\ No newline at end of file	211	\ No newline at end of file
	@@ -39,6 +39,7 @@		@@ -39,6 +39,7 @@
39	<xi:include href="templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />	39	<xi:include href="templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
40	<xi:include href="security.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />	40	<xi:include href="security.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
41	<xi:include href="paginacao.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />	41	<xi:include href="paginacao.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
		42	+ <xi:include href="gerenciamento.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
42	<xi:include href="properties.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />	43	<xi:include href="properties.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
43		44
44	<!-- parte 1 -->	45	<!-- parte 1 -->
	@@ -65,7 +65,6 @@ public abstract class AbstractCustomContext implements CustomContext {		@@ -65,7 +65,6 @@ public abstract class AbstractCustomContext implements CustomContext {
65	}	65	}
66		66
67	@Override	67	@Override
68	- @SuppressWarnings("unchecked")
69	public <T> T get(final Contextual<T> contextual, final CreationalContext<T> creationalContext) {	68	public <T> T get(final Contextual<T> contextual, final CreationalContext<T> creationalContext) {
70	T instance = null;	69	T instance = null;
71		70
@@ -0,0 +1,64 @@		@@ -0,0 +1,64 @@
	1	+package br.gov.frameworkdemoiselle.internal.implementation;
	2	+
	3	+import java.io.Serializable;
	4	+
	5	+import javax.enterprise.event.Event;
	6	+import javax.enterprise.util.AnnotationLiteral;
	7	+import javax.inject.Inject;
	8	+
	9	+import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEventImpl;
	10	+import br.gov.frameworkdemoiselle.internal.management.qualifier.AttributeChange;
	11	+import br.gov.frameworkdemoiselle.internal.management.qualifier.Generic;
	12	+import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;
	13	+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
	14	+import br.gov.frameworkdemoiselle.management.GenericNotification;
	15	+import br.gov.frameworkdemoiselle.management.NotificationManager;
	16	+import br.gov.frameworkdemoiselle.util.Beans;
	17	+
	18	+
	19	+@SuppressWarnings("serial")
	20	+public class NotificationManagerImpl implements NotificationManager,Serializable {
	21	+
	22	+ @Inject
	23	+ @Generic
	24	+ private Event<ManagementNotificationEvent> genericNotificationEvent;
	25	+
	26	+ @Inject
	27	+ @AttributeChange
	28	+ private Event<ManagementNotificationEvent> attributeChangeNotificationEvent;
	29	+
	30	+ /**
	31	+ * Sends a generic notification to all management clients.
	32	+ *
	33	+ * @param notification The notification to send
	34	+ */
	35	+ public void sendNotification(GenericNotification notification) {
	36	+ if (! AttributeChangeNotification.class.isInstance(notification) ){
	37	+ getGenericNotificationEvent().fire(new ManagementNotificationEventImpl(notification));
	38	+ }
	39	+ else{
	40	+ getAttributeChangeNotificationEvent().fire(new ManagementNotificationEventImpl(notification));
	41	+ }
	42	+ }
	43	+
	44	+ @SuppressWarnings("unchecked")
	45	+ private Event<ManagementNotificationEvent> getGenericNotificationEvent() {
	46	+ if (genericNotificationEvent==null){
	47	+ genericNotificationEvent = Beans.getReference(Event.class , new AnnotationLiteral<Generic>() {});
	48	+ }
	49	+
	50	+ return genericNotificationEvent;
	51	+ }
	52	+
	53	+ @SuppressWarnings("unchecked")
	54	+ private Event<ManagementNotificationEvent> getAttributeChangeNotificationEvent() {
	55	+ if (attributeChangeNotificationEvent==null){
	56	+ attributeChangeNotificationEvent = Beans.getReference(Event.class , new AnnotationLiteral<AttributeChange>() {});
	57	+ }
	58	+
	59	+ return attributeChangeNotificationEvent;
	60	+ }
	61	+
	62	+
	63	+
	64	+}
	@@ -1,65 +0,0 @@	@@ -1,65 +0,0 @@
1	-/*
2	- * Demoiselle Framework
3	- * Copyright (C) 2010 SERPRO
4	- * ----------------------------------------------------------------------------
5	- * This file is part of Demoiselle Framework.
6	- *
7	- * Demoiselle Framework is free software; you can redistribute it and/or
8	- * modify it under the terms of the GNU Lesser General Public License version 3
9	- * as published by the Free Software Foundation.
10	- *
11	- * This program is distributed in the hope that it will be useful,
12	- * but WITHOUT ANY WARRANTY; without even the implied warranty of
13	- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14	- * GNU General Public License for more details.
15	- *
16	- * You should have received a copy of the GNU Lesser General Public License version 3
17	- * along with this program; if not, see <http://www.gnu.org/licenses/>
18	- * or write to the Free Software Foundation, Inc., 51 Franklin Street,
19	- * Fifth Floor, Boston, MA 02110-1301, USA.
20	- * ----------------------------------------------------------------------------
21	- * Este arquivo é parte do Framework Demoiselle.
22	- *
23	- * O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou
24	- * modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação
25	- * do Software Livre (FSF).
26	- *
27	- * Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA
28	- * GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou
29	- * APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português
30	- * para maiores detalhes.
31	- *
32	- * Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título
33	- * "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>
34	- * ou escreva para a Fundação do Software Livre (FSF) Inc.,
35	- * 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
36	- */
37	-package br.gov.frameworkdemoiselle.internal.management;
38	-
39	-import br.gov.frameworkdemoiselle.management.Notification;
40	-import br.gov.frameworkdemoiselle.management.NotificationManager;
41	-
42	-/**
43	- * Event fired when a notification is sent by {@link NotificationManager}.
44	- * Implementators can capture this event and be notified when the {@link NotificationManager}
45	- * sends notifications, so they can pass the notification to the underlying technology.
46	- *
47	- * @author serpro
48	- *
49	- */
50	-public class ManagementNotificationEvent {
51	-
52	- private Notification notification;
53	-
54	- public ManagementNotificationEvent(Notification notification){
55	- this.notification = notification;
56	- }
57	-
58	- public Notification getNotification() {
59	- return notification;
60	- }
61	-
62	- public void setNotification(Notification notification) {
63	- this.notification = notification;
64	- }
65	-}
@@ -0,0 +1,65 @@		@@ -0,0 +1,65 @@
	1	+/*
	2	+ * Demoiselle Framework
	3	+ * Copyright (C) 2010 SERPRO
	4	+ * ----------------------------------------------------------------------------
	5	+ * This file is part of Demoiselle Framework.
	6	+ *
	7	+ * Demoiselle Framework is free software; you can redistribute it and/or
	8	+ * modify it under the terms of the GNU Lesser General Public License version 3
	9	+ * as published by the Free Software Foundation.
	10	+ *
	11	+ * This program is distributed in the hope that it will be useful,
	12	+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	+ * GNU General Public License for more details.
	15	+ *
	16	+ * You should have received a copy of the GNU Lesser General Public License version 3
	17	+ * along with this program; if not, see <http://www.gnu.org/licenses/>
	18	+ * or write to the Free Software Foundation, Inc., 51 Franklin Street,
	19	+ * Fifth Floor, Boston, MA 02110-1301, USA.
	20	+ * ----------------------------------------------------------------------------
	21	+ * Este arquivo é parte do Framework Demoiselle.
	22	+ *
	23	+ * O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou
	24	+ * modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação
	25	+ * do Software Livre (FSF).
	26	+ *
	27	+ * Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA
	28	+ * GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou
	29	+ * APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português
	30	+ * para maiores detalhes.
	31	+ *
	32	+ * Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título
	33	+ * "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>
	34	+ * ou escreva para a Fundação do Software Livre (FSF) Inc.,
	35	+ * 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
	36	+ */
	37	+package br.gov.frameworkdemoiselle.internal.management;
	38	+
	39	+import br.gov.frameworkdemoiselle.management.GenericNotification;
	40	+import br.gov.frameworkdemoiselle.management.NotificationManager;
	41	+
	42	+/**
	43	+ * Event fired when a notification is sent by {@link NotificationManager}.
	44	+ * Implementators can capture this event and be notified when the {@link NotificationManager}
	45	+ * sends notifications, so they can pass the notification to the underlying technology.
	46	+ *
	47	+ * @author serpro
	48	+ *
	49	+ */
	50	+public class ManagementNotificationEventImpl implements br.gov.frameworkdemoiselle.management.ManagementNotificationEvent {
	51	+
	52	+ private GenericNotification notification;
	53	+
	54	+ public ManagementNotificationEventImpl(GenericNotification notification){
	55	+ this.notification = notification;
	56	+ }
	57	+
	58	+ public GenericNotification getNotification() {
	59	+ return notification;
	60	+ }
	61	+
	62	+ public void setNotification(GenericNotification notification) {
	63	+ this.notification = notification;
	64	+ }
	65	+}
	@@ -43,8 +43,8 @@ import java.lang.annotation.Target;		@@ -43,8 +43,8 @@ import java.lang.annotation.Target;
43		43
44	import javax.inject.Qualifier;	44	import javax.inject.Qualifier;
45		45
46	-import br.gov.frameworkdemoiselle.internal.management.ManagementNotificationEvent;
47	import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;	46	import br.gov.frameworkdemoiselle.management.AttributeChangeNotification;
		47	+import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
48		48
49	/**	49	/**
50	*	50	*
	@@ -39,12 +39,12 @@ package br.gov.frameworkdemoiselle.management;		@@ -39,12 +39,12 @@ package br.gov.frameworkdemoiselle.management;
39	/**	39	/**
40	* Special notification to denote an attribute has changed values.	40	* Special notification to denote an attribute has changed values.
41	*	41	*
42	- * @see Notification	42	+ * @see GenericNotification
43	*	43	*
44	* @author serpro	44	* @author serpro
45	*	45	*
46	*/	46	*/
47	-public class AttributeChangeNotification extends Notification {	47	+public class AttributeChangeNotification extends GenericNotification {
48		48
49	private String attributeName;	49	private String attributeName;
50		50
@@ -0,0 +1,77 @@		@@ -0,0 +1,77 @@
	1	+/*
	2	+ * Demoiselle Framework
	3	+ * Copyright (C) 2010 SERPRO
	4	+ * ----------------------------------------------------------------------------
	5	+ * This file is part of Demoiselle Framework.
	6	+ *
	7	+ * Demoiselle Framework is free software; you can redistribute it and/or
	8	+ * modify it under the terms of the GNU Lesser General Public License version 3
	9	+ * as published by the Free Software Foundation.
	10	+ *
	11	+ * This program is distributed in the hope that it will be useful,
	12	+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	+ * GNU General Public License for more details.
	15	+ *
	16	+ * You should have received a copy of the GNU Lesser General Public License version 3
	17	+ * along with this program; if not, see <http://www.gnu.org/licenses/>
	18	+ * or write to the Free Software Foundation, Inc., 51 Franklin Street,
	19	+ * Fifth Floor, Boston, MA 02110-1301, USA.
	20	+ * ----------------------------------------------------------------------------
	21	+ * Este arquivo é parte do Framework Demoiselle.
	22	+ *
	23	+ * O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou
	24	+ * modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação
	25	+ * do Software Livre (FSF).
	26	+ *
	27	+ * Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA
	28	+ * GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou
	29	+ * APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português
	30	+ * para maiores detalhes.
	31	+ *
	32	+ * Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título
	33	+ * "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>
	34	+ * ou escreva para a Fundação do Software Livre (FSF) Inc.,
	35	+ * 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.
	36	+ */
	37	+package br.gov.frameworkdemoiselle.management;
	38	+
	39	+/**
	40	+ *
	41	+ * Notification that can be sent by the {@link NotificationManager}.
	42	+ *
	43	+ * @author serpro
	44	+ *
	45	+ */
	46	+public class GenericNotification {
	47	+
	48	+ private Object message;
	49	+
	50	+ public GenericNotification(){
	51	+ }
	52	+
	53	+ public GenericNotification(Object message) {
	54	+ super();
	55	+ this.message = message;
	56	+ }
	57	+
	58	+
	59	+ public Object getMessage() {
	60	+ return message;
	61	+ }
	62	+
	63	+
	64	+ public void setMessage(Object message) {
	65	+ this.message = message;
	66	+ }
	67	+
	68	+
	69	+ public Class<? extends Object> getType() {
	70	+ if (message!=null){
	71	+ return message.getClass();
	72	+ }
	73	+
	74	+ return null;
	75	+ }
	76	+
	77	+}