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

Cleverson Sacramento
2 parents 857c913f 9f549bfa
Showing 40 changed files with 484 additions and 47 deletions Show diff stats
documentation/reference/pt-BR/gerenciamento.xml
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/bootstrap/ManagementBootstrap.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/context/ContextManager.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/context/CustomContext.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/context/ManagedContext.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/context/ThreadLocalContext.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/internal/implementation/ConfigurationImpl.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/Management.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/lifecycle/ManagementExtension.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/ManagedAttributeNotFoundException.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/ManagedInvokationException.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/ManagementNotificationEvent.java
impl/core/src/main/java/br/gov/frameworkdemoiselle/management/NotificationManager.java
@@ -11,7 +11,7 @@
 		<para>Ao implantar um sistema para produção, muitas vezes é necessário monitorar aspectos sobre o funcionamento desse sistema. Quanta memória
 		ele está utilizando? Qual o pico de MIPS utilizados? Quantas sessões estão autenticadas no momento?</para>
-		<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
+		<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
 		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
 		de autenticação abandonados por usuários que desligaram suas estações sem efetuar "logoff".</para>
@@ -20,8 +20,9 @@
 		<emphasis>Java Management Extension</emphasis> (JMX).</para>
 		<para>O <emphasis>Demoiselle Framework</emphasis> dispõe de uma série de ferramentas para nivelar
-		o conhecimento do desenvolvedor e facilitar o uso e integraçao de várias tecnologias de gerenciamento e monitoração. Através de seu
-		uso o desenvolvedor pode se despreocupar com detalhes de implementação de cada tecnologia individual e facilmente integrar tais tecnologias.</para>
+		o conhecimento do desenvolvedor e facilitar o uso e integraçao de várias tecnologias de gerenciamento e 
+		monitoração. Através de seu uso o desenvolvedor pode facilmente integrar tais tecnologias, despreocupando-se 
+		com detalhes de implementação de cada uma delas.</para>
 	</section>
 	<section>
@@ -35,7 +36,7 @@
 @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>Essa anotação é suficiente para o mecanismo de gerenciamento descobrir sua classe e disponibilizá-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 selecionar quais aspectos serão expostos usamos as anotações
@@ -43,7 +44,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
 		de classes anotadas com <code>@ManagementController</code>.</para>
 		<informaltable>
-			<tgroup cols="3">
+			<tgroup cols="3" rowsep="1" colsep="1">
 				<thead>
 					<row>
 						<entry>Anotação</entry>
@@ -53,7 +54,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
 				</thead>
 				<tbody>
-					<row>
+					<row valign="top">
 						<entry>
 							<emphasis role="BOLD">@ManagedProperty</emphasis>
 						</entry>
@@ -76,7 +77,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
 						</entry>
 					</row>
-					<row>
+					<row valign="top">
 						<entry>
 							<emphasis role="BOLD">@ManagedOperation</emphasis>
 						</entry>
@@ -98,7 +99,7 @@ public class GerenciadorUsuarios]]&gt;&lt;/programlisting&gt;
 						</entry>
 					</row>
-					<row>
+					<row valign="top">
 						<entry>
 							<emphasis role="BOLD">@OperationParameter</emphasis>
 						</entry>
@@ -148,6 +149,24 @@ public class ControleAcesso{
     monitorLogin.setContadorLogin( monitorLogin.getContadorLogin() + 1 );
   }
 }]]></programlisting>
+
+	<programlisting role="JAVA"><![CDATA[
+@ManagementController
+public class MonitorLogin{
+
+  @ManagedProperty
+  private int contadorLogin;
+
+  @ManagedOperation
+  public void setContadorLogin(int qtdUsuarioLogados){
+    contadorLogin = qtdUsuarioLogados;
+  }
+
+  @ManagedOperation
+  public int getContatorLogin(){
+    return contadorLogin;
+  }
+}]]></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á
@@ -181,7 +200,7 @@ public class ControleAcesso{
 			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>
+		<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
+/*
+ * 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.bootstrap;
 import java.lang.reflect.Modifier;
+/*
+ * 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.context;
 import java.lang.annotation.Annotation;
@@ -39,7 +75,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;
  * activated upon adding).
  * </p>
  * 
- * @author serpro
+ * @author SERPRO
  */
 public final class ContextManager {
+/*
+ * 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.context;
 import javax.enterprise.context.spi.Context;
+/*
+ * 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.context;
 import javax.enterprise.context.RequestScoped;
@@ -8,7 +44,7 @@ import br.gov.frameworkdemoiselle.stereotype.ManagementController;
  * Context that stores {@link RequestScoped} beans during client calls to {@link ManagementController} classes. This
  * context is only activated when no other context is active for {@link RequestScoped}.
  * 
- * @author serpro
+ * @author SERPRO
  */
 public class ManagedContext extends ThreadLocalContext {
@@ -53,7 +53,7 @@ import java.lang.annotation.Annotation;
 /**
  * Base context that has a separated store for each thread
  * 
- * @author serpro
+ * @author SERPRO
  */
 public class ThreadLocalContext extends AbstractCustomContext {
+/*
+ * 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.implementation;
 import java.io.Serializable;
+/*
+ * 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.implementation;
 import java.io.Serializable;
@@ -60,7 +60,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;
  * <p>Instances if this class are passed to each discovered management extension during bootstrap so they can have
  * enough information to expose all discovered {@link ManagementController}'s to management clients.</p>
  * 
- * @author serpro
+ * @author SERPRO
  */
 public class ManagedType {
@@ -72,7 +72,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;
  * Central class used by management extensions to obtain information, access properties and call operations over
  * discovered {@link ManagementController} classes.
  * 
- * @author serpro
+ * @author SERPRO
  */
 @ApplicationScoped
 public class Management implements Serializable {
@@ -44,7 +44,7 @@ import br.gov.frameworkdemoiselle.management.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
+ * @author SERPRO
  *
  */
 public class ManagementNotificationEventImpl implements br.gov.frameworkdemoiselle.management.ManagementNotificationEvent {
@@ -51,7 +51,7 @@ import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
  * Enables {@link ManagementNotificationEvent} observers to trigger only with notifications
  * of the specialized type {@link AttributeChangeNotification}.
  * 
- * @author serpro
+ * @author SERPRO
  *
  */
 @Qualifier
@@ -51,7 +51,7 @@ import br.gov.frameworkdemoiselle.management.GenericNotification;
  * Enables {@link ManagementNotificationEvent} observers to trigger only with notifications
  * of the base type {@link GenericNotification}.
  * 
- * @author serpro
+ * @author SERPRO
  *
  */
 @Qualifier
@@ -54,7 +54,7 @@ import br.gov.frameworkdemoiselle.stereotype.ManagementController;
  * methods at the apropriate times.
  * </p>
  * 
- * @author serpro
+ * @author SERPRO
  */
 public interface ManagementExtension {
@@ -40,7 +40,7 @@ package br.gov.frameworkdemoiselle.management;
  * Special notification to denote an attribute has changed values.
  * 
  * @see GenericNotification
- * @author serpro
+ * @author SERPRO
  */
 public class AttributeChangeNotification extends GenericNotification {
@@ -39,7 +39,7 @@ package br.gov.frameworkdemoiselle.management;
 /**
  * Notification that can be sent by the {@link NotificationManager}.
  * 
- * @author serpro
+ * @author SERPRO
  */
 public class GenericNotification {
+/*
+ * 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;
 import br.gov.frameworkdemoiselle.DemoiselleException;
@@ -7,7 +43,7 @@ import br.gov.frameworkdemoiselle.DemoiselleException;
  * Thrown when a management client tries to read or write a property, but the
  * management engine has no knowledge of an attribute with the given name. 
  * 
- * @author serpro
+ * @author SERPRO
  *
  */
 public class ManagedAttributeNotFoundException extends DemoiselleException {
+/*
+ * 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;
 import br.gov.frameworkdemoiselle.DemoiselleException;
-
+/**
+ * 
+ * Thrown In case the operation doesn't exist or have a different signature
+ * 
+ * @author SERPRO
+ *
+ */
 public class ManagedInvokationException extends DemoiselleException {
 	private static final long serialVersionUID = -1542365184737242152L;
+/*
+ * 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;
 /**
@@ -5,7 +41,7 @@ package br.gov.frameworkdemoiselle.management;
  * 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
+ * @author SERPRO
  *
  */
 public interface ManagementNotificationEvent {
@@ -59,7 +59,7 @@ import br.gov.frameworkdemoiselle.util.Beans;
  * the implementator can use qualifiers like the {@link Generic} and {@link AttributeChange} qualifiers
  * to filter what king of notifications they will handle. One example of an implementator is the <b>demoiselle-jmx</b> extension.</p>
  * 
- * @author serpro
+ * @author SERPRO
  *
  */
 @ApplicationScoped
@@ -57,7 +57,7 @@ import br.gov.frameworkdemoiselle.util.Beans;
  * Test case that simulates a management extension and tests if properties and operations on a managed class can be
  * easily accessed and invoked.
  * 
- * @author serpro
+ * @author SERPRO
  */
 @RunWith(Arquillian.class)
 public class ManagementTest {
@@ -61,7 +61,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;
 /**
  * Test the {@link NotificationManager} with a dummy extension to check if notifications are correctly propagated
  * 
- * @author serpro
+ * @author SERPRO
  */
 @RunWith(Arquillian.class)
 public class NotificationTest {
@@ -44,7 +44,7 @@ import br.gov.frameworkdemoiselle.stereotype.ManagementController;
  * 
  * Used in tests to detect if the bootstrap detects wrong annotations
  * 
- * @author serpro
+ * @author SERPRO
  *
  */
 @ManagementController
@@ -48,7 +48,7 @@ import br.gov.frameworkdemoiselle.management.NotificationManager;
 /**
  * Dummy class to test receiving of notifications sent by the {@link NotificationManager} 
  * 
- * @author serpro
+ * @author SERPRO
  *
  */
 @ApplicationScoped
@@ -51,7 +51,7 @@ import br.gov.frameworkdemoiselle.util.Beans;
  * and can read/write properties and invoke operations on them, simulating a management
  * extension like JMX or SNMP. 
  * 
- * @author serpro
+ * @author SERPRO
  *
  */
 @ApplicationScoped
@@ -2,21 +2,20 @@ package management.testclasses;
 import br.gov.frameworkdemoiselle.util.Beans;
-
 public class RequestScopeBeanClient {
-	
-	public void operationOne(){
-		
+
+	public void operationOne() {
+
 		RequestScopedClass bean = Beans.getReference(RequestScopedClass.class);
-		bean.setInfo( bean.getInfo() + "-OPERATION ONE CALLED-");
-		
+		bean.setInfo(bean.getInfo() + "-OPERATION ONE CALLED-");
+
 	}
-	
-	public void operationTwo(){
-		
+
+	public void operationTwo() {
+
 		RequestScopedClass bean = Beans.getReference(RequestScopedClass.class);
-		bean.setInfo( bean.getInfo() + "-OPERATION TWO CALLED-");
-		
+		bean.setInfo(bean.getInfo() + "-OPERATION TWO CALLED-");
+
 	}
 }
@@ -4,19 +4,15 @@ import javax.enterprise.context.RequestScoped;
 @RequestScoped
 public class RequestScopedClass {
-	
+
 	private String info = "";
-	
 	public String getInfo() {
 		return info;
 	}
-	
 	public void setInfo(String info) {
 		this.info = info;
 	}
-	
-	
 }
@@ -47,8 +47,12 @@ import java.lang.annotation.Inherited;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
+/**
+ * Used to indicate which page to redirect after the execution of some method.
+ * 
+ * @author SERPRO
+ */
-// TODO Este qualifier é realmente necessário? Verificar também na anotação PreviousView.
 @Inherited
 @Documented
 @Target({ TYPE, FIELD, METHOD, PARAMETER })
@@ -47,6 +47,11 @@ import java.lang.annotation.Inherited;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
+/**
+ * Used to indicate which page to return after the execution of some method.
+ * 
+ * @author SERPRO
+ */
 @Inherited
 @Documented
 @Target({ TYPE, FIELD, METHOD, PARAMETER })
@@ -48,6 +48,17 @@ import br.gov.frameworkdemoiselle.util.Parameter;
 import br.gov.frameworkdemoiselle.util.Reflections;
 import br.gov.frameworkdemoiselle.util.ResourceBundle;
+/**
+ * Template Managed Bean class that implements the methods defined by the interface EditPageBean.
+ * 
+ * @param <T>
+ *            bean object type
+ * @param <I>
+ *            bean id type
+ *            
+ * @author SERPRO
+ * @see EditPageBean
+ */
 public abstract class AbstractEditPageBean<T, I> extends AbstractPageBean implements EditPageBean<T> {
 	private static final long serialVersionUID = 1L;
@@ -49,7 +49,17 @@ import javax.inject.Inject;
 import br.gov.frameworkdemoiselle.pagination.Pagination;
 import br.gov.frameworkdemoiselle.pagination.PaginationContext;
 import br.gov.frameworkdemoiselle.util.Reflections;
-
+/**
+ * Template Managed Bean class that implements the methods defined by the interface ListPageBean.
+ * 
+ * @param <T>
+ *            bean object type
+ * @param <I>
+ *            bean id type
+ *
+ * @author SERPRO
+ * @see ListPageBean
+ */
 public abstract class AbstractListPageBean<T, I> extends AbstractPageBean implements ListPageBean<T, I> {
 	private static final long serialVersionUID = 1L;
@@ -42,6 +42,12 @@ import javax.inject.Inject;
 import br.gov.frameworkdemoiselle.annotation.NextView;
 import br.gov.frameworkdemoiselle.annotation.PreviousView;
+/**
+ * Template Managed Bean class that implements the methods defined by the interface PageBean.
+ * 
+ * @author SERPRO
+ * @see PageBean
+ */
 public abstract class AbstractPageBean implements PageBean {
 	private static final long serialVersionUID = 1L;
@@ -36,6 +36,15 @@
  */
 package br.gov.frameworkdemoiselle.template;
+/**
+ * Interface that defines a contract of facilities that a page with funcionalities of insert, edit and delete could implement.
+ *
+ * @param <T>
+ *            bean object type
+ *            
+ * @author SERPRO
+ * 
+ */
 public interface EditPageBean<T> extends PageBean {
 	String delete();
@@ -41,6 +41,17 @@ import java.util.Map;
 import javax.faces.model.DataModel;
+/**
+ * Interface that defines a contract of facilities that a page with the funcionality of list could implement.
+ *  
+ * @param <T>
+ *            bean object type
+ * @param <I>
+ *            bean id type
+ *
+ * @author SERPRO
+ * 
+ */
 public interface ListPageBean<T, I> extends PageBean {
 	DataModel<T> getDataModel();
@@ -38,6 +38,12 @@ package br.gov.frameworkdemoiselle.template;
 import java.io.Serializable;
+/**
+ * Interface that defines a contract of facilities that all pages could implement. 
+ * 
+ * @author SERPRO
+ * 
+ */
 public interface PageBean extends Serializable {
 	String getCurrentView();
@@ -55,6 +55,11 @@ import br.gov.frameworkdemoiselle.exception.ApplicationException;
 import br.gov.frameworkdemoiselle.message.Message;
 import br.gov.frameworkdemoiselle.message.SeverityType;
+/**
+ * Utility class to insert messages in the FacesContext.
+ * 
+ * @author SERPRO
+ * */
 public class Faces {
 	private Faces() {
@@ -43,6 +43,11 @@ import javax.faces.context.FacesContext;
 import javax.inject.Inject;
 import javax.inject.Named;
+/**
+ * Utility class to configure the Locale.
+ * 
+ * @author SERPRO
+ * */
 @Named
 public class Locales implements Serializable {
@@ -38,6 +38,12 @@ package br.gov.frameworkdemoiselle.util;
 import br.gov.frameworkdemoiselle.DemoiselleException;
+/**
+ * 
+ * Utility class that serves as the exception to be thrown when a page is not found.
+ * 
+ * @author SERPRO
+ * */
 public class PageNotFoundException extends DemoiselleException {
 	private static final long serialVersionUID = 1L;
@@ -40,6 +40,15 @@ import java.io.Serializable;
 import javax.faces.convert.Converter;
+/**
+ * 
+ * Interface that defines the methods to be implemented to get and set values on a parameter.
+ * 
+ * @param <T>
+ *            bean object type  
+ * 
+ * @author SERPRO
+ * */
 public interface Parameter<T extends Serializable> {
 	void setValue(T value);
@@ -47,6 +47,12 @@ import javax.faces.FacesException;
 import javax.faces.application.ViewHandler;
 import javax.faces.context.FacesContext;
+/**
+ * 
+ * Utility class to redirect determined page to another one.
+ * 
+ * @author SERPRO
+ * */
 public class Redirector {
 	private Redirector() {
		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	+ */
1	package br.gov.frameworkdemoiselle.internal.bootstrap;	37	package br.gov.frameworkdemoiselle.internal.bootstrap;
2		38
3	import java.lang.reflect.Modifier;	39	import java.lang.reflect.Modifier;
	@@ -53,7 +53,7 @@ import java.lang.annotation.Annotation;		@@ -53,7 +53,7 @@ import java.lang.annotation.Annotation;
53	/**	53	/**
54	* Base context that has a separated store for each thread	54	* Base context that has a separated store for each thread
55	*	55	*
56	- * @author serpro	56	+ * @author SERPRO
57	*/	57	*/
58	public class ThreadLocalContext extends AbstractCustomContext {	58	public class ThreadLocalContext extends AbstractCustomContext {
59		59
	@@ -60,7 +60,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;		@@ -60,7 +60,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;
60	* <p>Instances if this class are passed to each discovered management extension during bootstrap so they can have	60	* <p>Instances if this class are passed to each discovered management extension during bootstrap so they can have
61	* enough information to expose all discovered {@link ManagementController}'s to management clients.</p>	61	* enough information to expose all discovered {@link ManagementController}'s to management clients.</p>
62	*	62	*
63	- * @author serpro	63	+ * @author SERPRO
64	*/	64	*/
65	public class ManagedType {	65	public class ManagedType {
66		66
	@@ -72,7 +72,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;		@@ -72,7 +72,7 @@ import br.gov.frameworkdemoiselle.util.ResourceBundle;
72	* Central class used by management extensions to obtain information, access properties and call operations over	72	* Central class used by management extensions to obtain information, access properties and call operations over
73	* discovered {@link ManagementController} classes.	73	* discovered {@link ManagementController} classes.
74	*	74	*
75	- * @author serpro	75	+ * @author SERPRO
76	*/	76	*/
77	@ApplicationScoped	77	@ApplicationScoped
78	public class Management implements Serializable {	78	public class Management implements Serializable {
	@@ -44,7 +44,7 @@ import br.gov.frameworkdemoiselle.management.NotificationManager;		@@ -44,7 +44,7 @@ import br.gov.frameworkdemoiselle.management.NotificationManager;
44	* Implementators can capture this event and be notified when the {@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.	45	* sends notifications, so they can pass the notification to the underlying technology.
46	*	46	*
47	- * @author serpro	47	+ * @author SERPRO
48	*	48	*
49	*/	49	*/
50	public class ManagementNotificationEventImpl implements br.gov.frameworkdemoiselle.management.ManagementNotificationEvent {	50	public class ManagementNotificationEventImpl implements br.gov.frameworkdemoiselle.management.ManagementNotificationEvent {
	@@ -51,7 +51,7 @@ import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;		@@ -51,7 +51,7 @@ import br.gov.frameworkdemoiselle.management.ManagementNotificationEvent;
51	* Enables {@link ManagementNotificationEvent} observers to trigger only with notifications	51	* Enables {@link ManagementNotificationEvent} observers to trigger only with notifications
52	* of the specialized type {@link AttributeChangeNotification}.	52	* of the specialized type {@link AttributeChangeNotification}.
53	*	53	*
54	- * @author serpro	54	+ * @author SERPRO
55	*	55	*
56	*/	56	*/
57	@Qualifier	57	@Qualifier
	@@ -54,7 +54,7 @@ import br.gov.frameworkdemoiselle.stereotype.ManagementController;		@@ -54,7 +54,7 @@ import br.gov.frameworkdemoiselle.stereotype.ManagementController;
54	* methods at the apropriate times.	54	* methods at the apropriate times.
55	* </p>	55	* </p>
56	*	56	*
57	- * @author serpro	57	+ * @author SERPRO
58	*/	58	*/
59	public interface ManagementExtension {	59	public interface ManagementExtension {
60		60
	@@ -40,7 +40,7 @@ package br.gov.frameworkdemoiselle.management;		@@ -40,7 +40,7 @@ package br.gov.frameworkdemoiselle.management;
40	* Special notification to denote an attribute has changed values.	40	* Special notification to denote an attribute has changed values.
41	*	41	*
42	* @see GenericNotification	42	* @see GenericNotification
43	- * @author serpro	43	+ * @author SERPRO
44	*/	44	*/
45	public class AttributeChangeNotification extends GenericNotification {	45	public class AttributeChangeNotification extends GenericNotification {
46		46
	@@ -39,7 +39,7 @@ package br.gov.frameworkdemoiselle.management;		@@ -39,7 +39,7 @@ package br.gov.frameworkdemoiselle.management;
39	/**	39	/**
40	* Notification that can be sent by the {@link NotificationManager}.	40	* Notification that can be sent by the {@link NotificationManager}.
41	*	41	*
42	- * @author serpro	42	+ * @author SERPRO
43	*/	43	*/
44	public class GenericNotification {	44	public class GenericNotification {
45		45
	@@ -59,7 +59,7 @@ import br.gov.frameworkdemoiselle.util.Beans;		@@ -59,7 +59,7 @@ import br.gov.frameworkdemoiselle.util.Beans;
59	* the implementator can use qualifiers like the {@link Generic} and {@link AttributeChange} qualifiers	59	* the implementator can use qualifiers like the {@link Generic} and {@link AttributeChange} qualifiers
60	* to filter what king of notifications they will handle. One example of an implementator is the <b>demoiselle-jmx</b> extension.</p>	60	* to filter what king of notifications they will handle. One example of an implementator is the <b>demoiselle-jmx</b> extension.</p>
61	*	61	*
62	- * @author serpro	62	+ * @author SERPRO
63	*	63	*
64	*/	64	*/
65	@ApplicationScoped	65	@ApplicationScoped