Skip to content

Manual do Desenvolvedor – Exercício JButler

Vítor E. Silva Souza edited this page Jun 5, 2020 · 7 revisions

Instaladas as ferramentas de desenvolvimento, sugerimos que os desenvolvedores envolvidos no Marvin sigam o tutorial do JButler. Seguir este tutorial fará com que você, caso já não conheça, tenha contato com algumas tecnologias Jakarta EE utilizadas no Marvin (JPA, CDI, JSF), organizadas em uma arquitetura padrão que é a mesma utilizada no Marvin e com apoio de uma biblioteca de componentes chamada JButler.

Antes, porém, algumas explicações. Em primeiro lugar, o tutorial JButler é em inglês. Caso isso seja um problema entre em contato com o coordenador do projeto.

O tutorial começa com instalação das ferramentas de desenvolvimento, possivelmente em versões diferentes das utilizadas neste manual. Não é necessário instalar novamente as ferramentas nas versões indicadas no tutorial, utilize as versões homologadas para o Marvin mesmo (caso tenha problemas, entre em contato com o coordenador do projeto). Sendo assim, comece o tutorial do item Database creation and set-up.

No momento da escrita desta página do manual, o tutorial JButler inclui, além da instalação e configuração das ferramentas, a criação de um projeto Web novo no Eclipse usando o Maven, o uso de um leiaute visual pronto via AdminFaces, internacionalização da aplicação e a implementação de uma funcionalidade simples de cadastro (CRUD -- Create, Retrieve, Update, Delete). Todos estes passos já foram feitos no Marvin, mas fazê-los do zero vai permitir que você entenda melhor como funcionam, bem como capacitá-lo a criar um novo cadastro (CRUD) caso o módulo que você vai desenvolver exija isso (muito importante: não tente resolver tudo com CRUDs, isso gera sistemas pobres! CRUDs são geralmente adequados apenas para o administrador do sistema). É possível também que o tutorial do JButler seja atualizado com novos passos, sempre interessante executá-los até o final.

Falando em Maven, AdminFaces e outras tecnologias mencionadas no tutorial, caso você não tenha familiaridade com elas, apesar de não ser essencial (visto que elas já foram configuradas no Marvin), é interessante conhecer mais sobre elas assim que você tiver um tempo.

Feitas todas as explicações necessárias, siga para o tutorial utilizando o link abaixo:

↗️ Tutorial JButler, pulando a instalação das ferramentas

Problemas com o tutorial?

Algumas instruções do tutorial naturalmente devem ser adaptadas por conta de possíveis versões diferentes de ferramentas utilizadas. Ainda assim, talvez as instruções do tutorial não surtam o resultado esperado. Caso isso aconteça, entre em contato com o coordenador do projeto, para que sejam incluídas formas de contornar o problema:

  • Após os ajustes no projeto recém-criado, alguns erros continuam: na parte 1, após o projeto ser criado o tutorial elenca 10 instruções de ajuste para atualizar as tecnologias e resolver eventuais erros, porém alguns errors persistem após o último passo. Abra a visão Markers, selecione os erros e apague-os (basta usar a tecla Delete ou clicar com o botão direito e selecionar Delete). Em seguida, continue o tutorial normalmente.

↘️ Após a conclusão do tutorial, retorne para o manual para seguirmos, finalmente, para a obtenção do código do Marvin e execução em sua máquina.

➡️ Implementação: obtenção do código e execução do Marvin

⬆️ Voltar ao índice