Arquitetura
Padrões técnicos
A implementação do Portal de Serviços é guiada por três padrões de desenho e construção de aplicações para a Web:
Visão Geral
Portal
Model-View-Controller
Apresentação (View)
Os templates HTML 5 estão em src/main/resources/templates. Configuramos o Thymeleaf para tratar tanto arquivos HTML (*.html) quanto XML (*.xml) neste diretório como templates.
Controladores
Controlam a interação entre usuário e aplicação. Contém componentes responsáveis pela lógica de apresentação da aplicação e tem as responsabilidades de capturar dados, apresentar os resultados e controlar a navegação.
No mesmo nível estão os serviços expostos pela aplicação para interagir com outras aplicações.
Por convenção, Controllers são nomeados com o sufixo Controller e anotados com org.springframework.stereotype.Controller ou org.springframework.web.bind.annotation.RestController.
Modelos e objetos de domínio
Contém informações sobre o domínio do negócio, e mantém os objetos de negócio. Estão anotadas com lombok.Value (tornando-as imutáveis). Diversos objetos de domínio possuem anotações relacionadas a indexação e persistência no ElasticSearch.
Outros componentes
Coordenam atividades diversas da aplicação. Estão anotados com o estereótipo org.springframework.stereotype.Component.
Editor
Model-View-Controller
Apresentação (View)
Os templates HTML 5 estão em src/main/resources/templates. Configuramos o Thymeleaf para tratar tanto arquivos HTML (*.html) quanto XML (*.xml) neste diretório como templates.
As demais páginas HTML estão em src/main/javascript e são geradas dinamicamente ultilizando Mithril.js 0.2.x e RequireJS 2.1.19.
Controladores
Controlam a interação entre usuário e aplicação. Contém componentes responsáveis pela lógica de apresentação da aplicação e tem as responsabilidades de capturar dados, apresentar os resultados e controlar a navegação.
No mesmo nível estão os serviços expostos pela aplicação para interagir com outras aplicações.
Por convenção, Controllers são nomeados com o sufixo Controller e anotados com org.springframework.stereotype.Controller ou org.springframework.web.bind.annotation.RestController.
Modelos e objetos de domínio
Contém informações sobre o domínio do negócio, e mantém os objetos de negócio. Os objetos são separados em 2 (dois) grupos:
- Objetos anotados com
javax.persistence.Entityque são POJOS e representam entidades do banco de dados. - Objetos anotados com
javax.xml.bind.annotation.XmlRootElementque são objetos XML e representam entidades do repositório de cartas de serviço.
Outros componentes
Coordenam atividades diversas da aplicação. Estão anotados com o estereótipo org.springframework.stereotype.Component.