Visão Geral

O Apache Tomcat é um servidor de aplicações e contêiner de Servlets Java de código aberto. Ele implementa as especificações Jakarta Servlet, Jakarta Expression Language e WebSocket, permitindo a execução de aplicações web baseadas em Java. Este guia aborda a implantação e configuração básica em um ambiente Windows.

Instalação do Servidor

Inicie baixando a distribuição binária do Tomcat a partir do site oficial do Apache Tomcat. Para um ambiente de desenvolvimento, a versão mais recente do ramo estável é recomendada.

Após o download, extraia o conteúdo do arquivo compactado (por exemplo, um arquivo ZIP) para o diretório de instalação desejado, como C:\Servidores\tomcat.

Para facilitar a execução dos comandos a partir de qualquer local no terminal, adicione o caminho completo do subdiretório bin do Tomcat à variável de ambiente PATH do sistema. Isso pode ser feito através das Propriedades do Sistema.

Inicialização e Gerenciamento do Serviço

Existem duas abordagens principais para gerenciar o ciclo de vida do servidor Tomcat no Windows.

Execução via Terminal (CMD)

Abra um prompt de comando, navegue até o diretório bin da instalação do Tomcat e execute o script startup.bat. O servidor será iniciado, exibindo logs de inicialização no console. Para interromper o servidor, execute o script shutdown.bat no mesmo diretório.

Instalação como Serviço do Windows

Para integração mais profunda com o sistema operacional, é possível instalar o Tomcat como um serviço do Windows. A partir do diretório bin da instalação, utilize o comando service.bat install. Após a instalação, o serviço do Tomcat pode ser gerenciado (iniciar, parar, reiniciar) através do snap-in services.msc do Windows. Essa abordagem é ideal para ambientes de produção, pois permite a inicialização automáticca junto com o sistema operacional.

Implantação de Aplicações Web

O Tomcat oferece múltiplos mecanismos para implantar aplicações Java EE (agora Jakarta EE).

Deploy via Diretório webapps

O método mais direto consiste em copiar o arquivo empacotado da aplicação (um arquivo .WAR) para o diretório webapps localizado na raiz da instalação do Tomcat. O servidor detectará automaticamente o novo arquivo, o descompactará e disponibilizará a aplicação. Por exemplo, um arquivo chamado loja-virtual.war ficará acessível, após a implantação, no caminho http://localhost:8080/loja-virtual.

Deploy via Configuração no server.xml

Para ter controle mais granular sobre o caminho do contexto e o local físico dos recursos da aplicação, pode-se adicionar um elemento <Context> dentro do host correspondente no arquivo de configuração conf/server.xml.

<Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">

    <Context path="/acesso-loja" docBase="C:/projetos/loja-virtual-distribuicao" reloadable="true"/>

</Host>

No exemplo acima, a aplicação no caminho físico C:/projetos/loja-virtual-distribuicao será acessível via /acesso-loja. O atributo reloadable="true" habilita a recarga automática quando classes são alteradas.

Deploy via Manager Application

O Tomcat inclui uma interface web de gerenciamento, acessível em http://localhost:8080/manager/html. Para utilizá-la, é necessário configurar um usuário com a role manager-gui no arquivo conf/tomcat-users.xml.

<tomcat-users>
    <user username="admin" password="s3nh4_segur4" roles="manager-gui"/>
</tomcat-users>

Após a autenticação, é possível fazer o upload de um arquivo .WAR diretamente pelo navegador e iniciar, parar ou remover a aplicação implantada.

Configurações Essenciais

Ajuste da Porta de Conexão HTTP

A porta padrão do conector HTTP é 8080. Para alterá-la, edite o elemento Connector no arquivo conf/server.xml.

<Connector port="9090" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />

Portas privilegiadas (abaixo de 1024, como 80) requerem que o processo seja iniciado com permissões elevadas (Administrador) no Windows.

Configuração de Hosts Virtuais

Para hospedar múltiplos domínios em uma única instância do Tomcat, configure hosts virtuais no server.xml.

<Engine name="Catalina" defaultHost="localhost">

    <Host name="www.sitealpha.com.br" appBase="webapps_alpha"
          autoDeploy="true">
        <Alias>sitealpha.com.br</Alias>
    </Host>

    <Host name="www.sitebeta.com.br" appBase="webapps_beta"
          autoDeploy="true">
        <Alias>sitebeta.com.br</Alias>
    </Host>

    <Host name="localhost" appBase="webapps"></Host>

</Engine>

Cada Host deve apontar para seu próprio diretório appBase onde as aplicações específicas daquele domínio serão depositaads.

Personalização dos Logs

O comportamento de logging é controlado pelo arquivo conf/logging.properties. Você pode alterar o nível de severidade dos logs registrados no console modificando a propriedade:

java.util.logging.ConsoleHandler.level = CONFIG

Os níveis disponíveis são: SEVERE, WARNING, INFO, CONFIG, FINE, FINER e FINEST.

Integração com IDEs

No Eclipse (com plugin Web Tools Platform)

Na perspectiva Servers, crie um novo servidor e selecione a versão adequada do Apache Tomcat. Aponte para o diretório de instalação do Tomcat que você configurou. Após associar seu projeto Dynamic Web Project a este servidor, você pode iniciar, depurar e publicar alterações diretamente pela IDE.

No IntelliJ IDEA

Crie uma nova Run/Debug Configuration do tipo Tomcat Server. Especifique o caminho para a instalação do Tomcat na aba Server. Na aba Deployment, adicione seu artifact (geralmente um exploded WAR) e defina o Application Context. A IDE controlará o ciclo de vida completo do servidor para fins de desenvolvimento.