Especificar servidores destino para projectos J2EE

Ao desenvolver aplicações J2EE, a área de trabalho requer que especifique os ambientes de tempo de execução do servidor para os seus projectos de J2EE. O servidor destino é especificado durante a criação e importação do projecto e pode ser alterada nas propriedades do projecto. A definição do servidor destino é o mecanismo predefinido para a configuração de caminhos de classe para projectos J2EE.

Para suportar servidores de aplicação diferentes que utilizem níveis de JDK diferentes para o Java™ Runtime Environment (JRE), a área de trabalho requer que os projectos incluam uma definição de servidor destino. Por exemplo, se pretende tirar partido das funções do JDK 1.4.2, as suas aplicações requerem entradas de caminhos de classe diferentes das utilizadas em versões anteriores da área de trabalho. Ao requerer que especifique um servidor destino, a área de trabalho assegura que as entradas adequadas são adicionadas correctamente para serem executadas no servidor que escolher.

Quando o projecto é criado, o caminho de classe do projecto é actualizado com dois contentores de caminho de classe. Um contentor é o JDK e o outro é o servidor. O contentor JDK aponta para o directório que contém ficheiros JAR necessários para suportar a versão JDK. O contentor servidor aponta para o directório que contém os vários ficheiros JAR públicos disponíveis no servidor seleccionado. Em seguida, o projecto é compilado com base nos ficheiros JAR requeridos, localizados nestas pastas, sem ter de se preocupar com a adição de ficheiros JAR adicionais do servidor durante o desenvolvimento. Quando o ficheiro é compilado, os ficheiros JAR são incluídos no caminho de classe. Pode adicionar os seus próprios ficheiros JAR ao caminho de classe.

O ambiente em tempo de execução de destino é especificado no ficheiro .runtime nos recursos do projecto. Não deve editar este ficheiro manualmente.

Todos os assistentes de criação e importação de projectos de J2EE necessitam que especifique o servidor destino para os projectos resultantes. A lista de servidores destino em pode escolher é filtrada com base nos tempos de execução instalados, no nível de J2EE da aplicação e no tipo de módulo J2EE. Por exemplo, para os projectos EJB apenas são apresentados servidores de aplicação que suportem JavaBeans™ Empresariais. Todos os projectos dentro de um único ficheiro EAR destinam-se ao mesmo servidor como destino. Se criar um projecto novo e o adicionar a um projecto EAR existente durante a criação, o projecto herda a definição do servidor destino do projecto EAR.

Nota: Os projectos Java utilitários adicionados a uma aplicação destinam-se ao mesmo servidor destino da aplicação. Os projectos de biblioteca da Web adicionados a um projecto da Web destinam-se ao mesmo servidor destino do projecto da Web.

Para modificar o tempo de execução de destino e o servidor predefinido de um projecto existente:

  1. Na vista Explorador de Projecto da perspectiva J2EE, faça clique com o botão direito do rato no projecto de aplicação empresarial ou de módulo e seleccione Propriedades no menu emergente. Irá abrir-se o diálogo do projecto Propriedades.
  2. Seleccione a página Servidor no diálogo Propriedades.
  3. Na lista pendente Tempo de execução de destino, seleccione o tempo de execução do servidor para o qual pretende que o seu projecto seja desenvolvido. Esta selecção vai ter impacto nas bibliotecas de tempo de execução adicionadas ao caminho de classe do seu projecto. Pode fazer clique em Novo para definir um novo ambiente em tempo de execução que tenha instalado. A lista de ambiente em tempo de execução está definida nas preferências da sua área de trabalho.
  4. Opcional: Apenas aplicações empresariais: Ao modificar o servidor destino de uma aplicação empresarial, pode seleccionar a caixa de verificação Incluir projectos descendentes para aplicar as suas alterações a quaisquer módulos descendentes. Isto assegura que o projecto de aplicação empresarial e todos os projectos de módulo, projectos utilitários e projectos de bibliotecas de aplicação da Web tenham o mesmo servidor destino.
  5. Opcional: No campo Servidor predefinido, seleccione o servidor predefinido a ser utilizado ao implementar um projecto. Apesar de normalmente ter de configurar isto com o mesmo valor do tempo de execução de destino, a selecção Servidor predefinido é independente da selecção Tempo de execução de destino. O servidor predefinido apenas especifica uma preferência de projecto para que não lhe sejam pedidos os ambientes em tempo de execução disponíveis ao implementar o projecto.
  6. Faça clique em Aplicar para guardar as alterações.
Conceitos relacionados
Arquitectura J2EE