Regras de mapeamento de aplicativo Java
Índice |
Antes de começar
As informações contidas neste artigo se referem ao uso dos mapeamentos em painéis de controle Java como Spring Boot Standalone e Servidores Java da Integrator.
O deploy e acesso feitos através do uso de servidores Java
Servidores Java como Tomcat, podem possuir diversos aplicativos. No geral, cada servidor Java possui um modo de configurar a raiz do serviço ou ter vários aplicativos.
Por exemplo, o Tomcat, podemos ter as seguintes formas de se colocar um aplicativo para acesso:
1. Na raiz: pode ser feita por configurações ou fazendo o deploy de ROOT.war/ROOT em webapps.
2. Múltiplos aplicativos: Subindo cada um no painel com um nome, onde o acesso se faz por /NOME_DO_APLICATIVO. Esse modo é mais simples, pois se subir o Aplicativo.war no diretório webapps, logo se obtém o acesso com /Aplicativo. O mesmo sendo feito através do nosso painel Integrator Java EE.
O deploy e acesso feitos através do uso de Spring Boot Standalone
Diferente do servidor Java, o Spring Boot Standalone é um JAR executável. Dessa forma, ele serve, internamente por um Tomcat, as rotas que o desenvolvedor definiu. O painel da Integrator para deploy do Spring Boot Standalone apenas o configura para executar em modo daemon, ou seja, como um processo. As regras de acesso ao aplicativo partem da premissa inicial que raiz, ou simplesmente "/". Dessa forma, ao chamar o aplicativo, se encontra o resultado esperado partindo do /ALGUMA_COISA.
Como funciona o mapeamento nos painéis Integrator
Devido a flexibilidade dos painéis Integrator em mapear o serviço Java no domínio, o usuário pode se confundir. Abaixo as duas possibilidades:
1. Através da raiz, partindo do princípio que o seu aplicativo roda como ROOT no servidor Java ou é assim configurado no Spring Boot Standalone;
2. Através de um nome, começando com /, seguido do nome do aplicativo. Dessa forma, se fizer o deploy no servidor Java com o nome de Sistema.war, por exemplo, acessará com /Sistema.
Os erros comuns para mapeamento do acesso pelo domínio
No momento que for mapear o aplicativo no painel de controle, esteja certo da forma como foi feito o deploy, ou seja, quem desenvolveu sabe exatamente como deve acessar. Como deve ser feito:
1. Se estiver subindo em um servidor Java, esteja certo que está da forma que deseja: / (raiz) ou /Aplicativo. Dessa forma, se estiver em raiz, ou seja, é o ROOT do servidor Java, o conteúdo aparece assim que colocar o nome do domínio: https://seudominio.com. Caso seja /Aplicativo, então o conteúdo surgirá apenas quando acessar https://seudominio.com/Aplicativo.
2. Se estiver subindo em um modo Standalone com Spring Boot, o mapeamento depende de como você definiu a rota no aplicativo. Se for raiz, o padrão, precisa manter / para que ao acessar https://seudominio.com o conteúdo apareça. Caso queira que seja /Aplicativo, precisa fazer o mapeamento no Spring Boot iniciar com /Aplicativo. Lembre-se: o Spring Boot Standalone é você quem define as rotas, não um servidor Java com suas regras.
3. Usar um servidor Java e Spring Boot Standalone no mesmo domínio. Esse erro é comum, pois o usuário espera experimentar ambos, mas infelizmente, com apenas um domínio e com um limite de portas. O ideal é colocar cada qual em um domínio diferente, pode ser subdomínio. O segundo erro é determinar a mesma porta que o servidor Java usa e, infelizmente, diferente do Spring Boot onde o usuário pode usar apenas 1 por vez, o Tomcat usa várias de uma só vez, e todas as que estão disponíveis para o usuário, visíveis apenas no painel Spring Boot Standalone.
Boas práticas
1. Procure não misturar servidor Java com Spring Boot Standalone no mesmo domínio e serviço, pois no geral, pode ter conflitos de mapeamento e porta.
2. Antes de configurar um mapeamento, esteja certo que é assim que foi configurado ou feito o deploy.
3. Verifique se existem recursos do seu plano para subir muitos aplicativos, sobrecarregando o serviço e o tornando indisponível.
