Quando o servidor de teste requer reinicialização

Os subtópicos a seguir descrevem diferentes situações nas quais você pode precisar reiniciar o servidor.

No ambiente de desenvolvimento, você pode desejar mudar um aplicativo enquanto ele está em execução em um servidor, por exemplo, se você estiver depurando um aplicativo em um servidor. Em alguns casos, é possível recarregar dinamicamente o código modificado sem reiniciar o servidor. Você pode perder o estado do programa, dependendo do tipo de recurso que é modificado e do tipo de servidor.

Quando um aplicativo está em execução em um servidor e você muda o código, a Java™ Virtual Machine continua executando o código inicial até que o código seja recarregado automaticamente ou manualmente. Por exemplo, você pode modificar a origem de JSP e as mudanças serão recarregadas automaticamente no servidor. Para outros recursos, tais como classes Java que estão em execução no Tomcat, você deve reiniciar o servidor para assegurar que as mudanças sejam reconhecidas pelo servidor.

Mudanças na configuração do servidor

Se você mudar o servidor ou a configuração do servidor enquanto o servidor está em execução, por exemplo, se você mudar o número da porta, precisará reiniciar o servidor.

Mudanças em JSP, HTML, gráfico e arquivos que não são Java

Quaisquer mudanças feitas em seu JSP, HTML, GIF, JPG, ou um arquivo de recursos semelhante; quando você salva o arquivo enquanto o servidor está em execução, você deve publicar o aplicativo no servidor. Emitir uma publicação é especialmente importante se as mudanças no arquivo de recursos são um recurso vinculado, que podem ser arquivos ou pastas armazenados em localizações no sistema de arquivos fora da área de trabalho. As mudanças em recursos vinculados não podem ser detectadas pelo ambiente de trabalho ou pelo servidor pois as mudanças aconteceram fora da área de trabalho.

Para publicar o aplicativo no servidor, se a caixa de seleção Publicar automaticamente ao iniciar servidores (disponível a partir da página Janela > Preferências > Servidor > Ativação) estiver ativada, você poderá esperar o intervalo de publicação automático passar. No entanto, se a caixa de seleção Publicar automaticamente ao iniciar servidores estiver desmarcada, você deverá publicar manualmente seu aplicativo (clique com o botão direito no servidor na visualização Servidores e selecione Publicar). Após a publicação ser concluída, atualize o navegador da web para que o servidor reconheça as mudanças. O estado do aplicativo não será perdido.
Dica: A qualquer momento durante o desenvolvimento, se você observar que a mudança em um recurso estático não foi atualizada no servidor e a caixa de seleção Publicar automaticamente ao iniciar servidores estiver desmarcada, tente executar uma publicação manual clicando com o botão direito no servidor na visualização Servidores e selecione Publicar. Após a publicação ser concluída, atualize o navegador da web e as mudanças serão atualizadas no servidor.

Para obter mais informações sobre publicação automática ou manual no servidor, veja o tópico Publicando seu aplicativo.

Mudanças em servlets e classes relacionadas

Se você mudar um servlet e salvar o arquivo enquanto o servidor está em execução, o servlet será recarregado, se você ativar o recarregamento para esse aplicativo. Quando o servidor executa a substituição do método a quente1, as mudanças ocorrem automaticamente sem precisar atualizar o navegador. O servidor reconhece a mudança ao publicar o aplicativo no servidor. Se você atualizar o navegador da web, o estado do aplicativo não será perdido.

Para publicar o aplicativo no servidor, você pode aguardar que o intervalo da publicação automática passe ou publicar seu aplicativo manualmente (clique com o direito no servidor na visualização Servidores e selecione Publicar). Para obter mais informações sobre publicação automática ou manual no servidor, consulte o tópico Publicando seu Aplicativo. Os dados da sessão para esse projeto são perdidos, mas o estado de outros projetos dentro do aplicativo fica inalterado. É possível reiniciar o projeto a partir do menu na visualização do Navegador. Se você estiver executando o Tomcat e não tiver ativado o recurso de recarregamento, será necessário reiniciar o servidor.

Para o WebSphere Application Server, as regras também se aplicam a quaisquer classes dependentes ou descritores de implementação do projeto da web. Se você modificar as propriedades de configuração de segurança ou de login do descritor de implementação web.xml que está em execução no WebSphere Application Server, será necessário reiniciar o servidor. Para o Tomcat, um reinício do servidor é necessário para qualquer uma dessas mudanças.

Incluindo servlets, classes ou arquivos JSP

Se você incluir um servlet, classe dependente ou arquivo JSP em um projeto da web enquanto o servidor está em execução, as mudanças serão reconhecidas se você tiver ativado o recarregamento. Se você não ativou o recarregamento, precisará publicar o aplicativo e reiniciar o projeto EAR se você estiver executando o WebSphere Application Server, ou publicar o aplicativo e reiniciar o servidor se você estiver executando Tomcat. Para publicar o aplicativo no servidor, você pode aguardar que o intervalo da publicação automática passe ou publicar seu aplicativo manualmente (clique com o direito no servidor na visualização Servidores e selecione Publicar). Para obter mais informações sobre publicação automática ou manual no servidor, consulte o tópico Publicando seu Aplicativo. Quando o servidor executa a função de substituição do método a quente no modo de depuração, mudanças nas classes Java são reconhecidas automaticamente.

Mudanças nos recursos EJB

Para o WebSphere Application Server, o servidor reinicia dinamicamente o projeto EJB no EAR. Quando o servidor executa a função de substituição do método a quente no modo de depuração, as mudanças nas classes Java são automaticamente reconhecidas.

Lembre-se: Tomcat não suporta teste e de publicação de EJB.

Mudanças nos recursos dentro de um projeto do Aplicativo Corporativo

Para o WebSphere Application Server, se você mudar qualquer recurso em um projeto do aplicativo corporativo enquanto ele está em execução no servidor, o servidor reinicia o EAR dinamicamente. O Tomcat não suporta teste e publicação do projeto do Aplicativo Corporativo.

Tabela 1. Resumo de ações a serem executadas quando recursos são modificados enquanto o servidor está em execução. A Tabela 1 descreve as ações que um usuário precisa executar quando os recursos são modificados enquanto o servidor está em execução. [Liberty Core, WebSphere Application Server tradicional]
Recurso modificado Ação Requerida
  WebSphere Application Server Apache Tomcat WebSphere Application Server Express
Configuração do servidor Mesmo comportamento que o WebSphere Application Server independente, para obter detalhes, consulte o Centro de Informações para o WebSphere Application Server Reinicie o servidor Reinicie o Servidor
JSP Atualize o navegador da web Atualize o navegador da web Atualize o navegador da web
Servlet Recarregamento ativado Atualize o navegador da web Atualize o navegador da web Atualize o navegador da web
Recarregamento desativado Reinicie o projeto EAR ou o servidor Reinicie o servidor Reinicie o projeto EAR ou o servidor
Classes ou descritores de implementação dependentes Recarregamento ativado Atualize o navegador da web Atualize o navegador da web Atualize o navegador da web
Recarregamento desativado Reinicie o projeto EAR ou o servidor Reinicie o servidor Reinicie o projeto EAR ou o servidor
Implementação EJB Recarregado automaticamente Não suportado Não suportado
Interface do EJB ou classes dependentes da interface Recarregado automaticamente. Reinicie o aplicativo cliente se ele contém uma referência para o EJB. Não suportado Não suportado
EJB, classes dependentes, ou descritores de implementação Recarregado automaticamente Não suportado Não suportado
Classe EJB ou dependente incluída Recarregado automaticamente Não suportado Não suportado
Arquivo EAR Recarregado automaticamente Não suportado Atualize o navegador da web
Nota: A função de substituição de método a quente é executada automaticamente no modo de depuração para o WebSphere Application Server.
1 Dica: Para o WebSphere Application Server, o modo de substituição do método a quente é executado automaticamente no modo de depuração.
Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: csrvdbg.html