JCommerce
Facilitando a confecção de páginas JSP
Manual Versão 0.01
A idéia para a construção desta ferramenta envolve a concepção de um gerador para
padronizar as etapas normalmente repetitivas de um projeto J2EE com JSP que segue o
seguinte escopo para suas páginas de cadastro:
janIE – Páginas para Edição da Inclusão
Esta tela está dividida em duas partes. A primeira contém o formulário para a inclusão dos
registros e um botão para submeter este formulário. Na segunda parte, são mostrados todos os
registros que já foram cadastrados no formato de uma tabela, e em cada linha monta uma
chamada para os processos de modificação e eliminação dos registros.
janIC – Páginas Conclusão da Inclusão
Montará, através dos dados enviados pelo formulário da janIE, o comando INSERT para a
inclusão dos registros será realizado através de uma chamada ao Bean do projeto.
janAE – Páginas para Edição da Alteração
A partir do link Alt pelo formulário da janIE que conterá em sua href o valor da chave primária,
montado da seguinte maneira: <A HREF="jan03.jsp?cod=001">, que fará uma pesquisa no
banco de dados localizando os demais campos para a montagem de um formulário.
janAC – Páginas para Conclusão da Alteração
Montará, através dos dados enviados pelo formulário da janAE, o comando UPDATE para a
alteração dos registros será realizado através de uma chamada ao Bean do projeto.
janEC – Páginas para Conclusão da Exclusão
A partir do link Exc pelo formulário da janIE, que conterá em sua href o valor da chave primária,
montado da seguinte maneira: <A HREF="jan05.jsp?cod=001">, que montará o comando
DELETE eliminando o registro selecionado será realizado através de uma chamada ao Bean do
projeto.
Instalação e Passos iniciais
O arquivo do JCommerce é disponibilizado através de um único arquivo compactado no
padrão ZIP, neste serão encontrados, uma estrutura padrão com todos os arquivos
necessários e o arquivo jCommerce.jar.
A estrutura padrão ao ser descompactada seguirá a seguinte formação:
->
->
->
->
->
->
->
->
->
->
pasta inicial com as suas páginas em .jsp e .html
contém os arquivos com extensão .css
imagens do sistema
aquivos do tipo JavaScript
pacote do seu projeto contendo os beans
pasta padrão
arquivos servlets
arquivos de complementação
bean do sistema (arquivos .jar)
arquivo de configuração para as JSTL
Os arquivos contidos na pasta JSPF, podem ser obtidos copiando o código gerado
automaticamente através da opção JSPF.
Com o WebServer (por exemplo o TomCat) você poderá criar um contexto apontando
este para a pasta inicial do seu projeto. O menu do sistema por enquanto deixo por sua
conta, existem planos futuros para gerá-lo automaticamente.
Este software foi criado totalmente em Java, para executá-lo é necessário que a JVM
deste (mínimo J2SE versão 1.4.2 RT) esteja instalada e configurada corretamente, uma
vez isto feito execute o seguinte comando em uma janela de terminal:
java -jar jCommerce.jar
Será mostrada a seguinte janela:
Configurações Básicas do Sistema
Para começar a utilizar primeiramente selecione a opção Auxílio | Configurações, nesta
você deverá definir as seguintes propriedades:
Tabela: nome da tabela que será realizado o cadastro
Sigla Sist.: Sigla do Sistema para a montagem do nome das páginas que
seguirá o padrão – Sigla + [IE|IC|AE|AC|EC] + nome página.
• Pacote: Nome do pacote para referência no bean
• Nome Pág.: Nome da página para a composição do nome.
•
•
Ao definir estas pressione o botão gravar, em seguida selecione a opção Auxílio | Cores
do Sistema, defina a cor padrão para a janela mudando as opções de Cor (conforme a
tabela), percentual de brilho e saturação. Para manter uma padronização de todas as
páginas um arquivo no formato CSS será gerada baseada nas cores definidas pelo
usuário.
Uma Tabela, Um Projeto
Para o JCommerce cada tabela corresponde a um projeto, este pode ser salvo e aberto
para novas modificações e gerações futuras. Este controle se faz com a opção Arquivo |
Projeto.
Acesse a opção Arquivo | Definição dos Campos, nesta deverá ser inseridos todos os
campos da tabela, com a seguinte definição:
Nome: nome do campo para aparecer na página.
Code: nome do campo real na tabela.
Tipo: formato do campo, sendo:
date: campo tipo data.
int: campo número inteiro.
logical: campo tipo lógico (padrão inteiro 0 e 1).
string: campo tipo char ou varchar.
text: campo string long. Ex: varchar(300)
Tamanho: tamanho do campo que deverá aparecer na página.
Máximo: tamanho do campo conforme a tabela.
Visível: se o campo deverá ser mostrado na página.
Chave: se o campo é chave primária da tabela.
As opções são:
Limpar: remove todas as definições do campo.
Excluir: elimina o campo selecionado no quadro
Incluir: insere o campo no quadro
Subir: sobe uma posição no quadro do campo selecionado
Descer: desce uma posição no quadro do campo selecionado
Ao terminar o cadastro dos campos da tabela, caso haja necessidade ainda é possível a
alteração dos mesmos no quadro, está pronto para ser feita a geração das páginas, estas
podem ser feitas uma a uma, ou todas de uma só vez.
Fernando Anselmo