2. Ferramentas utilizadas neste documento

Neste documento, utilizaremos as seguintes ferramentas:

um JDK Java 1.5
o servidor web TOMCAT (http://tomcat.apache.org/),
o ambiente de desenvolvimento ECLIPSE (http://www.eclipse.org/) com o plugin WTP (Web Tools Package)
um navegador web (IE, Netscape, Mozilla Firefox, Opera, etc.).

Estas são ferramentas gratuitas. Em geral, muitas ferramentas de código aberto podem ser utilizadas no desenvolvimento web:

`IDE JAVA`	`Fundação JBuilder`	http://www.borland.com/jbuilder/foundation/index.html
`IDE JAVA`
`Bibliotecas Java`	`Struts`	http://struts.apache.org/
`Bibliotecas Java`
`SGBD`	`MySQL`	http://www.mysql.com/





`Containers de servlets`	`Tomcat`	http://tomcat.apache.org/


`Navegadores`	`Netscape`	http://www.netscape.com/
`Navegadores`

2.1. J ava 1.5

O contentor de servlets Tomcat 5.x requer uma máquina virtual Java 1.5. Por isso, deve primeiro instalar esta versão do Java, que pode ser encontrada no site da Sun no URL [http://www.sun.com] -> [http://java.sun.com/j2se/1.5.0/download.jsp] (maio de 2006):

Passo 2:

Passo 3:

Execute a instalação do JDK 1.5 a partir do ficheiro descarregado.

2.2. O Contêiner de Servlets Tomcat 5

Para executar servlets, precisamos de um contentor de servlets. Aqui apresentamos um deles, o Tomcat 5.x, disponível em http://tomcat.apache.org/. Descrevemos os passos (maio de 2006) para o instalar. Se já estiver instalada uma versão anterior do Tomcat, é melhor removê-la primeiro.

Para descarregar o produto, siga a ligação [Tomcat 5.x] acima:

Pode descarregar o ficheiro .exe para a plataforma Windows. Após a descarga, inicie a instalação do Tomcat:

Clique em [Seguinte] ->

Aceite os termos da licença ->

Clique em [Seguinte] ->

Aceite o diretório de instalação sugerido ou altere-o usando [Procurar] ->

Defina o nome de utilizador e a palavra-passe para o administrador do servidor Tomcat. Aqui, utilizámos [admin / admin] ->

O Tomcat 5.x requer o JRE 1.5. Normalmente, ele deve detetar o JRE instalado no seu computador. Acima, o caminho indicado é o do JRE 1.5 descarregado na secção 2.1. Se não for encontrado nenhum JRE, especifique o seu diretório raiz utilizando o botão [1]. Depois de fazer isso, utilize o botão [Instalar] para instalar o Tomcat 5.x ->

O botão [Concluir] finaliza a instalação. A presença do Tomcat é indicada por um ícone no lado direito da barra de tarefas do Windows:

Clicar com o botão direito do rato neste ícone dá-lhe acesso aos comandos Iniciar e Parar do servidor:

Utilizamos a opção [Parar serviço] para parar o servidor web agora:

Observe a alteração no estado do ícone. O ícone pode ser removido da barra de tarefas:

O Tomcat foi instalado na pasta escolhida pelo utilizador, à qual nos referiremos agora como <tomcat>. A estrutura de diretórios da versão 5.5.17 do Tomcat descarregada é a seguinte:

A instalação do Tomcat adicionou vários atalhos ao menu [Iniciar]. Utilizamos o link [Monitor] abaixo para iniciar a ferramenta de paragem/arranque do Tomcat:

Em seguida, vemos o ícone mostrado anteriormente:

O monitor do Tomcat pode ser iniciado clicando duas vezes neste ícone:

Os botões [Iniciar - Parar - Pausar] - Reiniciar permitem-nos iniciar, parar e reiniciar o servidor. Iniciamos o servidor clicando em [Iniciar] e, em seguida, utilizando um navegador, introduzimos o URL http://localhost:8080. Deveremos ver uma página semelhante à seguinte:

Pode seguir as ligações abaixo para verificar se o Tomcat foi instalado corretamente:

Vale a pena explorar todos os links na página [http://localhost:8080], e o leitor é encorajado a fazê-lo. Teremos a oportunidade de revisitar os links utilizados para gerir aplicações web implementadas no servidor:

2.3. Implantação de uma aplicação web no servidor Tomcat

Leitura [ref1]: Capítulo 1, Capítulo 2: 2.3.1, 2.3.2, 2.3.3

2.3.1. Implantação

Uma aplicação web deve seguir certas regras para ser implementada num contentor de servlets. Seja <webapp> o diretório de uma aplicação web. Uma aplicação web consiste em:

`classes`	na pasta <webapp>\WEB-INF\classes
`arquivos Java`	na pasta <webapp>\WEB-INF\lib
`visualizações, recursos (.jsp, .html, ...)`	na pasta <webapp> ou subpastas

A aplicação web é configurada através de um ficheiro XML: <webapp>\WEB-INF\web.xml.

Vamos criar a aplicação web com a seguinte estrutura de diretórios:

Iremos criar a estrutura de diretórios acima utilizando o Explorador do Windows. As pastas [classes] e [lib] estão vazias aqui. A pasta [views] contém um ficheiro HTML estático:

cujo conteúdo é o seguinte:

<html>
    <head>
      <title>Application exemple</title>
  </head>
  <body>
      Application exemple active ....
  </body>
</html>

Se carregar este ficheiro num navegador, obtém a seguinte página:

O URL apresentado pelo navegador mostra que a página não foi servida por um servidor web, mas carregada diretamente pelo navegador. Queremos agora que esteja disponível através do servidor web Tomcat.

Voltemos à árvore de diretórios <tomcat>:

As aplicações web implementadas no servidor Tomcat são configuradas através de ficheiros XML localizados na pasta [<tomcat>\conf\Catalina\localhost]:

Estes ficheiros XML podem ser criados manualmente, uma vez que a sua estrutura é simples. Em vez de seguir esta abordagem, utilizaremos as ferramentas web fornecidas pelo Tomcat.

2.3.2. Administração do Tomcat

Na sua página de início de sessão http://localhost:8080, o servidor disponibiliza links para a administração:

O link [Administração do Tomcat] permite-nos configurar os recursos que o Tomcat disponibiliza às aplicações web implementadas no seu interior, tais como um conjunto de ligações à base de dados. Vamos seguir o link:

A página que aparece indica que a administração do Tomcat 5.x requer um pacote específico chamado «admin». Vamos voltar ao site do Tomcat:

Vamos descarregar o ficheiro zip intitulado [Web Application Administration] e, em seguida, descompactá-lo. O seu conteúdo é o seguinte:

A pasta [admin] deve ser copiada para [<tomcat>\server\webapps], onde <tomcat> é a pasta onde o Tomcat 5.x foi instalado:

A pasta [localhost] contém um ficheiro [admin.xml] que deve ser copiado para [<tomcat>\conf\Catalina\localhost]:

Pare e reinicie o Tomcat, caso este estivesse em execução. Em seguida, utilizando um navegador, aceda novamente à página de início de sessão do servidor web:

Siga o link [Tomcat Administration]. Verá uma página de login:

Nota: Na verdade, para aceder à página abaixo, tive primeiro de introduzir manualmente o URL [http://localhost:8080/admin/index.jsp]. Só então é que o link [Tomcat Administration] acima funcionou. Não tenho a certeza se isto foi um erro de procedimento da minha parte.

Aqui, deve introduzir novamente as informações que forneceu durante a instalação do Tomcat. No nosso caso, introduzimos o nome de utilizador e a palavra-passe como admin / admin. O botão [Login] leva-nos à página seguinte:

Esta página permite ao administrador do Tomcat definir

fontes de dados,
as informações necessárias para enviar e-mails (Sessões de Correio),
dados de ambiente acessíveis a todas as aplicações (Entradas de Ambiente),
gerir utilizadores e administradores do Tomcat (Utilizadores),
gerir grupos de utilizadores (Grupos),
definir funções (ou seja, o que um utilizador pode e não pode fazer),
definir as características das aplicações web implementadas pelo servidor (Serviço Catalina)

Vamos seguir o link [Funções] acima:

Uma função permite definir o que um utilizador ou grupo de utilizadores pode ou não fazer. Certos direitos estão associados a uma função. Cada utilizador está associado a uma ou mais funções e possui os direitos a elas associados. A função [manager] abaixo concede o direito de gerir aplicações web implementadas no Tomcat (implementação, arranque, encerramento, descarregamento). Iremos criar um utilizador [manager] e associá-lo à função [manager] para permitir que este faça a gestão das aplicações Tomcat. Para tal, seguimos o link [Utilizadores] na página de administração:

Vemos que já existem vários utilizadores. Utilizamos a opção [Criar novo utilizador] para criar um novo utilizador:

Atribuímos ao utilizador manager a palavra-passe manager e atribuímos-lhe a função manager. Utilizamos o botão [Save] para confirmar esta adição. O novo utilizador aparece na lista de utilizadores:

Este novo utilizador será adicionado ao ficheiro [<tomcat>\conf\tomcat-users.xml]:

cujo conteúdo é o seguinte:

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <role rolename="manager"/>
  <role rolename="admin"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="role1" password="tomcat" roles="role1"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="manager" password="manager" fullName="" roles="manager"/>
  <user username="admin" password="admin" roles="admin,manager"/>
</tomcat-users>

linha 10: o utilizador [manager] que foi criado

Outra forma de adicionar utilizadores é editar este ficheiro diretamente. Este é o procedimento a seguir se, por exemplo, tiver esquecido a palavra-passe da conta de administrador ou gestor.

2.3.3. Gestão de aplicações Web implementadas

Agora, voltemos à página de início de sessão [http://localhost:8080] e sigamos a ligação [Tomcat Manager]:

Isto abre uma página de autenticação. Iniciamos sessão como manager / manager, ou seja, o utilizador com a função [manager] que acabámos de criar. Na verdade, apenas um utilizador com esta função pode utilizar este link. Na linha 11 do [tomcat-users.xml], vemos que o utilizador [admin] também tem a função [manager]. Poderíamos, portanto, utilizar também as credenciais [admin / admin].

Somos direcionados para uma página que lista as aplicações atualmente implementadas no Tomcat:

Podemos adicionar uma nova aplicação utilizando os formulários na parte inferior da página:

Aqui, queremos implementar a aplicação de exemplo que criámos anteriormente no Tomcat. Fazemos isso da seguinte forma:

`Caminho de contexto`	/example	o nome utilizado para identificar a aplicação web a ser implementada
`URL do diretório`	C:\data\2005-2006\eclipse\dvp-eclipse-tomcat\example	a pasta da aplicação web

Para recuperar o ficheiro [C:\data\2005-2006\eclipse\dvp-eclipse-tomcat\example\views\example.html], solicitaremos a URL [http://localhost:8080/exemple/vues/exemple.html] ao Tomcat. O contexto é, portanto, utilizado para designar a raiz da árvore de diretórios da aplicação web implementada. Utilizamos o botão [Deploy] para implementar a aplicação. Se tudo correr bem, obtemos a seguinte página de resposta:

e a nova aplicação aparece na lista de aplicações implementadas:

Vamos comentar a linha de contexto /example acima:

`/example`	ligação para http://localhost:8080/exemple
`Iniciar`	permite-lhe iniciar a aplicação
`Parar`	permite-lhe parar a aplicação
`Atualizar`	permite-lhe recarregar a aplicação. Isto é necessário, por exemplo, quando adicionou, modificou ou eliminou determinadas classes na aplicação.
`Desinstalar`	remove o contexto [/example]. A aplicação desaparece da lista de aplicações disponíveis.

Agora que a nossa aplicação /example está implementada, podemos executar alguns testes. Solicitamos a página [example.html] através do URL [http://localhost:8080/exemple/vues/exemple.html]:

Outra forma de implementar uma aplicação web no servidor Tomcat é fornecer as informações que introduzimos através da interface web num ficheiro [context].xml localizado na pasta [<tomcat>\conf\Catalina\localhost], onde [context] é o nome da aplicação web.

Voltemos à interface de administração do Tomcat:

Vamos remover a aplicação [/example] utilizando o link [Undeploy]:

A aplicação [/example] já não faz parte da lista de aplicações ativas. Agora, vamos definir o seguinte ficheiro [example.xml]:

1 2	`<Context docBase="C:/data/2005-2006/eclipse/dvp-eclipse-tomcat/exemple"> </Context>`

O ficheiro XML consiste numa única tag <Context>, cujo atributo docBase define a pasta que contém a aplicação web a ser implementada. Vamos colocar este ficheiro em <tomcat>\conf\Catalina\localhost:

Pare e reinicie o Tomcat, se necessário, e, em seguida, visualize a lista de aplicações ativas utilizando o administrador do Tomcat:

A aplicação [/example] está, de facto, disponível. Vamos aceder à URL num navegador:

[http://localhost:8080/exemple/vues/exemple.html]:

Uma aplicação web implementada desta forma pode ser removida da lista de aplicações implementadas, da mesma forma que anteriormente, utilizando o link [Undeploy]:

Neste caso, o ficheiro [example.xml] é automaticamente removido da pasta [<tomcat>\conf\Catalina\localhost].

Por fim, para implementar uma aplicação web no Tomcat, também pode definir o seu contexto no ficheiro [<tomcat>\conf\server.xml]. Não abordaremos este ponto aqui.

2.3.4. Aplicação web com uma página inicial

Quando solicitamos a URL [http://localhost:8080/exemple/], obtemos a seguinte resposta:

Este comportamento depende da configuração do Tomcat. Em versões anteriores, teríamos visto o conteúdo do diretório físico da aplicação [/example]. É positivo que o Tomcat agora impeça isso por padrão.

Podemos configurá-lo para que, quando o contexto for solicitado, seja exibida a chamada página inicial. Para tal, criamos um ficheiro [web.xml] e colocamo-lo na pasta <example>\WEB-INF, onde <example> é a pasta física da aplicação web [/example]. Este ficheiro tem o seguinte conteúdo:

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
    version="2.4">

  <display-name>Application Exemple</display-name>
  <description>Application web minimale</description>
    <welcome-file-list>
        <welcome-file>/vues/exemple.html</welcome-file>
    </welcome-file-list>    
</web-app>

Linhas 2–5: A tag raiz <web-app> com atributos copiados e colados do ficheiro [web.xml] da aplicação Tomcat [/admin] (<tomcat>/server/webapps/admin/WEB-INF/web.xml).
linha 7: o nome de exibição da aplicação web. Trata-se de um nome escolhido livremente, com menos restrições do que o nome do contexto da aplicação. Por exemplo, pode conter espaços, o que não é possível com o nome do contexto. Este nome é exibido, por exemplo, pelo administrador do Tomcat:

Linha 8: Descrição da aplicação web. Este texto pode depois ser recuperado programaticamente.
Linhas 9–11: A lista de ficheiros de boas-vindas. A tag <welcome-file-list> é utilizada para definir a lista de visualizações a apresentar quando um cliente solicita o contexto da aplicação. Podem existir várias visualizações. A primeira encontrada é apresentada ao cliente. Aqui temos apenas uma: [/views/example.html]. Assim, quando um cliente solicita o URL [/example], será na verdade o URL [/example/views/example.html] que lhe será servido.

Vamos guardar este ficheiro [web.xml] em <example>\WEB-INF:

Se o Tomcat ainda estiver em execução, pode forçá-lo a recarregar a aplicação web [/example] utilizando o link [Reload]:

Durante esta operação de «recarregamento», o Tomcat volta a ler o ficheiro [web.xml] contido em [<example>\WEB-INF], caso este exista. É o que acontece neste caso. Se o Tomcat tiver sido parado, reinicie-o.

Utilizando um navegador, aceda ao URL [http://localhost:8080/exemple/]:

O mecanismo do ficheiro host funcionou.

2.4. Instalação do Eclipse

O Eclipse é um ambiente de desenvolvimento multilingue. É amplamente utilizado no desenvolvimento Java. É uma ferramenta extensível através da adição de ferramentas chamadas plugins. Existe um grande número de plugins, e é isso que torna o Eclipse tão poderoso.

O Eclipse está disponível no URL [http://www.eclipse.org/downloads/]:

Queremos utilizar o Eclipse para o desenvolvimento web em Java. Existem vários plugins disponíveis para este fim. Ajudam a validar a sintaxe de páginas JSP, ficheiros XML e muito mais, e permitem-lhe testar uma aplicação web dentro do Eclipse. Iremos utilizar um destes plugins, chamado Web Tools Package (WTP). O procedimento padrão para instalar o Eclipse é o seguinte:

Instale o Eclipse
Instale os plugins de que necessita

O próprio plugin WTP requer outros plugins, o que torna a sua instalação bastante complexa. Por isso, o site do Eclipse disponibiliza um pacote que inclui a plataforma de desenvolvimento Eclipse e o plugin WTP, juntamente com todos os outros plugins necessários. Este pacote está disponível no site do Eclipse (maio de 2006) no URL [http://download.eclipse.org/webtools/downloads/]:

Siga o link [1.0.2] acima:

Fazemos o download do pacote [wtp] utilizando o link acima. O ficheiro zip resultante contém o seguinte:

Basta extrair este conteúdo para uma pasta. A partir de agora, iremos referir-nos a esta pasta como <eclipse>. O seu conteúdo é o seguinte:

[eclipse.exe] é o ficheiro executável e [eclipse.ini] é o seu ficheiro de configuração. Vamos ver o conteúdo deste último:

1
2
3

-vmargs
-Xms40m
-Xmx256m

Estes argumentos são utilizados ao iniciar o Eclipse da seguinte forma:

eclipse.exe -vmargs -Xms40m -Xmx256m

Pode obter o mesmo resultado que com o ficheiro .ini criando um atalho que inicie o Eclipse com estes mesmos argumentos. Vamos explicá-los:

-vmargs: indica que os argumentos seguintes se destinam à Máquina Virtual Java que irá executar o Eclipse. De facto, o Eclipse é uma aplicação Java.
-Xms40m: ?
-Xmx256m: define o tamanho da memória em MB alocada à Máquina Virtual Java (JVM) que executa o Eclipse. Por predefinição, este tamanho é de 256 MB, como mostrado aqui. Se o sistema o permitir, é preferível 512 MB.

Estes argumentos são passados para a JVM que irá executar o Eclipse. A JVM é representada por um ficheiro [java.exe] ou [javaw.exe]. Onde se encontra este ficheiro? Na verdade, pode ser localizado de várias formas:

no PATH do SO
na pasta <JAVA_HOME>/jre/bin, onde JAVA_HOME é uma variável de sistema que define a pasta raiz de um JDK.
num local passado como argumento ao Eclipse na forma -vm <path>\javaw.exe

Esta última solução é preferível porque as outras duas estão sujeitas às variações decorrentes de instalações de aplicações posteriores, que podem alterar o PATH do sistema operativo ou a variável JAVA_HOME.

Criamos, portanto, o seguinte atalho:

`alvo`	<eclipse>\eclipse.exe -vm "C:\Program Files\Java\jre1.5.0_06\bin\javaw.exe" -vmargs -Xms40m -Xmx512m
`Iniciar em`	Diretório de instalação do Eclipse

Depois de fazer isso, inicie o Eclipse usando este atalho. Verá uma caixa de diálogo inicial:

Um [workspace] é um espaço de trabalho. Vamos aceitar os valores predefinidos fornecidos. Por predefinição, os projetos do Eclipse serão criados na pasta <workspace> especificada nesta caixa de diálogo. Existe uma forma de substituir este comportamento. É isso que faremos sistematicamente. Portanto, a resposta dada nesta caixa de diálogo não é importante.

Assim que esta etapa estiver concluída, o ambiente de desenvolvimento do Eclipse é apresentado:

Fechamos a vista [Welcome] conforme sugerido acima:

Antes de criar um projeto Java, vamos configurar o Eclipse para especificar o JDK a utilizar na compilação de projetos Java. Para tal, selecionamos a opção [Window / Preferences / Java / Installed JREs]:

Normalmente, o JRE (Java Runtime Environment) utilizado para iniciar o próprio Eclipse deve estar presente na lista de JREs. Este será, geralmente, o único. Pode adicionar JREs utilizando o botão [Adicionar]. Deve então especificar o diretório raiz do JRE. O botão [Pesquisar] irá iniciar uma pesquisa por JREs no disco. Esta é uma boa forma de manter um registo dos JREs que instala e que depois se esquece de desinstalar ao atualizar para uma versão mais recente. Acima, o JRE marcado é aquele que será utilizado para compilar e executar projetos Java.

O JRE utilizado nos nossos exemplos é o instalado na Secção 2.1, que também foi utilizado para iniciar o Eclipse. Ao clicar duas vezes nele, abrem-se as suas propriedades:

Agora, vamos criar um projeto Java [Arquivo / Novo / Projeto]:

Selecione [Projeto Java] e, em seguida, [Seguinte] ->

Em [2], especificamos uma pasta vazia onde o projeto Java será instalado. Em [1], atribuímos um nome ao projeto. Não é necessário que o nome corresponda ao da pasta, como o exemplo acima poderia sugerir. Depois de fazer isto, utilizamos o botão [Concluir] para concluir o assistente de criação. Isto equivale a aceitar os valores predefinidos propostos pelas páginas seguintes do assistente.

Agora temos uma estrutura básica do projeto Java:

Clique com o botão direito do rato no projeto [test1] para criar uma classe Java:

em [1], a pasta onde a classe será criada. Por predefinição, o Eclipse sugere a pasta do projeto atual.
em [2], o pacote no qual a classe será colocada
em [3], o nome da classe
Em [4], solicitamos que o método estático [main] seja gerado

Confirmamos o assistente clicando em [Concluir]. O projeto é então enriquecido com uma classe:

O Eclipse gerou o esqueleto da classe. Pode aceder-lhe clicando duas vezes em [Test1.java] acima:

Modificamos o código acima da seguinte forma:

Executamos o programa [Test1.java]: [clique com o botão direito do rato em Test1.java -> Executar como -> Aplicação Java]

O resultado da execução é apresentado na janela [Console]:

2.5. Integração do Tomcat com o Eclipse

Para trabalhar com o Tomcat sem sair do Eclipse, precisamos de declarar este servidor na configuração do Eclipse. Para tal, selecionamos a opção [Ficheiro / Novo / Outro]. Em seguida, vemos o seguinte assistente:

Optamos por criar um novo servidor. Selecionamos o ícone [Servidor] acima e, em seguida, clicamos em [Seguinte]:

A adição do servidor faz com que apareça uma pasta no Explorador de Projetos do Eclipse:

Para gerir o Tomcat a partir do Eclipse, exibimos a vista chamada [Servidores] utilizando a opção [Janela -> Mostrar Vista -> Outros -> Servidor]:

Clique em [OK]. A vista [Servidores] é então apresentada:

Todos os servidores registados aparecem nesta vista, neste caso o servidor Tomcat 5.5 que acabámos de registar. Ao clicar com o botão direito do rato sobre ele, obtém-se acesso aos comandos para iniciar, parar e reiniciar o servidor:

Acima, estamos a iniciar o servidor. Quando este arranca, são gravados vários registos na vista [Console]:

11 mai 2006 15:31:16 org.apache.catalina.core.AprLifecycleListener lifecycleEvent
INFO: The Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: C:\Program Files\Java\jre1.5.0_06\bin;.;C:\WINDOWS\system32;...
11 mai 2006 15:31:16 org.apache.coyote.http11.Http11BaseProtocol init
INFO: Initialisation de Coyote HTTP/1.1 sur http-8080
...
INFO: Server startup in 1641 ms

É preciso algum tempo para se habituar a compreender estes registos. Não nos vamos deter neles por agora. No entanto, é importante verificar se não indicam quaisquer erros de carregamento do contexto. Com efeito, quando iniciado, o servidor Tomcat/Eclipse tenta carregar o contexto das aplicações que gere. O carregamento do contexto de uma aplicação envolve o processamento do seu ficheiro [web.xml] e o carregamento de uma ou mais classes que o inicializam. Podem ocorrer vários tipos de erros:

o ficheiro [web.xml] tem um erro de sintaxe. Este é o erro mais comum. Recomenda-se a utilização de uma ferramenta capaz de validar um documento XML durante a sua criação.
algumas classes a serem carregadas não foram encontradas. Estas são procuradas em [WEB-INF/classes] e [WEB-INF/lib]. Deve, geralmente, verificar a presença das classes necessárias e a ortografia das que estão declaradas no ficheiro [web.xml].

O servidor iniciado a partir do Eclipse não tem a mesma configuração que o instalado na secção 2.2, página 5. Para verificar isto, aceda ao URL [http://localhost:8080] utilizando um navegador:

Esta resposta não indica que o servidor não está a funcionar, mas sim que o recurso / solicitado não está disponível. Com o servidor Tomcat integrado no Eclipse, estes recursos serão projetos web. Veremos isto mais tarde. Por agora, vamos parar o Tomcat:

O modo de funcionamento anterior pode ser alterado. Voltemos à vista [Servers] e façamos duplo-clique no servidor Tomcat para aceder às suas propriedades:

A caixa de seleção [1] é responsável pelo comportamento descrito acima. Quando marcada, as aplicações web desenvolvidas no Eclipse não são declaradas nos ficheiros de configuração do servidor Tomcat associado, mas sim em ficheiros de configuração separados. Como resultado, as aplicações predefinidas no servidor Tomcat — [admin] e [manager], que são duas aplicações úteis — não estão disponíveis. Por isso, vamos desmarcar [1] e reiniciar o Tomcat:

Depois de fazer isso, vamos aceder ao URL [http://localhost:8080] usando um navegador:

Observamos o comportamento descrito na secção 2.3.3, página 15.

Nos nossos exemplos anteriores, utilizámos um navegador fora do Eclipse. Também pode utilizar um navegador dentro do Eclipse:

Acima, selecionamos o navegador interno. Para o iniciar a partir do Eclipse, pode utilizar o seguinte ícone:

O navegador que será efetivamente iniciado será aquele selecionado através da opção [Janela -> Navegador Web]. Aqui, obtemos o navegador interno:

Se necessário, inicie o Tomcat a partir do Eclipse e introduza o URL [http://localhost:8080] em [1]:

Siga o link [Tomcat Manager]:

Ser-lhe-á solicitado o [nome de utilizador/palavra-passe] necessário para aceder à aplicação [manager]. Com base na configuração do Tomcat que definimos anteriormente, pode introduzir [admin/admin] ou [manager/manager]. Em seguida, verá uma lista das aplicações implementadas:

Vemos a aplicação [person] que criámos. A ligação [Reload] associada será útil mais tarde.