Artigo Java Magazine 70 - Aplicações Corporativas com jCompany Free – Parte 3

O jCompany Full-Stack Framework – Community & International Version, chamado resumidamente de jCompany Free, é uma versão gratuita e de código aberto (licenciada sob GPLv3) da parte framework do jCompany Developer Suite 5.1, suíte de desenvolvimento mantida pela Powerlogic SA.

O jCompany Free foi introduzido em dois artigos anteriores, publicados nas Edições 63 e 67. No primeiro discutimos fundamentos, instalação e configuração (dois itens importantes por se tratar de um framework de integração de alto nível) e fizemos o desenvolvimento de uma aplicação básica introduzindo e reutilizando o conceito de Caso de Uso Padrão “Manter Agregação Mestre/Detalhe”, para manutenção de Funcionários e seus Dependentes.

No segundo artigo apresentamos outros Casos de Uso Padrões disponíveis para reuso imediato. Implementamos uma manutenção recursiva e com visão hierárquica (Treeview) para Departamentos; fizemos uma alteração no cadastro de Funcionários para vincular Departamentos através de diálogo de seleção; implementamos exclusão lógica e regras de negócio via “programação por exceção” e ainda discutimos conceitos como caching em escopo de aplicação e Inversão de Controle por convenção de nomenclatura (Pattern Based Auto-Wiring IoC).

Neste terceiro e último artigo da série, vamos apresentar padrões de programação úteis para cenários onde não se torna possível a “programação por exceção”, ou seja, a “interceptação simples de algoritmos padrões do framework”, como fizemos com Template Method, no último artigo.

Em seguida, iremos apresentar os padrões ricos de modularização do jCompany: Módulos de Negócio e Técnicos, Camada Bridge, Plugins, etc. E, finalmente, implementaremos um primeiro jCompany Plugin como exemplo de extensão com baixíssimo acoplamento, via Design Pattern Observer já utilizando o emergente padrão Java EE 6 Web-Beans.

Programando MVC sem IoC

Nosso tutorial visa produzir uma nova funcionalidade no Caso de Uso Padrão “Manter Agregação Simples” (CRUD). Desenvolvemos este caso de uso no artigo anterior, para manter a entidade Departamento. Quem não acompanhou ou não possui disponível esta aplicação pode fazer download a partir do site da Java Magazine ou do jCompany Free.

A funcionalidade que escolhemos é denominada “Excluir com Remanejamento”. Ela prevê um novo botão na barra de ações que aciona o remanejamento de todos os funcionários contidos no departamento correntemente editado para o departamento imediatamente superior, antes de sua exclusão. Como queremos que ela conviva com a exclusão existente (que continuará a ser uma opção alternativa para o usuário) não é o caso de somente alterarmos o cenário de exclusão com “programação por exceção” – e, portanto, iremos programar um novo cenário do zero*. Lembrando do último artigo que o botão padrão faz uma “exclusão lógica” que tornava um Departamento “Inativo” – mas não se importava com os funcionários nele lotados.

Passo 1: Adicionar botão na barra de ações para o Caso de Uso “Departamento”

O Caso de Uso Padrão reutilizado para Departamento provê as ações básicas para manutenção de ciclo de vida CRUD (“Create, Retrieve, Update e Delete”), além da funções de “Clonar”, “Painel de Impressão”, “Ajuda” e formulário auxiliar para “pesquisa e seleção”, fornecidos de forma genérica pelo framework.

O jCompany Free leva a generalização ao extremo, fornecendo inclusive botões de ação padrões na camada visão. Fornece ainda “pontos de extensão” padrões também em JSPs, como o arquivo “/plc/jsps/geralAcoesComplemento.jsp”, página vazia pré-configurada na criação do projeto, representando um espaço padrão da arquitetura para conter novos botões de ação, como o que queremos. Estes botões aparecem ao lado dos botões genéricos do jCompany e de forma indistinta para o usuário, graças à arquitetura de gestão de peles e leiautes.

Vamos alterar o arquivo “/plc/jsps/geralAcoesComplemento.jsp” no projeto “javamagazine” para adicionar o botão desejado na barra de ações. A Listagem 1 apresenta o código fonte necessário.

Listagem 1. Trecho de código para inserção do botão na barra de ações

  <%@ taglib uri="/WEB-INF/plcf.tld" prefix="plcf"%> 
  <plcf:buttonAction id="botaoExcluirRemanejamento" actionPlc="excluirComRemanejamento" 
    partialSubmit="#{requestScope.ajaxUsa}" label="jcompany.evt.excluirComRemanejamento" 
    buttonArrayID="EXCLUIR_REMANEJAMENTO" 
    blocking="true"
    rendered="#{plcEntity.class eq 'class com.powerlogic.javamagazine.entity.Departamento' 
     and  plcEntity.id != null and not empty plcEntity.departamentoPai}" />

Note que a barra de ações é global, mas o botão somente irá aparecer no formulário quando a entidade principal for Departamento, o identificador da entidade não for nulo (há uma instância sendo editada) e o departamento contiver um nível superior para realocarmos os funcionários para ele.

Lembre-se de adicionar a chave de internacionalização jcompany.evt.excluirComRemanejamento ao arquivo ApplicationResources.properties com o valor “Excluir com Remanejamento”.

Passo 2: Criar classe DepartamentoAction

Como estamos criando um botão específico, será necessário um Backing Bean (Action) para receber a ação. Tipicamente um método de controle dá prosseguimento ao cenário chamando uma fachada de negócio e, posteriormente, controlando o despacho do retorno para o usuário. Esta classe deverá possuir um método excluirComRemanejamento(), em conformidade com o valor de “actionPlc” que colocamos no código do botão.

Crie a classe DepartamentoAction no pacote com.javamagazine.control.jsf, estendendo de AppAction. A classe AppAction é uma classe de arquitetura vazia para conter possíveis programações genéricas de controle, para toda a aplicação. A ...