Imprimir

Para poder desarrollar aplicaciones web más cómodamente desde el entorno de desarrollo Eclipse, es posible realizar una conexión desde dicho IDE con una nueva instancia del servidor Apache Tomcat, facilitando así el despliegue de las aplicaciones web que desarrolles. De esta manera, podrás probar tus aplicaciones antes de llevarlas al servidor que se encuentre en producción.

Esta utilidad la ofrece la versión de Eclipse que incorpora Java EE, que puedes obtener desde la web de descargas de Eclipse como el resto de versiones.

tomcat eclipse 21

Una vez que inicies Eclipse, comprueba que tienes activada la perspectiva de Java EE. Esto lo puedes observar en la esquina superior derecha. Si no es esta perspectiva la que tienes activada, selecciónala usando el icono con el signo más que se encuentra en la misma barra, o bien usando la opción de menú Window > Open perspective > Other > Java EE.

tomcat eclipse 22

Ahora debes poder acceder directamente a la opción de menú Window > Show View > Servers para poder mostrar la pestaña de servidores.

tomcat eclipse 01

Así podrás ver en la sección inferior la pestaña Servers donde deberás utilizar el enlace new server wizard para iniciar el asistente que facilita la declaración del servidor con el que deseamos realizar la conexión.

tomcat eclipse 02

En este asistente indica que quieres conectarte con un servidor Apache - Tomcat v7.0 Server. En el campo de texto Server's host name debes indicar la dirección que debe utilizarse para realizar la conexión con el servidor. Esta utilidad sólo se puede utilizar con servidores que se encuentren en la misma máquina, por lo que debes indicar obligatoriamente localhost como nombre del equipo en el que se encuentra el servidor. En el campo de texto Server name puedes indicar cualquier nombre con el que reconozcas al servidor, por lo que puedes dejar el nombre que aparece por defecto si así lo deseas, o cambiarlo.

tomcat eclipse 03

Indica en la siguiente pantalla la carpeta en la que se encuentra instalado el servidor Tomcat.

tomcat eclipse 04

Ya puedes finalizar el asistente, porque en la siguiente pantalla no es necesario indicar nada más.

tomcat eclipse 05

Con estos pasos debe aparecer en la pestaña Servers de la sección inferior, la línea correspondiente a este servidor que acabas de registrar, y en la ventana del explorador de proyectos también aparecerá con la lista de archivos de configuración del servidor.

tomcat eclipse 06

En la pestaña Servers puede ver el estado en el que se encuentra la instancia del servidor que se ha declarado en Eclipse. En principio aparecerá como parado (Stopped), pero haciendo clic derecho sobre él, puedes cambiar su estado e iniciarlo con la opción Start.

tomcat eclipse 23

Si todo ha ido bien, aparecerá el estado del servidor como iniciado (Started).

En caso de que se haya producido algún problema al iniciar el servidor, comprueba especialmente que no tengas iniciado el servidor Tomcat por otro lado. Esto puede ser habitual si has realizado la instalación del servidor para que se inicie de forma automática como servicio de Windows. Por tanto, antes de iniciar el servidor desde Eclipse, debes detener su ejecución como servicio. Si este ha sido el problema, habrás visto un mensaje rojo en la consola de Eclipse, en el que aparece entre otros avisos, el mensaje de que la dirección del servidor está en uso:

SEVERE: StandardServer.await: create[localhost:8005]:
java.net.BindException: Address already in use: JVM_Bind

tomcat eclipse 24


Si deseas mantener en funcionamiento el servidor "real" y la instancia que has creado en Eclipse, puedes cambiar el puerto que crea conflicto, que es el 8005 como puedes ver en el error mostrado. Para ello, abre desde Eclipse el archivo server.xml que puedes encontrar en la carpeta Servers del Explorador de proyectos.

tomcat eclipse 25

Cambia la siguiente línea:

{code class="brush:xml;gutter:false"}<Server port="8005" shutdown="SHUTDOWN">{/code}

indicando otro número de puerto, por ejemplo el 8006:

{code class="brush:xml;gutter:false"}<Server port="8006" shutdown="SHUTDOWN">{/code}

Probar la conexión con un proyecto de ejemplo

Para comprobar si la conexión con el servidor está funcionando correctamente vamos a crear un proyecto de ejemplo, que tan sólo mostrará una página web simple HTML.

Crea un nuevo proyecto de tipo Dynamic Web Project.

tomcat eclipse 07

Una vez iniciado el asistente, indica cualquier nombre para el proyecto y comprueba que el destino de la ejecución (Target runtime) hace referencia al servidor que has declarado antes.

tomcat eclipse 08

En la siguiente pantalla no es necesario que indiques nada nuevo. En ella podrías crear carpetas para ordenar los archivos que contendrán el código fuente del proyecto.

tomcat eclipse 09

La última pantalla tampoco es necesario modificarla. En ella podrías cambiar los nombres de la carpeta raíz del proyecto y de la carpeta que almacenará el contenido de la web. Así que ya puedes usar el botón de finalizar.

tomcat eclipse 10

Al terminar el asistente de creación del proyecto, debe aparecer en el explorador de proyectos de la parte izquierda, la estructura del proyecto web dinámico que has creado.

tomcat eclipse 11

Para este ejemplo tan sólo se va a crear una página estática HTML sencilla, aunque se haya creado un proyecto web de contenido dinámico para Tomcat, ya que tan sólo se debe probar la conexión para poder hacer posteriormente otros proyectos más complejos. Por tanto, para crear el archivo HTML, haz clic derecho sobre la carpeta WebContent y selecciona la opción New >  HTML File.

tomcat eclipse 12

En la primera pantalla de este nuevo asistente, indica un nombre para el archivo HTML que se va a crear.

tomcat eclipse 13

En la siguiente pantalla no es necesario que realices ningún cambio para este ejemplo. En ella se especifica la versión de código HTML que se va a seguir en el archivo que se está creando. Hax clic en el botón de finalizar.

tomcat eclipse 14

Ya podrás ver en el editor la plantilla básica del archivo HTML. En la sección <body> escribe cualquier texto de prueba y guarda el archivo.

tomcat eclipse 15

Permaneciendo en este archivo, usa el botón verde de ejecutar, o el menú Run > Run (Ctrl+F11), para iniciar la prueba de acceso a la página desde el servidor. Te preguntará en qué servidor quieres lanzar la ejecución, por lo que selecciona el servidor Tomcat que habías declarado anteriormente.

tomcat eclipse 16

Ya podrías usar el botón de finalizar, porque en la siguiente pantalla, donde podrías modificar los recursos que están configurados en el servidor, no hay que realizar ningún cambio.

tomcat eclipse 17

De esta manera, si todo ha ido bien, se debe abrir una nueva pestaña en el área central de Eclipse con el contenido de la página web.

tomcat eclipse 19

En el estado del servidor puedes ver, además del estado iniciado/parado, si se encuentra sincronizado con los cambios que realices en el código fuente de la página que contiene. Si realizas cualquier cambio en el código, verás que el estado del servidor se encontrará como Republish, indicando así que hay cambios que no se han enviado aún al servidor. En el momento en que guardes los cambios, su estado pasará a Synchronized.

Comprobación con una página JSP

De manera similar puedes comprobar el funcionamiento con una página web con contenido escrito en lenguaje JSP. En lugar de crear un nuevo archivo HTML, indica que quieres crear un nuevo archivo JSP en la carpeta WebContent, escribiendo el siguiente código de ejemplo en la sección body:

{code}
<H1>Hola Mundo</H1>
La fecha de hoy es: <%= new java.util.Date().toString() %>
{/code}

Si compruebas el funcionamiento de esta página verás que se muestra la fecha actual.