Módulo de negócio e/ou software
Na concepção da arquitetura do VSet Chameleon, módulo é um grupo de componentes de negócios e/ou software que atende a um assunto bem definido.
Para criar um módulo, vamos utilizar Eclipse como IDE para o desenvolvimento de classes de negócios e/ou software. Poderá fazer também em outros IDE de Java.
Partindo na premissa que Eclipse IDE1 esteja instalado na sua máquina.
Nota: Sua versão do Eclipse poderá ser diferente que está na documentação. No entanto todos têm a opção de criar projeto e palheta do Ant.
Instalando ambiente de desenvolvimento VSet Chameleon
Foi criado uma estrutura VSet Chameleon para desenvolvimento. Baixar última versão do instalador conforme sistema operacional (Windows e Linux) e seguir as instruções no README.TXT. Deverá instalar a versão JRE de acordo com as instruções do README.TXT.
Criando um novo módulo no Eclipse IDE
Para criar o módulo do VSet Chameleon no Eclipse, selecione File -> New -> Java Project conforme a figura 1. Informe o nome do projeto (no exemplo CRM) e finaliza.
Após da criação do projeto do Eclipse, a estrutura do módulo ficará da seguinte forma:
Para concluir, deverá configurar Java Build Path importando as seguintes bibliotecas a saber:
\VSetChameleon\bin\startup.jar
\lib\vsetchameleon-common-core-1.4.2.jar
\lib\vsetchameleon-common-generatorcode-1.0.0.jar
JRE System Library [jre1.8.0_202]
Nota: Ao decorrer do tempo poderão ter outras bibliotecas ou versões diferentes além do que foram citadas acima.
Para execução do módulo é necessário também configurar Run Configurations -> Java Application e selecionar a Main Class com.vicax.vset.chameleon.core.startup.Main.
Dica: Na instalação do ambiente de desenvolvimento VSet Chameleon, é criado o módulo HelloWorld como exemplo. Para obter módulo, seleciona a opção do IDE de importar o projeto que estará na pasta ../workspace/HelloWorld.
Configurando o arquivo build.xml (Automação de processo de compilação e empacotamento)
VSet Chameleon criou o script build.xml2: para automação de compilação e empacotamento das classes de negócio/software do módulo.
Script build.xml é executado pela ferramenta Apache Ant3:
Segue abaixo o excerto build.xml
<project name="CRM" default="main" basedir=".">
...
<property name="jar.name" value="crm" />
<property name="vendor.code" value="VICAX" />
<property name="module.code" value="crm" />
<property name="module.prefix" value="CRM" />
<property name="module.version" value="1.0.1" />
<property name="vendor.name" value="Vicax Tecnologia e Gestão" />
<property name="module.name" value="CRM" />
<property name="module.description" value="Customer Relationship Management" />
<property name="built.by" value="Vicax Tecnologia e Gestão" />
...
</project>
- project name - Nome do projeto (módulo - VSet Chameleon)
- property name="jar.name" - Nome do jar do módulo
- property name="vendor.code" - Código do fornecedor do módulo
- property name="module.code" - Código do módulo
- property name="module.prefix" - Prefixo do módulo
- property name="module.version" - Versão do módulo
- property name="vendor.name" - Nome do fornecedor do módulo
- property name="module.name" - Nome do módulo
- property name="module.description" - Descrição do módulo
- property name="built.by" - Empresa ou pessoa responsável (proprietário) do módulo
Script build.xml deverá está na raiz do projeto conforme figura 5.
- src - Diretório classes de negócio/software do módulo
- dist - Diretório dos arquivos jar do módulo
Instalando build.xml na paleta Ant do Eclipse
Para instalar build.xml na paleta Ant do Eclipse, selecione Windows -> Show View -> Ant
Adiciona no buildFiles da paleta Ant o script build.xml.
Após da inclusão script build.xml na paleta Ant, aparecerá as ações conforme a figura 7.
- clean - Remove todos os arquivos que fazem parte do empacontamento do módulo
- compile - Compila as classes de negocio/software do módulo
- debug - Debugar a execução do código
- explode - Compila e faz deploy do módulo na estrutura do VSet Chameleon
- generatorApi - Gera a documentação das api´s das classes de negocio/software do módulo
- generatorNgDx - Gera a estrutura de dados das api´s das classes de negocio/software do módulo para interface
- jar - Empacota as classes de negocio/software do módulo
- makedir - Cria diretório para os arquivos do módulo
- reexplode - Remove os arquivos do módulo da versão anterior (unexplode) e publica nova versão (explode)
- run - Cria a instancia do VSet Chameleon para execução do módulo
- unexplode - Remove os arquivos do módulo da versão corrente
Compilando o módulo
Para compilar o módulo, selecione a ação compile na palheta do Ant.
Empacotando o módulo
Para empacotar o módulo, selecione a ação jar na palheta do Ant. Após da execução do empacotamento, o arquivo jar do módulo estará disponível na pasta dist da palheta do projeto conforme da figura 5
Nota: Ação explode executa as ações de compile e jar.
FAQ (Frequently Asked Questions)
Criei o módulo e quando fui compilar o projeto/módulo gerou este erro "Specified VM install not found: type Standard VM, name"Verificar se está configurado JVM corretamente no projeto. Se está configurado JVM corretamente e continua o problema, remover o arquivo nome_seu_projeto build.xml.launch do projeto/módulo no diretório /workspace/.metadata/.plugins/org.eclipse.debug.core/.launches. Exemplo: nome do seu projeto é CRM então nome do arquivo será CRM build.xml.launch.
Posso criar mais de um projeto/módulo no workspace do ambiente de desenvolvimento VSet Chameleon?Nota: Essas instruções são para Eclipse IDE.
Sim. Você pode criar vários projetos/módulos do mesmo workspace. Lembrando que cada criação de projeto/módulo deverá fazer a configuração para funcionar.
Nota: Essas instruções são para Eclipse IDE.