1

Tutorial Eclipse Parte I

Sobre este Tutorial

Este tutorial intentar mostrar los beneficios de utilizar Eclipse para programar utilizando el lenguaje Java. Su finalidad es brindar una gua detallada para usuarios que se inician en el uso de la plataforma o en la programacin Java. No es prerrequisito poseer un conocimiento avanzado o especfico de Java para poder seguir este tutorial. Con unos pocos minutos de lectura y prctica, ser capaz de dominar las tcnicas principales de Eclipse, lo que le permitir acelerar los tiempos de programacin e incrementar su productividad.

El nico prerrequisito que debe cumplirse antes de comenzar este

tutorial es tener instalada la versin de Eclipse 3.2.1 o superior junto con una mquina virtual de Java. De hecho, este tutorial est optimizado para la versin 3.2.1 de Eclipse. Para obtener informacin acerca de estos elementos, visite la seccin de "Enlaces" en este mismo documento.

Qu es Eclipse?

En la web oficial de Eclipse (www.eclipse.org), se define como An IDE for everything and nothing in particular (un IDE para todo y para nada en particular). Eclipse es, en el fondo, nicamente un armazn (workbench) sobre el que se pueden montar herramientas de desarrollo para cualquier lenguaje, mediante la implementacin de los plugins adecuados.

2

La arquitectura de plugins de Eclipse permite, adems de integrar

diversos lenguajes sobre un mismo IDE, introducir otras aplicaciones accesorias que pueden resultar tiles durante el proceso de desarrollo como: herramientas UML, editores de interfaces visuales, ayuda en lnea para libreras, etc.

Sobre el Proyecto Eclipse

El IDE Eclipse es, principalmente, una de las herramientas que se engloban bajo el denominado Proyecto Eclipse. El Proyecto Eclipse engloba tanto el desarrollo del IDE Eclipse como de algunos de los plugins ms importantes (como el JDT, plugin para el lenguaje Java, o el CDT, plugin para el lenguaje C/C++).

Este proyecto tambin alcanza a las libreras que sirven como base para la construccin del IDE Eclipse (pero pueden ser utilizadas de forma completamente independiente), como por ejemplo, la librera de widgets SWT.

El Consorcio Eclipse

En su origen, el Proyecto Eclipse era un proyecto de desarrollo OpenSource, soportado y mantenido en su totalidad por IBM. Bajo la direccin de IBM, se fund el Consorcio Eclipse al cual se unieron algunas empresas importantes como Rational, HP o Borland.

Desde el da 2 de febrero de 2004, el Consorcio Eclipse es

independiente de IBM y entre otras, est formado por las empresas: HP, QNX, IBM, Intel, SAP, Fujitsu, Hitachi, Novell, Oracle, Palm, Ericsson y RedHat, adems de algunas universidades e institutos tecnolgicos.

3

Entorno de Proyectos de Eclipse

En el entorno de desarrollo Eclipse todo archivo se almacena dentro de un proyecto. Esto quiere decir que todo documento, carpeta, archivo de cdigo fuente (.java) y cdigo compilado (.class) tiene que estar contenido dentro de un proyecto. As pues, el primer paso antes de usar Eclipse para programar en Java es comprender la estructura de proyectos de Eclipse.

Figura 1

Al iniciar la aplicacin por primera vez se le permitir seleccionar la

ubicacin de los directorios y archivos que compondrn los distintos proyectos dentro del rea denominada Workspace, segn ilustra la Fig. 1

Es necesario crear un nuevo proyecto no slo para desarrollar un nuevo

programa de Java, sino para editar tambin archivos ya existentes (como por ejemplo, un programa ".java" almacenado en un diskette).

Para crear un nuevo proyecto, seleccione en la lnea de mens principal

"File > New > Project...". Tambin es posible seleccionar "New > Project..." haciendo click derecho en cualquier parte de una vista de Eclipse (como por ejemplo, el Package Explorer). Fig. 2

Figura 2

4

Hay varios tipos de proyectos de Eclipse que pueden ser creados:

Para crear o editar programas Java, un "Java Project" debera crearse. Ntese que dentro de un proyecto de Java tambin puede almacenarse toda la informacin relacionada con el proyecto (la cual no tiene por qu reducirse estrictamente a cdigo fuente, sino que tambin puede contener documentacin y otros archivos relacionados).

Los "Simple Project" slo deberan crearse para almacenar documentos y otros archivos, pero no cdigo Java que se desee compilar. Por ello, siempre que se creen archivos ".java" sera recomendable crear un "Java Project".

Los "Plug-in Development Project" se usan para aadir nuevos mdulos y funciones al entorno Eclipse. Estos proyectos slo son necesarios si se es un desarrollador de Eclipse.

Los proyectos de "EMF" se utilizan para crear modelos de anlisis y diseo.

Puesto que este tutorial se centra en utilizar Eclipse para programar en

Java, escogeremos crear un nuevo "Java Project" seleccionando "Java > Java Project" y haciendo click en el botn "Next >" del asistente de creacin.

HotKey: Alt+Shift+N+R. Fig. 3

Figura 3

5

Tras esto, debe especificarse un nuevo nombre para el proyecto. Los proyectos profesionales se nombran utilizando nombres de dominio invertidos para evitar posibles conflictos de nombrado. Sin embargo, para un proyecto de uso interno cualquier nombre descriptivo ser suficiente. En este ejemplo, se ha llamado al nuevo proyecto "EclipseTutorial". Fig 4

Si se usa el directorio por defecto, los archivos del proyecto se

almacenarn en el directorio: [DirectorioDeInstalacin]\workspace\[NombreProyecto] Tambin es posible especificar un directorio diferente en el que guardar

dichos contenidos.

Figura 4

En este punto ya es posible terminar la creacin del nuevo proyecto haciendo click en el botn "Finish".

6

El proyecto recin creado debera parecerse a este, tal y como lo muestra la vista "Navigator".:

En Eclipse 3.2 la creacin de proyectos es un tanto diferente a Eclipse 2.x. An puede definirse una carpeta cualquiera para almacenar los proyectos. Pero ahora los pasos de la creacin de una estructura adecuada de carpetas fuente y destino pueden omitirse, ya que en la nueva versin de Eclipse basta con marcar la opcin "Create separate source and output folders" para construir de forma automtica la estructura de archivos

Para editar un elemento existente debera ser primero importado dentro

de un proyecto de Eclipse. Esto puede hacerse desde el men "File > Import..." o bien pulsando con el botn derecho en cualquier punto de la vista del "Package Explorer" o del "Resource Navigator". Para seleccionar un archivo o directorio hay que seleccionar "File system" en el sub men de importacin. Entonces slo habr que recorrer los directorios marcando los archivos que se deseen importar as como el proyecto y la carpeta destino.

Todo archivo creado mediante la utilizacin de Eclipse puede ser

exportado como un archivo normal (seleccionando Export... > File System), como un archivo ".jar" e incluso como archivos comprimidos en ".zip". El proceso que hay que seguir es similar al proceso recientemente explicado para importar archivos, slo que seleccionando ahora la opcin "Export".

Tambin es posible copiar, cortar y pegar archivos y carpetas desde

Eclipse hasta los directorios del sistema operativo (por ejemplo, del explorador de Windows) y viceversa (seleccionando un archivo, pulsando CTRL+C, seleccionando la carpeta destino dentro de Eclipse y pulsando CTRL+V).

7

Crear Elementos de Java Ya ha aprendido como crear un nuevo proyecto, ahora aprender cmo

crear los diversos elementos de Java. Para seguir los pasos que se exponen a continuacin es necesario cambiar a la "Perspectiva Java" (si no se ha hecho ya) seleccionando "Window > Perspectives > Java". La perspectiva de Java contiene las vistas y editores ms tiles a la hora de crear nuevos programas

en Java. Haciendo click derecho en la carpeta fuente

recientemente creada (por ejemplo, "src") dentro de la vista del Package Explorer, aparecer un men contextual. Seleccionando "New >" en dicho men se mostrar una lista con los diversos elementos de Java que pueden ser creados.

Algunos de dichos elementos pueden ser creados

tambin realizando click sobre los iconos del men de la parte superior de la pantalla.

Las Clases Java Las clases de Java son los archivos ".java" que contienen el cdigo

fuente y que sern posteriormente compilados en archivos ".class". Estos archivos Java tienen que ser almacenados dentro de la carpeta fuente recientemente creada (por ejemplo, "src"). Pulse "New > Class" para abrir la ventana de creacin de clases. HotKey: Alt+Shift+N+C

La carpeta fuente especificada debera ser la carpeta recientemente

definida (src). Si no se especifica ningn paquete para contener las clases Java, se guardarn dentro de un paquete por defecto, pero el uso del paquete por defecto no es aconsejable y Eclipse nos lo recordar. Definiremos el paquete como modelo. El ltimo campo obligatorio que debera ser rellenado antes de proceder a la creacin de la clase Java es el propio nombre de la clase. Las convenciones de Java sugieren que el nombre de una clase debera comenzar con mayscula. En este tutorial se ha usado el nombre "ExampleClass". Fig. 5

8

Figura 5

Tambin existen otros modificadores que pueden ser fcilmente

aadidos a una clase desde el mismo momento de su creacin. Sin embargo, estos elementos tambin podran ser aadidos manualmente en otras fases ms avanzadas del proceso de desarrollo. Si se pretende que la nueva clase extienda (herede de) otra clase existente, se debera especificar la clase "padre" dentro del campo "Superclass". El botn "Browse..." es de gran utilidad a la hora de encontrar clases que sean posibles candidatas para ser extendidas. Aunque Java slo soporta herencia nica (slo puede extenderse de una nica clase) s que es posible que una clase implemente ms de una interfaz. Una vez ms, el botn "Browse..." simplifica la tarea de seleccionar interfaces implementadas.

Si se desea que la nueva clase contenga un mtodo "main" (es decir, el

punto inicial de ejecucin del programa), puede aadirse dicho mtodo automticamente slo con marcar la casilla con la opcin apropiada. Tambin pueden implementarse de esta manera los constructores de la superclase y todos los mtodos abstractos heredados. Esta ltima opcin es muy til si se

9

desea instanciar la clase puesto que para esto todo mtodo abstracto debera estar implementado.

Figura 6

Es necesario destacar que los archivos compilados ".class" slo son

visibles en la ventana "Navigator", abierta por defecto dentro de la perspectiva "Resource". Puesto que la perspectiva de Java no abre esa ventana por defecto, los ficheros .class no sern visibles en la vista del Package Explorer. Sin embargo, basta con escribir y guardar un archivo ".java" para que se cree un archivo ".class" resultante de compilar el archivo fuente anterior. Fig. 6

A continuacin se enumeran los elementos relacionados:

File: Los archivos que se crean a travs de este men suelen almacenar notas e informacin general. Otros archivos tales como archivos de configuracin, archivos "build" de ant y similares tambin pueden crearse de esta manera. Crear un nuevo archivo es tan sencillo como pulsar "New > File", seleccionar el proyecto y carpeta adecuados en que se desea crear el archivo, dar nombre al nuevo archivo y pulsar el botn "Finish". Por defecto, archivos los archivos genricos se abren en el editor de texto.

HotKey: Alt+Shift+N+F+F

10

Flder: Las carpetas se utilizan para almacenar y organizar archivos. Como ya se ha mencionado anteriormente, una carpeta normal no es exactamente lo mismo que una carpeta fuente. Una prctica recomendada de programacin es crear explcitamente una carpeta fuente donde almacenar los archivos .java con el cdigo fuente (src), una carpeta de salida donde guardar el cdigo compilado (bin) y una carpeta para guardar toda la documentacin relacionada (docs). Para crear una nueva carpeta basta con especificar el nombre de la nueva carpeta y la carpeta que la contiene. HotKey: Alt+Shift+N+F

Interface: Las interfaces son casos particulares de las clases de Java, que carecen de implementacin y que se espera que otras clases implementen. Usualmente funcionan como una especie de contrato, indicando lo que la clase implementada debera hacer, mientras que los detalles de ms bajo nivel corresponderan al implementador. El procedimiento de creacin de interfaces es muy similar al procedimiento de creacin de nuevas clases ya detallado. Aunque una interfaz no puede implementar ninguna interfaz, s que puede extender otra interfaz mediante una relacin de herencia. HotKey: Alt+Shift+N+I

11

Package: Los paquetes se declaran para almacenar y organizar los archivos de Java. El nombre de un paquete consta usualmente de varias partes separadas por puntos. Cada una de estas partes ser un directorio nuevo dentro del sistema de archivos. Las clases que se creen dentro de un paquete determinado en Eclipse llevarn aadida automticamente la declaracin "package" en su cdigo fuente. HotKey: Alt+Shift+N+P

Scrapbook Page: Estas "hojas borrador" son una forma sencilla de probar fragmentos de cdigo antes de aadirlos al programa final. Slo dede crearse una "Scrapbook Page" dentro de la carpeta deseada y escribir el cdigo dentro de ella. No hace falta incluir el cdigo dentro de un mtodo main para ejecutarlo.

En Eclipse 3.2 las "scrapbook pages" no se muestran directamente en el men contextual. Para crear una nueva hoja borrador seleccione "New > Other > Java > Java Run/Debug > Scrapbook Page". Otra diferencia respecto de las versiones 2.x es que en Eclipse 3.2 s estn habilitadas las funciones de auto completar dentro de las scrapbook pages.

Antes de intentar ejecutar el cdigo aadido es necesario importar las clases usadas. Para ello basta con realizar click derecho sobre cualquier parte de la hoja y seleccionar "Set Imports" del men contextual. Ah es donde hay que especificar los tipos y paquetes que es necesario aadir.

Para ejecutar el cdigo recin creado es necesario seleccionarlo haciendo click con el botn izquierdo del mouse y arrastrando hasta tener todo el cdigo seleccionado. Luego hay que hacer click con el botn derecho del mouse sobre este cdigo seleccionado y ejecutar la opcin "Execute" del men contextual. La salida estndar de dicho proceso se mostrar dentro de la vista "Console", y otros mensajes de error se mostrarn dentro de la misma hoja borrador.

12

Una vez que se ha completado la prueba debe pulsarse el botn "Stop Evaluation" del men contextual.

Puesto que el editor de estas hojas de prueba no proporciona tantas funciones de ayuda a la programacin como el editor de cdigo Java, una prctica recomendada es escribir el cdigo original en el editor de Java y luego pegarlo en esta hoja de pruebas.

Source Folder: Como ya se ha visto, las carpetas fuente son un tipo especial de carpetas destinadas a almacenar los archivos fuentes de Java (es decir, los de extensin ".java"). Estos archivos de cdigo sern automticamente compilados en archivos ".class". Dado que todo proyecto de Java debera tener una carpeta fuente, es una prctica recomendada organizar esto desde el primer momento, como se explic en la primera parte de este tutorial.

13

Ejercitacin Mediante esta ejercitacin repasar los anteriores conceptos. Los pasos siguientes sern:

Creacin de un Proyecto.

Creacin de un Paquete.

Creacin de una Clase Saludo.

Creacin de una Clase de Prueba o Test.

Compilacin y Prueba de la Clase Saludo.

Creando el Proyecto

Para crear el Proyecto deber seguir los siguientes pasos:

Seleccione en la lnea de mens principal "File > New > Project...". o bien HotKey: Alt+Shift+N+P Recuerde indicar que el tipo de proyecto es Java.

Una vez hecho esto proceda a la asignacin del nombre, en este caso ser EclipseTutorial. Seleccione el campo "Create separate source and output folders" para construir de forma automtica la estructura de archivos.

Creando el Paquete

Para crear el paquete dentro del proyecto deber seguir los siguientes pasos:

Seleccione el proyecto anteriormente creado, all ser creado el nuevo paquete. HotKey: Alt+Shift+N+P

Una vez hecho esto proceda a la asignacin del nombre (tenga presente que debe comenzar con minsculas). en este caso ser modelo.

Creando una Clase y su Test de Ejecucin

Ahora debe crear una clase dentro del paquete, para ello deber seguir

los siguientes pasos:

Seleccione el paquete modelo creado anteriormente. Cree la nueva clase Saludo. Hotkey: Alt + Shift + N + C

14

La clase Saludo contendr el siguiente cdigo: package modelo;

public class Saludo {

private String mensaje = "Hola mundo !!!";

public void saludar(){

System.out.println(mensaje);

}

}

Seleccione el paquete modelo creado anteriormente. Cree la nueva clase TestSaludo. Hotkey: Alt + Shift + N + C

La clase TestSaludo contendr el siguiente cdigo: package modelo;

public class TestSaludo {

public static void main(String[] args) {

Saludo miSaludo = new Saludo():

miSaludo.saludar():

}

}

Ahora seleccione y ejecute la clase TestSaludo. Utilice la Hotkey: Alt + Shift + X , J

Se le preguntar si desea guardar los cambios realizados, a lo que responder haciendo click en Ok.

Deber obtener el siguiente resultado en la Consola:

Felicitaciones, ha logrado compilar y ejecutar su primera aplicacin Java!

15

Enlaces Relacionados

Eclipse http://www.eclipse.org

EclipseUML Free Edition http://www.omondo.com

JavaSE SDK http://java.sun.com/javase/downloads/index.jsp